Python中通过点分表示法组织分层字符串常量的高效策略

from collections.abc import Iterable

class Endpoint:
    """
    表示一个分层端点，支持点分表示法访问和自动路径展开。
    """
    def __init__(self, name: str) -> None:
        """
        初始化一个Endpoint实例。

        Args:
            name: 当前端点的名称。
        """
        self._name = name
        self._children = {}  # 存储子端点
        self._parent = None  # 存储父端点

    def __dir__(self) -> Iterable[str]:
        """
        定制dir()函数的行为，使其包含子端点的名称，以支持自动补全。
        """
        cls_attrs = object.__dir__(self)
        return [n for n in self._children] + cls_attrs

    def __repr__(self) -> str:
        """
        提供Endpoint实例的开发者友好表示。
        """
        return f'<Endpoint({self._name!r})>'

    def __str__(self) -> str:
        """
        将Endpoint实例转换为其完整的路径字符串。
        通过递归地向上追溯父节点来构建路径。
        """
        if self._parent:
            # 如果有父节点，递归获取父节点的路径并添加斜杠
            up = f'{str(self._parent)}/'
        else:
            up = ''
        # 将当前节点的名称转换为小写并拼接
        return f'{up}{self._name.lower()}'

    def append_endpoint(self, endpoint_name: str):
        """
        向当前端点添加一个子端点。

        Args:
            endpoint_name: 要添加的子端点的名称。

        Raises:
            KeyError: 如果同名子端点已存在（不区分大小写）。
        """
        # 检查是否已存在同名子端点（不区分大小写）
        if any(c.lower()==endpoint_name.lower() for c in self._children):
            raise KeyError(f'A sub-endpoint {endpoint_name!r} already exists.')

        new_endpoint = self.__class__(endpoint_name)
        new_endpoint._parent = self  # 设置新子端的父节点为当前节点
        self._children[endpoint_name] = new_endpoint

    def __getattr__(self, _attr: str):
        """
        当通过点分表示法访问属性时，如果属性名对应一个子端点，则返回该子端点。
        """
        if _attr in self._children:
            return self._children[_attr]
        # 否则，按默认方式处理属性访问
        return object.__getattribute__(self, _attr)

    def __iadd__(self, endpoint_name: str):
        """
        实现`+=`运算符，提供一种便捷的方式来添加子端点。

        Args:
            endpoint_name: 要添加的子端点的名称。

        Returns:
            当前Endpoint实例，支持链式操作。
        """
        if not isinstance(endpoint_name, str):
            return NotImplemented
        self.append_endpoint(endpoint_name)
        return self

# 创建根端点
config = Endpoint('CONFIGURATION')

# 使用 += 运算符添加子端点
config += 'ACTIVE'          # config.ACTIVE 将可用，并支持自动补全
config.ACTIVE += 'LAST'     # config.ACTIVE.LAST 将可用

config += 'INACTIVE'
config.INACTIVE += 'HISTORY'
config.INACTIVE.HISTORY += 'Y2020'
config.INACTIVE.HISTORY += 'Y2021'
config.INACTIVE.HISTORY += 'Y2022'
config.INACTIVE.HISTORY += 'Y2023'

# 访问并转换为字符串
print(str(config))
# 输出: configuration

print(str(config.ACTIVE))
# 输出: configuration/active

print(str(config.ACTIVE.LAST))
# 输出: configuration/active/last

print(str(config.INACTIVE.HISTORY.Y2023))
# 输出: configuration/inactive/history/y2023