QGIS/python/plugins/processing/ProcessingPlugin.py
Nyall Dawson c33b4e67dc Fix exception when loading processing plugin on Qt 6 builds on KDE
Something internal in KDE itself adds child QObjects to menus, so the
code which tries to find the last action in the menu fails and returns
a QObject instead of a QAction, leading to an exception in the
insertAction call.

This is all too fragile anyway, so avoid it by:

- Just creating the models menu directly in the ui
- Exposing this via interface for use in the processing plugin

Now there's no risk of this code breaking in future if the Project
menu is re-arranged.
2024-12-06 19:20:05 +10:00

626 lines
22 KiB
Python

"""
***************************************************************************
ProcessingPlugin.py
---------------------
Date : August 2012
Copyright : (C) 2012 by Victor Olaya
Email : volayaf at gmail dot com
***************************************************************************
* *
* This program is free software; you can redistribute it and/or modify *
* it under the terms of the GNU General Public License as published by *
* the Free Software Foundation; either version 2 of the License, or *
* (at your option) any later version. *
* *
***************************************************************************
"""
__author__ = "Victor Olaya"
__date__ = "August 2012"
__copyright__ = "(C) 2012, Victor Olaya"
import shutil
import os
import sys
from typing import List
from functools import partial
from qgis.core import (
QgsApplication,
QgsProcessingUtils,
QgsProcessingModelAlgorithm,
QgsProcessingAlgorithm,
QgsDataItemProvider,
QgsDataProvider,
QgsDataItem,
QgsMapLayerType,
QgsMimeDataUtils,
QgsSettings,
)
from qgis.gui import (
QgsGui,
QgsOptionsWidgetFactory,
QgsCustomDropHandler,
QgsProcessingHistoryDialog,
)
from qgis.PyQt.QtCore import (
QObject,
Qt,
QItemSelectionModel,
QCoreApplication,
QDir,
QFileInfo,
pyqtSlot,
QMetaObject,
)
from qgis.PyQt.QtWidgets import QWidget, QMenu, QAction
from qgis.PyQt.QtGui import QIcon, QKeySequence
from qgis.utils import iface
from processing.core.Processing import Processing
from processing.gui.ProcessingToolbox import ProcessingToolbox
from processing.gui.ConfigDialog import ConfigOptionsPage
from processing.gui.ResultsDock import ResultsDock
from processing.gui.MessageDialog import MessageDialog
from processing.gui.MessageBarProgress import MessageBarProgress
from processing.gui.AlgorithmLocatorFilter import (
AlgorithmLocatorFilter,
InPlaceAlgorithmLocatorFilter,
)
from processing.gui.Postprocessing import handleAlgorithmResults
from processing.gui.AlgorithmExecutor import execute, execute_in_place
from processing.gui.AlgorithmDialog import AlgorithmDialog
from processing.gui.BatchAlgorithmDialog import BatchAlgorithmDialog
from processing.gui import TestTools
from processing.modeler.ModelerDialog import ModelerDialog
from processing.tools.system import tempHelpFolder
from processing.tools import dataobjects
from processing.gui.menus import (
removeMenus,
initializeMenus,
createMenus,
createButtons,
removeButtons,
)
from processing.core.ProcessingResults import resultsList
pluginPath = os.path.dirname(__file__)
class ProcessingOptionsFactory(QgsOptionsWidgetFactory):
def __init__(self):
super(QgsOptionsWidgetFactory, self).__init__()
def icon(self):
return QgsApplication.getThemeIcon("/processingAlgorithm.svg")
def createWidget(self, parent):
return ConfigOptionsPage(parent)
class ProcessingDropHandler(QgsCustomDropHandler):
def handleFileDrop(self, file):
if not file.lower().endswith(".model3"):
return False
return self.runAlg(file)
@staticmethod
def runAlg(file):
alg = QgsProcessingModelAlgorithm()
if not alg.fromFile(file):
return False
alg.setProvider(QgsApplication.processingRegistry().providerById("model"))
dlg = AlgorithmDialog(alg, parent=iface.mainWindow())
dlg.show()
# do NOT remove!!!! if you do then sip forgets the python subclass of AlgorithmDialog and you get a broken
# dialog
dlg.exec()
return True
def customUriProviderKey(self):
return "processing"
def handleCustomUriDrop(self, uri):
path = uri.uri
self.runAlg(path)
class ProcessingModelItem(QgsDataItem):
def __init__(self, parent, name, path):
super().__init__(QgsDataItem.Type.Custom, parent, name, path)
self.setState(QgsDataItem.State.Populated) # no children
self.setIconName(":/images/themes/default/processingModel.svg")
self.setToolTip(QDir.toNativeSeparators(path))
def hasDragEnabled(self):
return True
def handleDoubleClick(self):
self.runModel()
return True
def mimeUri(self):
u = QgsMimeDataUtils.Uri()
u.layerType = "custom"
u.providerKey = "processing"
u.name = self.name()
u.uri = self.path()
return u
def runModel(self):
ProcessingDropHandler.runAlg(self.path())
def editModel(self):
dlg = ModelerDialog.create()
dlg.loadModel(self.path())
dlg.show()
def actions(self, parent):
run_model_action = QAction(
QCoreApplication.translate("ProcessingPlugin", "&Run Model…"), parent
)
run_model_action.triggered.connect(self.runModel)
edit_model_action = QAction(
QCoreApplication.translate("ProcessingPlugin", "&Edit Model…"), parent
)
edit_model_action.triggered.connect(self.editModel)
return [run_model_action, edit_model_action]
class ProcessingDataItemProvider(QgsDataItemProvider):
def __init__(self):
super().__init__()
def name(self):
return "processing"
def capabilities(self):
return QgsDataProvider.DataCapability.File
def createDataItem(self, path, parentItem):
file_info = QFileInfo(path)
if file_info.suffix().lower() == "model3":
alg = QgsProcessingModelAlgorithm()
if alg.fromFile(path):
return ProcessingModelItem(parentItem, alg.name(), path)
return None
class ProcessingPlugin(QObject):
def __init__(self, iface):
super().__init__()
self.iface = iface
self.options_factory = None
self.drop_handler = None
self.item_provider = None
self.locator_filter = None
self.edit_features_locator_filter = None
self.initialized = False
self._gui_connections: list[QMetaObject.Connection] = []
self.initProcessing()
def initProcessing(self):
if not self.initialized:
self.initialized = True
Processing.initialize()
def finalizeStartup(self):
Processing.perform_deferred_model_initialization()
def initGui(self):
# port old log, ONCE ONLY!
settings = QgsSettings()
if not settings.value("/Processing/hasPortedOldLog", False, bool):
processing_history_provider = QgsGui.historyProviderRegistry().providerById(
"processing"
)
if processing_history_provider:
processing_history_provider.portOldLog()
settings.setValue("/Processing/hasPortedOldLog", True)
self.options_factory = ProcessingOptionsFactory()
self.options_factory.setTitle(self.tr("Processing"))
iface.registerOptionsWidgetFactory(self.options_factory)
self.drop_handler = ProcessingDropHandler()
iface.registerCustomDropHandler(self.drop_handler)
self.item_provider = ProcessingDataItemProvider()
QgsApplication.dataItemProviderRegistry().addProvider(self.item_provider)
self.locator_filter = AlgorithmLocatorFilter()
iface.registerLocatorFilter(self.locator_filter)
# Invalidate the locator filter for in-place when active layer changes
self._gui_connections.append(
iface.currentLayerChanged.connect(
lambda _: self.iface.invalidateLocatorResults()
)
)
self.edit_features_locator_filter = InPlaceAlgorithmLocatorFilter()
iface.registerLocatorFilter(self.edit_features_locator_filter)
QgsGui.historyProviderRegistry().providerById(
"processing"
).executePython.connect(self._execute_history_commands)
QgsGui.historyProviderRegistry().providerById("processing").createTest.connect(
self.create_test
)
self.toolbox = ProcessingToolbox()
self.iface.addDockWidget(Qt.DockWidgetArea.RightDockWidgetArea, self.toolbox)
self.toolbox.hide()
self.toolbox.visibilityChanged.connect(self.toolboxVisibilityChanged)
self.toolbox.executeWithGui.connect(self.executeAlgorithm)
self.resultsDock = ResultsDock()
self.iface.addDockWidget(
Qt.DockWidgetArea.RightDockWidgetArea, self.resultsDock
)
self.resultsDock.hide()
self.menu = QMenu(self.iface.mainWindow().menuBar())
self.menu.setObjectName("processing")
self.menu.setTitle(self.tr("Pro&cessing"))
self.toolboxAction = QAction(self.tr("&Toolbox"), self.iface.mainWindow())
self.toolboxAction.setCheckable(True)
self.toolboxAction.setObjectName("toolboxAction")
self.toolboxAction.setIcon(
QgsApplication.getThemeIcon("/processingAlgorithm.svg")
)
self.iface.registerMainWindowAction(
self.toolboxAction,
QKeySequence("Ctrl+Alt+T").toString(QKeySequence.SequenceFormat.NativeText),
)
self.toolboxAction.toggled.connect(self.openToolbox)
self.iface.attributesToolBar().insertAction(
self.iface.actionOpenStatisticalSummary(), self.toolboxAction
)
self.menu.addAction(self.toolboxAction)
self.modelerAction = QAction(
QgsApplication.getThemeIcon("/processingModel.svg"),
QCoreApplication.translate("ProcessingPlugin", "&Model Designer…"),
self.iface.mainWindow(),
)
self.modelerAction.setObjectName("modelerAction")
self.modelerAction.triggered.connect(self.openModeler)
self.iface.registerMainWindowAction(
self.modelerAction,
QKeySequence("Ctrl+Alt+G").toString(QKeySequence.SequenceFormat.NativeText),
)
self.menu.addAction(self.modelerAction)
self.historyAction = QAction(
QgsApplication.getThemeIcon("/mIconHistory.svg"),
QCoreApplication.translate("ProcessingPlugin", "&History…"),
self.iface.mainWindow(),
)
self.historyAction.setObjectName("historyAction")
self.historyAction.triggered.connect(self.openHistory)
self.iface.registerMainWindowAction(
self.historyAction,
QKeySequence("Ctrl+Alt+H").toString(QKeySequence.SequenceFormat.NativeText),
)
self.menu.addAction(self.historyAction)
self.toolbox.processingToolbar.addAction(self.historyAction)
self.resultsAction = QAction(
QgsApplication.getThemeIcon("/processingResult.svg"),
self.tr("&Results Viewer"),
self.iface.mainWindow(),
)
self.resultsAction.setObjectName("resultsViewer")
self.resultsAction.setCheckable(True)
self.iface.registerMainWindowAction(
self.resultsAction,
QKeySequence("Ctrl+Alt+R").toString(QKeySequence.SequenceFormat.NativeText),
)
self.menu.addAction(self.resultsAction)
self.toolbox.processingToolbar.addAction(self.resultsAction)
self.resultsDock.visibilityChanged.connect(self.resultsAction.setChecked)
self.resultsAction.toggled.connect(self.resultsDock.setUserVisible)
self.toolbox.processingToolbar.addSeparator()
self.editInPlaceAction = QAction(
QgsApplication.getThemeIcon("/mActionProcessSelected.svg"),
self.tr("Edit Features In-Place"),
self.iface.mainWindow(),
)
self.editInPlaceAction.setObjectName("editInPlaceFeatures")
self.editInPlaceAction.setCheckable(True)
self.editInPlaceAction.toggled.connect(self.editSelected)
self.menu.addAction(self.editInPlaceAction)
self.toolbox.processingToolbar.addAction(self.editInPlaceAction)
self.toolbox.processingToolbar.addSeparator()
self.optionsAction = QAction(
QgsApplication.getThemeIcon("/mActionOptions.svg"),
self.tr("Options"),
self.iface.mainWindow(),
)
self.optionsAction.setObjectName("optionsAction")
self.optionsAction.triggered.connect(self.openProcessingOptions)
self.toolbox.processingToolbar.addAction(self.optionsAction)
menuBar = self.iface.mainWindow().menuBar()
menuBar.insertMenu(self.iface.firstRightStandardMenu().menuAction(), self.menu)
self.menu.addSeparator()
initializeMenus()
createMenus()
createButtons()
# In-place editing button state sync
# we need to explicitly store and disconnect these connections
# on plugin unload -- they aren't cleaned up automatically (see
# https://github.com/qgis/QGIS/issues/53455)
self._gui_connections.append(
self.iface.currentLayerChanged.connect(self.sync_in_place_button_state)
)
self._gui_connections.append(
self.iface.mapCanvas().selectionChanged.connect(
self.sync_in_place_button_state
)
)
self._gui_connections.append(
self.iface.actionToggleEditing().triggered.connect(
partial(self.sync_in_place_button_state, None)
)
)
self.sync_in_place_button_state()
self.projectProvider = (
QgsApplication.instance().processingRegistry().providerById("project")
)
self._gui_connections.append(
self.projectProvider.algorithmsLoaded.connect(self.updateProjectModelMenu)
)
def updateProjectModelMenu(self):
"""Add projects models to menu"""
self.iface.projectModelsMenu().clear()
for model in self.projectProvider.algorithms():
model_sub_menu = self.iface.createProjectModelSubMenu(model.name())
action = QAction(self.tr("Execute…"))
action.setParent(model_sub_menu)
action.triggered.connect(
partial(
self.executeAlgorithm,
model.id(),
self.iface.projectModelsMenu(),
self.toolbox.in_place_mode,
)
)
model_sub_menu.addAction(action)
if model.flags() & QgsProcessingAlgorithm.Flag.FlagSupportsBatch:
action_batch = QAction(
self.tr("Execute as Batch Process…"), model_sub_menu
)
model_sub_menu.addAction(action_batch)
action_batch.triggered.connect(
partial(
self.executeAlgorithm,
model.id(),
self.iface.projectModelsMenu(),
self.toolbox.in_place_mode,
True,
)
)
@pyqtSlot(str, QWidget, bool, bool)
def executeAlgorithm(self, alg_id, parent, in_place=False, as_batch=False):
"""Executes a project model with GUI interaction if needed.
:param alg_id: algorithm id
:type alg_id: string
:param parent: parent widget
:type parent: QWidget
:param in_place: in place flag, defaults to False
:type in_place: bool, optional
:param as_batch: execute as batch flag, defaults to False
:type as_batch: bool, optional
"""
config = {}
if in_place:
config["IN_PLACE"] = True
alg = (
QgsApplication.instance()
.processingRegistry()
.createAlgorithmById(alg_id, config)
)
if alg is not None:
ok, message = alg.canExecute()
if not ok:
dlg = MessageDialog()
dlg.setTitle(self.tr("Error executing algorithm"))
dlg.setMessage(
self.tr(
"<h3>This algorithm cannot " "be run :-( </h3>\n{0}"
).format(message)
)
dlg.exec()
return
if as_batch:
dlg = BatchAlgorithmDialog(alg, iface.mainWindow())
dlg.show()
dlg.exec()
else:
in_place_input_parameter_name = "INPUT"
if hasattr(alg, "inputParameterName"):
in_place_input_parameter_name = alg.inputParameterName()
if in_place and not [
d
for d in alg.parameterDefinitions()
if d.name() not in (in_place_input_parameter_name, "OUTPUT")
]:
parameters = {}
feedback = MessageBarProgress(algname=alg.displayName())
ok, results = execute_in_place(alg, parameters, feedback=feedback)
if ok:
iface.messageBar().pushSuccess(
"",
self.tr(
"{algname} completed. %n feature(s) processed.",
n=results["__count"],
).format(algname=alg.displayName()),
)
feedback.close()
# MessageBarProgress handles errors
return
if alg.countVisibleParameters() > 0:
dlg = alg.createCustomParametersWidget(parent)
if not dlg:
dlg = AlgorithmDialog(alg, in_place, iface.mainWindow())
canvas = iface.mapCanvas()
prevMapTool = canvas.mapTool()
dlg.show()
dlg.exec()
if canvas.mapTool() != prevMapTool:
try:
canvas.mapTool().reset()
except Exception:
pass
try:
canvas.setMapTool(prevMapTool)
except RuntimeError:
pass
else:
feedback = MessageBarProgress(algname=alg.displayName())
context = dataobjects.createContext(feedback)
parameters = {}
ret, results = execute(alg, parameters, context, feedback)
handleAlgorithmResults(alg, context, feedback)
feedback.close()
def sync_in_place_button_state(self, layer=None):
"""Synchronise the button state with layer state"""
if layer is None:
layer = self.iface.activeLayer()
old_enabled_state = self.editInPlaceAction.isEnabled()
new_enabled_state = (
layer is not None and layer.type() == QgsMapLayerType.VectorLayer
)
self.editInPlaceAction.setEnabled(new_enabled_state)
if new_enabled_state != old_enabled_state:
self.toolbox.set_in_place_edit_mode(
new_enabled_state and self.editInPlaceAction.isChecked()
)
def openProcessingOptions(self):
self.iface.showOptionsDialog(
self.iface.mainWindow(), currentPage="processingOptions"
)
def unload(self):
for connection in self._gui_connections:
self.disconnect(connection)
self._gui_connections = []
self.toolbox.setVisible(False)
self.iface.removeDockWidget(self.toolbox)
self.iface.attributesToolBar().removeAction(self.toolboxAction)
self.resultsDock.setVisible(False)
self.iface.removeDockWidget(self.resultsDock)
self.toolbox.deleteLater()
self.menu.deleteLater()
# also delete temporary help files
folder = tempHelpFolder()
if QDir(folder).exists():
shutil.rmtree(folder, True)
self.iface.unregisterMainWindowAction(self.toolboxAction)
self.iface.unregisterMainWindowAction(self.modelerAction)
self.iface.unregisterMainWindowAction(self.historyAction)
self.iface.unregisterMainWindowAction(self.resultsAction)
self.iface.unregisterOptionsWidgetFactory(self.options_factory)
self.iface.deregisterLocatorFilter(self.locator_filter)
self.iface.deregisterLocatorFilter(self.edit_features_locator_filter)
self.iface.unregisterCustomDropHandler(self.drop_handler)
QgsApplication.dataItemProviderRegistry().removeProvider(self.item_provider)
removeButtons()
removeMenus()
QgsGui.historyProviderRegistry().providerById(
"processing"
).executePython.disconnect(self._execute_history_commands)
QgsGui.historyProviderRegistry().providerById(
"processing"
).createTest.disconnect(self.create_test)
Processing.deinitialize()
def openToolbox(self, show):
self.toolbox.setUserVisible(show)
def toolboxVisibilityChanged(self, visible):
self.toolboxAction.setChecked(visible)
def openModeler(self):
dlg = ModelerDialog.create()
dlg.update_model.connect(self.updateModel)
dlg.show()
def updateModel(self):
model_provider = QgsApplication.processingRegistry().providerById("model")
model_provider.refreshAlgorithms()
def openResults(self):
if self.resultsDock.isVisible():
self.resultsDock.hide()
else:
self.resultsDock.show()
def openHistory(self):
dlg = QgsProcessingHistoryDialog(self.iface.mainWindow())
dlg.setAttribute(Qt.WidgetAttribute.WA_DeleteOnClose)
dlg.show()
def tr(self, message, disambiguation=None, n=-1):
return QCoreApplication.translate(
"ProcessingPlugin", message, disambiguation=disambiguation, n=n
)
def editSelected(self, enabled):
self.toolbox.set_in_place_edit_mode(enabled)
def _execute_history_commands(self, commands: str):
"""
Executes Python commands from the history provider
"""
exec(commands)
def create_test(self, command: str):
"""
Starts the test creation process given a processing algorithm run command
"""
TestTools.createTest(command)