File size: 2,867 Bytes
b0074f5
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
"""
日志模块 - 纯控制台输出(无状态函数风格)
- LOG_LEVEL 控制级别(debug/info/warning/error/critical,默认 info)
- ENABLE_LOG=0 彻底静默(不打印任何日志)
- log.debug/info/warning/error/critical(message) 记录日志
- set_log_level 动态调整级别,get_log_level 读取当前级别
"""

import os
import sys
from datetime import datetime
from types import SimpleNamespace

# 日志级别定义
LOG_LEVELS = {"debug": 0, "info": 1, "warning": 2, "error": 3, "critical": 4}

# 缓存配置(模块加载时读取一次)
_cached_log_level: int = LOG_LEVELS["info"]
_log_enabled: bool = True


def _refresh_config():
    """从环境变量刷新缓存配置"""
    global _cached_log_level, _log_enabled
    level = os.getenv("LOG_LEVEL", "info").lower()
    _cached_log_level = LOG_LEVELS.get(level, LOG_LEVELS["info"])
    _log_enabled = os.getenv("ENABLE_LOG", "1").strip().lower() not in ("0", "false", "no", "off")


_refresh_config()


def _log(level: str, message: str):
    # 最快短路:日志整体已禁用时直接返回,零开销
    if not _log_enabled:
        return

    level_val = LOG_LEVELS.get(level.lower())
    if level_val is None:
        return

    if level_val < _cached_log_level:
        return

    timestamp = datetime.now().strftime("%Y-%m-%d %H:%M:%S")
    entry = f"[{timestamp}] [{level.upper()}] {message}"

    if level in ("error", "critical"):
        print(entry, file=sys.stderr)
    else:
        print(entry)


def set_log_level(level: str):
    """动态设置日志级别"""
    global _cached_log_level
    level = level.lower()
    if level not in LOG_LEVELS:
        return False
    _cached_log_level = LOG_LEVELS[level]
    return True


def get_log_level() -> str:
    """获取当前日志级别名称"""
    current = _cached_log_level
    for name, value in LOG_LEVELS.items():
        if value == current:
            return name
    return "info"


# 日志接口:log.debug/info/warning/error/critical(message)
log = SimpleNamespace(
    debug=lambda message: _log("debug", message),
    info=lambda message: _log("info", message),
    warning=lambda message: _log("warning", message),
    error=lambda message: _log("error", message),
    critical=lambda message: _log("critical", message),
)


def is_enabled(level: str = "info") -> bool:
    """判断指定级别日志当前是否会输出。

    热路径上拼接代价高的 debug 日志(如逐 chunk 原始内容),
    应先调用 log.is_enabled("debug") 再构造字符串:
        if log.is_enabled("debug"):
            log.debug(f"expensive {data}")
    """
    if not _log_enabled:
        return False
    return LOG_LEVELS.get(level, LOG_LEVELS["info"]) >= _cached_log_level


# 导出的公共接口
__all__ = ["log", "set_log_level", "get_log_level", "LOG_LEVELS", "is_enabled"]