# -*- coding: utf-8 -*- """ *************************************************************************** HelpEditionDialog.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. * * * *************************************************************************** """ from builtins import str __author__ = 'Victor Olaya' __date__ = 'August 2012' __copyright__ = '(C) 2012, Victor Olaya' # This will get replaced with a git SHA1 when you do a git archive __revision__ = '$Format:%H$' import os import json from qgis.PyQt import uic from qgis.PyQt.QtWidgets import QDialog, QTreeWidgetItem from processing.core.ProcessingLog import ProcessingLog from processing.modeler.ModelerAlgorithm import ModelerAlgorithm pluginPath = os.path.split(os.path.dirname(__file__))[0] WIDGET, BASE = uic.loadUiType( os.path.join(pluginPath, 'ui', 'DlgHelpEdition.ui')) class HelpEditionDialog(BASE, WIDGET): ALG_DESC = 'ALG_DESC' ALG_CREATOR = 'ALG_CREATOR' ALG_HELP_CREATOR = 'ALG_HELP_CREATOR' ALG_VERSION = 'ALG_VERSION' def __init__(self, alg): super(HelpEditionDialog, self).__init__(None) self.setupUi(self) self.alg = alg self.descriptions = {} if isinstance(self.alg, ModelerAlgorithm): self.descriptions = self.alg.helpContent else: if self.alg.descriptionFile is not None: helpfile = alg.descriptionFile + '.help' if os.path.exists(helpfile): try: with open(helpfile) as f: self.descriptions = json.load(f) except Exception: ProcessingLog.addToLog(ProcessingLog.LOG_WARNING, self.tr('Cannot open help file: %s') % helpfile) self.currentName = self.ALG_DESC if self.ALG_DESC in self.descriptions: self.text.setText(self.descriptions[self.ALG_DESC]) self.tree.itemClicked.connect(self.changeItem) self.fillTree() self.updateHtmlView() def reject(self): self.descriptions = None QDialog.reject(self) def accept(self): self.descriptions[self.currentName] = str(self.text.toPlainText()) QDialog.accept(self) def getHtml(self): s = self.tr('
' + self.getDescription(self.ALG_DESC) + '
\n' s += self.tr('' + self.getDescription(param.name) + '
\n' s += self.tr('' + self.getDescription(out.name) + '
\n' return s def fillTree(self): item = TreeDescriptionItem(self.tr('Algorithm description'), self.ALG_DESC) self.tree.addTopLevelItem(item) parametersItem = TreeDescriptionItem(self.tr('Input parameters'), None) self.tree.addTopLevelItem(parametersItem) for param in self.alg.parameters: item = TreeDescriptionItem(param.description, param.name) parametersItem.addChild(item) outputsItem = TreeDescriptionItem(self.tr('Outputs'), None) self.tree.addTopLevelItem(outputsItem) for out in self.alg.outputs: item = TreeDescriptionItem(out.description, out.name) outputsItem.addChild(item) item = TreeDescriptionItem(self.tr('Algorithm created by'), self.ALG_CREATOR) self.tree.addTopLevelItem(item) item = TreeDescriptionItem(self.tr('Algorithm help written by'), self.ALG_HELP_CREATOR) self.tree.addTopLevelItem(item) item = TreeDescriptionItem(self.tr('Algorithm version'), self.ALG_VERSION) self.tree.addTopLevelItem(item) def changeItem(self): item = self.tree.currentItem() if isinstance(item, TreeDescriptionItem): if self.currentName: self.descriptions[self.currentName] = str(self.text.toPlainText()) name = item.name if name: self.text.setEnabled(True) self.updateHtmlView() self.currentName = name if name in self.descriptions: self.text.setText(self.descriptions[name]) else: self.text.clear() else: self.currentName = None self.text.clear() self.text.setEnabled(False) self.updateHtmlView() def updateHtmlView(self): self.txtPreview.setHtml(self.getHtml()) def getDescription(self, name): if name in self.descriptions: return self.descriptions[name].replace('\n', '