??

?? ????? ??????? ?? ?? ???? ?? ?????? ?? ??? ???? ??????. ??? ?? ????? ? ??? ?? ?? ???? ?? ???? ??????. ?? 2??? ??? ??? ???? ???? ? ??????.

• ?? ???? ? ?? ?????? ?????.
• ?? ???? ? ?? ??? ?? ?? ??? ???? ?? ??? ??? ?????.
• ? ???? 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??? ???? ??? ???? ???? ?? ??? ?????. ?? ?? ???

• ?? ??? ??? ????, ??? ? ??? ?????
• ??? ?? ??
• ??? ??? ?? ?????

?? ??? ???? ??? ??? ??? ????? ?? ??? ?? ?????. ?? ?????? ?? ?? ???? ???? ?????? ? ?? ??? ??? ?? ???? ????? ????.

?? ??

?? ??? ???? ??? ?????. ?? ??? ??? ????.

from codeallybasic.ConfigurationProperties import Sections

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

?? ?? ?? ???? ?? ??? ?????.

?? ??

??? ?? ConfigurationNameValue ??? ?????. ConfigurationNameValue? PropertyName? ?? ?????? 2?? ?? ?? ??? ??????. ??? ?? ?????.

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

??

? ?? ????? ??? ????. ?? ??? SingletonV3? ?????. ConfigurationProperties ?? ??

?? ??? ?? ????? ????????. ??? ??? ???? ??? ? ?????. ??? ???? ??? ?? ??? ????? ?????. ??? ??? ??? ??? ??????. ??? ?? ??? ???? ??? ??? ???? PyCharm?? ??? ???? ???? ????.

??

• ?????? ??? ?? ??? ??? ??? ???
• ??? ??? ?? ??? ??? ?? ???
• ??? ??? ?? ?? ???? ??? ?? ?? ??

??

• ??? ??? ???? ??
? ????.
• ?????? ???? ?? ????? ?????

?? ?????? ?? ????? ??? ?? ??????. ?? ??? ???? ??? ??? ?????? ?? ??? ??? ??? ??????.

? ??? ??? Python ?? ?? ?? 2? ???? ?? ?????. ??? ??? PHP ??? ????? ?? ?? ??? ?????!