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

百变鹏仔 3天前 #Python

文章标签配置文件

介绍

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

班级代表

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

子类配置属性

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

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 sectionsconfiguration_sections: sections = sections(    {        sectionname('general'):  section_general,        sectionname('database'): section_database,    })

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

定义部分

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

from codeallybasic.configurationproperties import sectionfrom codeallybasic.configurationproperties import configurationnamevaluefrom codeallybasic.configurationproperties import propertynamesection_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 phoneyenumclass 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 FollowINFO:Tutorial:config.dbName='example_db'INFO:Tutorial:config.dbHost='localhost'INFO:Tutorial:config.dbPort=5432INFO:Tutorial:Mutate Enumeration PropertiesINFO:Tutorial:config.phoneyEnumByValue=<PhoneyEnumByValue.TheWanderer: 'The Wanderer'>INFO:Tutorial:config.impostorEnumByName='Low'

结论

本文的源代码在这里。请参阅支持类 singletonv3。查看configurationproperties的实现

实现的结果让我作为代码的使用者感到满意。我能够获取和设置类型属性。它并没有像我最初希望的那样删除那么多代码。然而，它确实为我提供了可重用的代码。然而，它确实提示我在 pycharm 中编写一个实时模板来帮助我生成单独的属性。

优点

缺点

我的下一篇文章我实现了所谓的动态属性。它完全删除了所有样板代码，并且仍然保留了上述优点。

文章推荐

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

介绍

班级代表

子类配置属性

定义部分

定义部分

属性定义

访问和修改属性

结论

优点

缺点

探秘Python在机器学习中的杰出应用案例

Python在智能交通系统中的应用案例分析

使用Python根据列表创建多个目录

将一个多项式转换为Python中的Hermite_e级数

如何在Tkinter GUI Python中添加PDF？