Fix docstrings

This commit is contained in:
Damiano 2021-04-27 14:15:56 +02:00
parent 68460231ce
commit 221d9f7f01

View File

@ -23,23 +23,20 @@ import qgis # required to get base class of enums
class PyQgsSettingsEntryEnumFlag(QgsSettingsEntryBase): class PyQgsSettingsEntryEnumFlag(QgsSettingsEntryBase):
""" class QgsSettingsEntryEnum """ class PyQgsSettingsEntryEnumFlag
ingroup core ingroup core
An enum settings entry. An enum settings entry.
since QGIS 3.20 since QGIS 3.20
""" """
def __init__(self, key, pluginName, defaultValue, description=str()): def __init__(self, key, pluginName, defaultValue, description=str()):
""" Constructor for PyQgsSettingsEntryEnumFlag. """ Constructor for PyQgsSettingsEntryEnumFlag.
:param self: the QgsSettingsEntryEnum object :param self: the PyQgsSettingsEntryEnumFlag object
:param key: argument specifies the final part of the settings key. :param key: argument specifies the final part of the settings key.
:param pluginName: argument is inserted in the key after the section. :param pluginName: argument is inserted in the key after the section.
:param defaultValue: argument specifies the default value for the settings entry. :param defaultValue: argument specifies the default value for the settings entry.
:param description: argument specifies a description for the settings entry. :param description: argument specifies a description for the settings entry.
.. note:: This constructor should not be used. Use PyQgsSettingsEntryEnum
or PyQgsSettingsEntryFlag instead.
""" """
defaultValueStr = str() defaultValueStr = str()
@ -58,10 +55,10 @@ class PyQgsSettingsEntryEnumFlag(QgsSettingsEntryBase):
def value(self, dynamicKeyPart=None, useDefaultValueOverride=False, defaultValueOverride=None): def value(self, dynamicKeyPart=None, useDefaultValueOverride=False, defaultValueOverride=None):
""" Get settings value. """ Get settings value.
:param self: the PyQgsSettingsEntryEnumFlag object :param self: the PyQgsSettingsEntryEnumFlag object
:param dynamicKeyPart: argument specifies the dynamic part of the settings key. :param dynamicKeyPart: argument specifies the dynamic part of the settings key.
:param useDefaultValueOverride: argument specifies if defaultValueOverride should be used. :param useDefaultValueOverride: argument specifies if defaultValueOverride should be used.
:param defaultValueOverride: argument if valid is used instead of the normal default value. :param defaultValueOverride: argument if valid is used instead of the normal default value.
""" """
defaultValue = self.defaultValue() defaultValue = self.defaultValue()
@ -80,7 +77,7 @@ class PyQgsSettingsEntryEnumFlag(QgsSettingsEntryBase):
def defaultValue(self): def defaultValue(self):
""" Get settings default value. """ Get settings default value.
:param self: the PyQgsSettingsEntryEnumFlag object :param self: the PyQgsSettingsEntryEnumFlag object
""" """
if self.__metaEnum is None or not self.__metaEnum.isValid(): if self.__metaEnum is None or not self.__metaEnum.isValid():
@ -103,8 +100,8 @@ class PyQgsSettingsEntryEnumFlag(QgsSettingsEntryBase):
def setValue(self, value, dynamicKeyPart=None): def setValue(self, value, dynamicKeyPart=None):
""" Set settings value. """ Set settings value.
:param self: the PyQgsSettingsEntryEnumFlag object :param self: the PyQgsSettingsEntryEnumFlag object
:param dynamicKeyPart: argument specifies the dynamic part of the settings key. :param dynamicKeyPart: argument specifies the dynamic part of the settings key.
""" """
if self.__metaEnum is None or not self.__metaEnum.isValid(): if self.__metaEnum is None or not self.__metaEnum.isValid():
@ -125,7 +122,7 @@ class PyQgsSettingsEntryEnumFlag(QgsSettingsEntryBase):
def settingsType(self): def settingsType(self):
""" Get the settings entry type. """ Get the settings entry type.
:param self: the QgsSettingsEntryEnumFlag object :param self: the PyQgsSettingsEntryEnumFlag object
""" """
return self.SettingsType.EnumFlag return self.SettingsType.EnumFlag