mirror of
https://github.com/qgis/QGIS.git
synced 2025-03-10 00:13:55 -04:00
124 lines
4.2 KiB
Python
124 lines
4.2 KiB
Python
# -*- coding: utf-8 -*-
|
|
|
|
"""
|
|
***************************************************************************
|
|
general.py
|
|
---------------------
|
|
Date : April 2013
|
|
Copyright : (C) 2013 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 __future__ import print_function
|
|
from future import standard_library
|
|
standard_library.install_aliases()
|
|
from builtins import str
|
|
|
|
__author__ = 'Victor Olaya'
|
|
__date__ = 'April 2013'
|
|
__copyright__ = '(C) 2013, Victor Olaya'
|
|
|
|
# This will get replaced with a git SHA1 when you do a git archive
|
|
|
|
__revision__ = '$Format:%H$'
|
|
|
|
import os
|
|
try:
|
|
import configparser
|
|
except ImportError:
|
|
import configparser as configparser
|
|
|
|
from processing.core.Processing import Processing
|
|
from processing.core.alglist import algList
|
|
from processing.core.parameters import ParameterSelection
|
|
from processing.gui.Postprocessing import handleAlgorithmResults
|
|
|
|
|
|
def algorithmsList(text=None):
|
|
"""Returns list of all available Processing algorithms or list
|
|
of algorithms which names contains given text.
|
|
Returned list contains algorithm command-line names.
|
|
"""
|
|
lst = []
|
|
for provider in list(algList.algs.values()):
|
|
sortedlist = sorted(list(provider.values()), key=lambda alg: alg.name)
|
|
for alg in sortedlist:
|
|
if text is None or text.lower() in alg.name.lower():
|
|
lst.append(alg.commandLineName())
|
|
return lst
|
|
|
|
|
|
def printAlgorithms(text=None):
|
|
"""Print list of all available Processing algorithms or list
|
|
of algorithms which names contains given text.
|
|
Prints algorithms user-friendly names as well as command-line
|
|
names.
|
|
"""
|
|
s = ''
|
|
for provider in list(algList.algs.values()):
|
|
sortedlist = sorted(list(provider.values()), key=lambda alg: alg.name)
|
|
for alg in sortedlist:
|
|
if text is None or text.lower() in alg.name.lower():
|
|
s += '{}--->{}\n'.format(alg.name.ljust(50, '-'), alg.commandLineName())
|
|
print(s)
|
|
|
|
|
|
def algorithmOptions(name):
|
|
"""Prints all algorithm options with their values.
|
|
"""
|
|
alg = Processing.getAlgorithm(name)
|
|
if alg is not None:
|
|
opts = ''
|
|
for param in alg.parameters:
|
|
if isinstance(param, ParameterSelection):
|
|
opts += '{} ({})\n'.format(param.name, param.description)
|
|
for option in enumerate(param.options):
|
|
opts += '\t{} - {}\n'.format(option[0], option[1])
|
|
print(opts)
|
|
else:
|
|
print('Algorithm "{}" not found.'.format(name))
|
|
|
|
|
|
def algorithmHelp(name):
|
|
"""Prints algorithm parameters with their types. Also
|
|
provides information about options if any.
|
|
"""
|
|
alg = Processing.getAlgorithm(name)
|
|
if alg is not None:
|
|
alg = alg.getCopy()
|
|
print(str(alg))
|
|
algorithmOptions(name)
|
|
else:
|
|
print('Algorithm "{}" not found.'.format(name))
|
|
|
|
|
|
def run(algOrName, *args, **kwargs):
|
|
"""Executes given algorithm and returns its outputs as dictionary
|
|
object.
|
|
"""
|
|
alg = Processing.runAlgorithm(algOrName, None, *args, **kwargs)
|
|
if alg is not None:
|
|
return alg.getOutputValuesAsDictionary()
|
|
|
|
|
|
def runAndLoadResults(name, *args, **kwargs):
|
|
"""Executes given algorithm and load its results into QGIS project
|
|
when possible.
|
|
"""
|
|
return Processing.runAlgorithm(name, handleAlgorithmResults, *args, **kwargs)
|
|
|
|
|
|
def version():
|
|
pluginPath = os.path.split(os.path.dirname(__file__))[0]
|
|
cfg = configparser.ConfigParser()
|
|
cfg.read(os.path.join(pluginPath, 'metadata.txt'))
|
|
ver = cfg.get('general', 'version').split('.')
|
|
return 10000 * int(ver[0]) + 100 * int(ver[1]) + int(ver[2])
|