迈向轻松的 Python 配置文件版本 2

php中文网 2024-11-27 14:11:14

介绍

在上一篇文章中，我们成功创建了一个模拟属性数据类来管理应用程序的配置值。然而，它基本上只是一个模板，我们必须为每次使用重新实现。在我的工作的版本 2 中，我成功地实现了一个可重用的类。

它需要一对属性定义上的装饰器。
另外，该实现需要一个sections 数据类型，其中包含每个配置节的section 条目。
每个部分都需要一个 configurationnamevalue 条目列表

班级代表

下面的类图显示了基本的可重用类以及开发人员使用此功能所需的数据结构。

子类配置属性

开发人员通过如下方式子类化配置属性来开始该过程。

base_file_name: str = 'config.ini'
module_name:    str = 'version2properties'

class configurationpropertiesversion2(configurationproperties, metaclass=singletonv3):

    def __init__(self):
        self.logger: logger = getlogger(logger_name)

        super().__init__(basefilename=base_file_name, modulename=module_name, sections=configuration_sections)

        self._configparser.optionxform = self._tostr    # type: ignore

        self._loadconfiguration()

对 super 的调用会创建配置文件的完全限定路径。该代码遵循 xdg 基本目录规范的子集。该代码首先尝试 xdg_config_home，然后尝试 home，如果两者都失败，最后使用当前目录。在第 13 行，开发人员调用受保护的方法来准备配置解析器。此外，该调用将

确保配置文件存在，如果不存在，则创建一个空文件
创建缺失的部分
在部分中创建缺失的键

之前的功能会产生大量可重用的代码和引导配置文件。此外，我们将该类设为单例，以降低在我们的应用程序代码库中实例化该类时的创建成本。

立即学习“Python免费学习笔记（深入）”；

定义部分

注意 super 调用中的参数部分。部分的定义如下所示：

from codeallybasic.configurationproperties import sections

configuration_sections: sections = sections(
    {
        sectionname('general'):  section_general,
        sectionname('database'): section_database,
    }
)

上面是一个字典，其中键是节名称，值是节。

定义部分

section 只是 configurationnamevalue 条目的列表。 configurationnamevalue 是一个具有 2 个值的数据类，即 propertyname 及其默认值。这是我们的部分。

from codeallybasic.configurationproperties import section
from codeallybasic.configurationproperties import configurationnamevalue
from codeallybasic.configurationproperties import propertyname

section_general: section = section(
    [
        configurationnamevalue(name=propertyname('debug'),                           defaultvalue='false'),
        configurationnamevalue(name=propertyname('loglevel'),                     defaultvalue='info'),
        configurationnamevalue(name=propertyname('phoneyenumbyvalue'),  defaultvalue=default_phoney_enum_by_value.value),
        configurationnamevalue(name=propertyname('impostorenumbyname'), defaultvalue=default_impostor_enum_by_name.name),
    ]
)

section_database: section = section(
    [
        configurationnamevalue(name=propertyname('dbname'), defaultvalue='example_db'),
        configurationnamevalue(name=propertyname('dbhost'), defaultvalue='localhost'),
        configurationnamevalue(name=propertyname('dbport'), defaultvalue='5432'),
    ]
)

请注意，我指定了两个新的枚举属性。我们希望坚持的一个是价值，另一个是名字。

这里有枚举定义。

class phoneyenumbyvalue(enum):
    thewanderer = 'the wanderer'
    mentiroso   = 'mentiroso'
    fakebrenda  = 'faker extraordinaire'
    notset          = 'not set'

    @classmethod
    def deserialize(cls, value: str) -> 'phoneyenumbyvalue':

    @classmethod
    def deserialize(cls, value: str) -> 'phoneyenumbyvalue':

        match value:
            case phoneyenumbyvalue.thewanderer.value:
                phoneyenum: phoneyenumbyvalue = phoneyenumbyvalue.thewanderer
            case phoneyenumbyvalue.mentiroso.value:
                phoneyenum = phoneyenumbyvalue.mentiroso
            case phoneyenumbyvalue.fakebrenda.value:
                phoneyenum = phoneyenumbyvalue.fakebrenda
            case _:
                raise exception('unknown phoneyenumbyvalue')

        return phoneyenum


