邁向輕鬆的 Python 設定檔版本 2-Python教學-PHP中文網

首頁

後端開發

Python教學

邁向輕鬆的 Python 設定檔版本 2

Linda Hamilton

Nov 30, 2024 am 02:39 AM

介紹

在上一篇文章中，我們成功建立了一個模擬屬性資料類別來管理應用程式的配置值。然而，它基本上只是一個模板，我們必須為每次使用重新實作。在我的工作的第二版中，我成功地實作了一個可重複使用的類別。

它需要屬性定義上的一對裝飾器。
另外，實作需要一個Sections 資料類型，其中包含每個配置節的一個Section 條目。
每個部分都需要一個 ConfigurationNameValue 條目清單

班級代表

下面的類別圖顯示了基本的可重用類別以及開發人員使用此功能所需的資料結構。

Towards Effortless Python Configuration Files Version 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 行中，開發人員呼叫受保護的方法來準備配置解析器。此外，該呼叫將

確保設定檔存在，如果不存在，則建立一個空檔案
建立缺失的部分
在部分建立缺失的鍵

先前的功能會產生大量可重複使用的程式碼和引導設定檔。此外，我們將該類別設為單例，以降低在我們的應用程式程式碼庫中實例化該類別時的創建成本。

定義部分

注意 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

登入後複製

我們將了解這些如何影響開發者類別中的屬性定義

屬性定義

字串屬性定義如下。

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()

登入後複製

我們擺脫的是存取 configParser 來取得和設定值的樣板。我們加入的是configurationGetter 和configurationSetter 裝飾器。我不會介紹裝飾器的實作細節，並將其作為讀者的練習。這些裝飾器負責與配置解析器互動以取得和設定值。設定值時，configurationSetter 裝飾器執行直寫.

開發者定義整數屬性如下。

from codeallybasic.ConfigurationProperties import Sections

CONFIGURATION_SECTIONS: Sections = Sections(
    {
        SectionName('General'):  SECTION_GENERAL,
        SectionName('Database'): SECTION_DATABASE,
    }
)

登入後複製

請注意，configurationGetter 裝飾器有一個可選參數。它是一個函數，它會取得字串屬性值並將其轉換為適當的類型值，然後傳回呼叫者屬性。這可以應用於浮動屬性。

我們想要保留枚舉名稱的枚舉屬性定義如下：

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'),
    ]
)

登入後複製

除了使用適當的裝飾器之外，請注意，要保留枚舉名稱，請使用 enumUseName 參數並將其設為 True.

以下是開發人員希望保留其值的枚舉屬性。請注意，setter 裝飾器表明它是一個枚舉。另外請注意，開發者必須提供反序列化方法，將值轉換為特定的枚舉值。

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

登入後複製

訪問和修改屬性

存取和修改屬性與版本 1 完全相同。

    @property
    @configurationGetter(sectionName='General')
    def debug(self) -> str:
        return ''       # never executed

    @debug.setter
    @configurationSetter(sectionName='General')
    def debug(self, newValue: str):
        pass

登入後複製

上面的程式碼片段產生以下輸出。

    @property
    @configurationGetter(sectionName='Database', deserializeFunction=int)
    def dbPort(self) -> int:
        return -1

    @dbPort.setter
    @configurationSetter(sectionName='Database',)
    def dbPort(self, newValue: int):
        pass

登入後複製