"""日志 DTO。

定义日志级别的不可变值对象。仅依赖标准库，用于日志级别控制与过滤。
"""

from __future__ import annotations

from enum import StrEnum


class LogLevel(StrEnum):
    """日志级别。

    标识日志的级别，用于日志级别控制与过滤。继承 ``str, Enum`` 以支持
    JSON 序列化与字符串比较。

    取值：
        DEBUG: 调试级别。
        INFO: 信息级别。
        WARN: 警告级别。
        ERROR: 错误级别。
    """

    DEBUG = "debug"
    INFO = "info"
    WARN = "warn"
    ERROR = "error"