class impostorenumbyname(enum):
    low       = 0.1
    medium = 0.5
    high     = 1.0
    notset = -1.0

我们将了解这些如何影响开发者类中的属性定义

属性定义

字符串属性定义如下。

    @property
    @configurationgetter(sectionname='general')
    def debug(self) -> str:
        return ''       # never executed

    @debug.setter
    @configurationsetter(sectionname='general')
    def debug(self, newvalue: str):
        pass

我们已经摆脱了访问 configparser 来获取和设置值的样板。我们添加的是configurationgetter 和configurationsetter 装饰器。我不会介绍装饰器的实现细节，并将其作为读者的练习。这些装饰器负责与配置解析器交互以获取和设置值。在设置值时，configurationsetter 装饰器执行直写.

开发者定义整数属性如下。

    @property
    @configurationgetter(sectionname='database', deserializefunction=int)
    def dbport(self) -> int:
        return -1

    @dbport.setter
    @configurationsetter(sectionname='database',)
    def dbport(self, newvalue: int):
        pass

请注意，configurationgetter 装饰器有一个可选参数。它是一个函数，它获取字符串属性值并将其转换为适当的类型值，然后返回调用者属性。这可以应用于浮动属性。

我们想要保留枚举名称的枚举属性定义如下：

    @property
    @configurationgetter(sectionname='general')
    def impostorenumbyname(self) -> impostorenumbyname:
        return impostorenumbyname.notset      # never executed

    @impostorenumbyname.setter
    @configurationsetter(sectionname='general', enumusename=true)
    def impostorenumbyname(self, newvalue: impostorenumbyname):
        pass

除了使用适当的装饰器之外，请注意，要保留枚举名称，请使用 enumusename 参数并将其设置为 true.

以下是开发人员希望保留其值的枚举属性。请注意，setter 装饰器表明它是一个枚举。另外需要注意的是，开发者必须提供反序列化方法，将值转换为具体的枚举值。

    @property
    @configurationgetter(sectionname='general', deserializefunction=phoneyenumbyvalue.deserialize)
    def phoneyenumbyvalue(self) -> phoneyenumbyvalue:
        return phoneyenumbyvalue.notset      # never executed

    @phoneyenumbyvalue.setter
    @configurationsetter(sectionname='general', isenum=true)
    def phoneyenumbyvalue(self, newvalue: phoneyenumbyvalue):
        pass

访问和修改属性

访问和修改属性与版本 1 完全相同。

    basicconfig(level=info)

    config: configurationpropertiesversion2 = configurationpropertiesversion2()

    logger: logger = getlogger(logger_name)

    logger.info(f'{config.debug=}')
    logger.info(f'{config.loglevel=}')
    logger.info(f'{config.phoneyenumbyvalue=}')
    logger.info(f'{config.impostorenumbyname=}')
    logger.info('database properties follow')
    logger.info(f'{config.dbname=}')
    logger.info(f'{config.dbhost=}')
    logger.info(f'{config.dbport=}')
    logger.info('mutate enumeration properties')
    config.phoneyenumbyvalue = phoneyenumbyvalue.thewanderer
    logger.info(f'{config.phoneyenumbyvalue=}')
    config.impostorenumbyname = impostorenumbyname.low
    logger.info(f'{config.impostorenumbyname=}')

上面的代码片段产生以下输出。

INFO:Tutorial:config.debug='False'
INFO:Tutorial:config.logLevel='Info'
INFO:Tutorial:config.phoneyEnumByValue=<PhoneyEnumByValue.FakeBrenda: 'Faker Extraordinaire'>
INFO:Tutorial:config.impostorEnumByName='High'
INFO:Tutorial:Database Properties Follow
INFO:Tutorial:config.dbName='example_db'
INFO:Tutorial:config.dbHost='localhost'
INFO:Tutorial:config.dbPort=5432
INFO:Tutorial:Mutate Enumeration Properties
INFO:Tutorial:config.phoneyEnumByValue=<PhoneyEnumByValue.TheWanderer: 'The Wanderer'>
INFO:Tutorial:config.impostorEnumByName='Low'