xmi-logger 0.0.4__tar.gz → 0.0.5__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: xmi_logger
3
- Version: 0.0.4
3
+ Version: 0.0.5
4
4
  Summary: An enhanced logger based on Loguru
5
5
  Home-page: https://github.com/wang-zhibo/xmi_logger
6
6
  Author: gm.zhibo.wang
@@ -13,7 +13,7 @@ with open("README.md", "r", encoding="utf-8") as fh:
13
13
 
14
14
  setup(
15
15
  name='xmi_logger',
16
- version='0.0.4',
16
+ version='0.0.5',
17
17
  author='gm.zhibo.wang',
18
18
  author_email='gm.zhibo.wang@gmail.com',
19
19
  description='An enhanced logger based on Loguru',
@@ -31,14 +31,14 @@ class XmiLogger:
31
31
  基于 Loguru 的增强日志记录器,具有以下功能:
32
32
  - 自定义日志格式
33
33
  - 日志轮转和保留策略
34
- - 上下文信息管理(如 request_id
35
- - 远程日志收集(使用线程池防止阻塞)
34
+ - 上下文信息管理(如 request_id)
35
+ - 远程日志收集(使用线程池防止阻塞)
36
36
  - 装饰器用于记录函数调用和执行时间,支持同步/异步函数
37
- - 自定义日志级别(避免与 Loguru 预定义的冲突)
37
+ - 自定义日志级别(避免与 Loguru 预定义的冲突)
38
38
  - 统一异常处理
39
39
 
40
40
  新增:
41
- - 可指定语言(中文/英文),默认中文
41
+ - 可指定语言(中文/英文),默认中文
42
42
  - 支持按时间轮转日志
43
43
  - 支持自定义日志格式
44
44
  - 支持日志级别过滤
@@ -86,35 +86,35 @@ class XmiLogger:
86
86
  _location_cache: Dict[str, str] = {}
87
87
  _stats_cache: Dict[str, Any] = {}
88
88
  _stats_cache_time = 0
89
- _stats_cache_ttl = 5 # 统计缓存TTL(秒)
89
+ _stats_cache_ttl = 5 # 统计缓存TTL(秒)
90
90
 
91
91
  def __init__(
92
92
  self,
93
93
  file_name: str,
94
94
  log_dir: str = 'logs',
95
- max_size: int = 14, # 单位:MB
95
+ max_size: int = 14, # 单位:MB
96
96
  retention: str = '7 days',
97
97
  remote_log_url: Optional[str] = None,
98
98
  max_workers: int = 3,
99
99
  work_type: bool = False,
100
- language: str = 'zh', # 语言选项,默认为中文
101
- rotation_time: Optional[str] = None, # 新增:按时间轮转,如 "1 day", "1 week"
102
- custom_format: Optional[str] = None, # 新增:自定义日志格式
103
- filter_level: str = "DEBUG", # 新增:日志过滤级别
104
- compression: str = "zip", # 新增:压缩格式,支持 zip, gz, tar
105
- enable_stats: bool = False, # 新增:是否启用日志统计
106
- categories: Optional[list] = None, # 新增:日志分类列表
107
- cache_size: int = 128, # 新增:缓存大小配置
108
- adaptive_level: bool = False, # 新增:自适应日志级别
109
- performance_mode: bool = False, # 新增:性能模式
100
+ language: str = 'zh', # 语言选项,默认为中文
101
+ rotation_time: Optional[str] = None, # 新增:按时间轮转,如 "1 day", "1 week"
102
+ custom_format: Optional[str] = None, # 新增:自定义日志格式
103
+ filter_level: str = "DEBUG", # 新增:日志过滤级别
104
+ compression: str = "zip", # 新增:压缩格式,支持 zip, gz, tar
105
+ enable_stats: bool = False, # 新增:是否启用日志统计
106
+ categories: Optional[list] = None, # 新增:日志分类列表
107
+ cache_size: int = 128, # 新增:缓存大小配置
108
+ adaptive_level: bool = False, # 新增:自适应日志级别
109
+ performance_mode: bool = False, # 新增:性能模式
110
110
  ) -> None:
111
111
  """
112
112
  初始化日志记录器。
113
113
 
114
114
  Args:
115
- file_name (str): 日志文件名称(主日志文件前缀)。
115
+ file_name (str): 日志文件名称(主日志文件前缀)。
116
116
  log_dir (str): 日志文件目录。
117
- max_size (int): 日志文件大小(MB)超过时进行轮转。
117
+ max_size (int): 日志文件大小(MB)超过时进行轮转。
118
118
  retention (str): 日志保留策略。
119
119
  remote_log_url (str, optional): 远程日志收集的URL。如果提供,将启用远程日志收集。
120
120
  max_workers (int): 线程池的最大工作线程数。
@@ -257,7 +257,7 @@ class XmiLogger:
257
257
  # 添加文件处理器
258
258
  self._add_file_handlers(log_format)
259
259
 
260
- # 配置远程日志(如果启用)
260
+ # 配置远程日志(如果启用)
261
261
  if self.remote_log_url:
262
262
  self._configure_remote_logging()
263
263
 
@@ -422,7 +422,7 @@ class XmiLogger:
422
422
 
423
423
  # 获取错误发生的具体位置
424
424
  if tb:
425
- # 获取最后一个调用帧(通常是错误发生的地方)
425
+ # 获取最后一个调用帧(通常是错误发生的地方)
426
426
  last_frame = tb[-1]
427
427
  error_location = f"{last_frame.filename}:{last_frame.lineno}:{last_frame.name}"
428
428
  line_content = last_frame.line.strip() if last_frame.line else "未知代码行"
@@ -612,9 +612,9 @@ class XmiLogger:
612
612
  增强版日志装饰器,支持自定义日志级别和跟踪配置
613
613
 
614
614
  Args:
615
- msg (str): 支持多语言的异常提示信息key(使用_LANG_MAP中的键)
616
- level (str): 记录异常的日志级别(默认ERROR
617
- trace (bool): 是否记录完整堆栈跟踪(默认True
615
+ msg (str): 支持多语言的异常提示信息key(使用_LANG_MAP中的键)
616
+ level (str): 记录异常的日志级别(默认ERROR)
617
+ trace (bool): 是否记录完整堆栈跟踪(默认True)
618
618
  """
619
619
  def decorator(func):
620
620
  _msg_key = msg or 'UNHANDLED_EXCEPTION'
@@ -673,7 +673,7 @@ class XmiLogger:
673
673
 
674
674
  # 获取错误发生的具体位置
675
675
  if tb:
676
- # 获取最后一个调用帧(通常是错误发生的地方)
676
+ # 获取最后一个调用帧(通常是错误发生的地方)
677
677
  last_frame = tb[-1]
678
678
  error_location = f"{last_frame.filename}:{last_frame.lineno}:{last_frame.name}"
679
679
  line_content = last_frame.line.strip() if last_frame.line else "未知代码行"
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: xmi_logger
3
- Version: 0.0.4
3
+ Version: 0.0.5
4
4
  Summary: An enhanced logger based on Loguru
5
5
  Home-page: https://github.com/wang-zhibo/xmi_logger
6
6
  Author: gm.zhibo.wang
File without changes
File without changes