sycommon-python-lib 0.2.7a3__py3-none-any.whl → 0.2.7a4__py3-none-any.whl

sycommon/logging/kafka_log.py

@@ -443,21 +443,25 @@ class SYLogger:
         统一日志记录入口
         修复：手动提取堆栈信息并写入 message，确保 Kafka 能收到
 
-        单条开关（enabled）：
-            - None（默认）：跟随全局 log.enabled。全局关 -> 静默（ERROR 除外，ERROR 始终放行）
+        单条开关（enabled，由公开方法从 **kwargs 按名取出，隐式参数）：
+            - None / 非布尔（默认）：跟随全局 log.enabled。全局关 -> 静默（ERROR 除外）
             - True：强制发出（即便全局 log.enabled=false，这一条也进 kafka）
-            - False：强制静默（即便全局开，这一条也丢）
+            - False：强制静默（即便全局开/ERROR，这一条也丢）
+
+        之所以用隐式 kwargs 而非显式形参：老项目里已有 SYLogger.info(msg, exec=xxx) 等
+        任意写法，显式形参会与历史调用冲突；从 kwargs 按名取则完全兼容，无需逐项目排查。
 
         注意：ERROR 级别无论全局开关如何都会进 kafka（KafkaSink.write 对 ERROR 放行），
-        此处的 enabled=None + 全局关 对 ERROR 不静默——仅在 enabled=False 时才压制。
+        此处的 enabled=None + 全局关 对 ERROR 不静默——仅在 enabled is False 时才压制。
         """
-        # 单条开关裁决
+        # 单条开关裁决：严格布尔判定，非布尔值（None/exec 等）一律跟随全局
         if enabled is False:
             return  # 强制静默
 
         global_on = _global_log_enabled()
         # 跟随全局且全局关：非 ERROR 静默（ERROR 始终放行，交由 KafkaSink 处理）
-        if enabled is None and not global_on and level != "ERROR":
+        if (enabled is None or not isinstance(enabled, bool)) \
+                and not global_on and level != "ERROR":
             return
 
         # 序列化消息：dict/list 先脱敏（按字段名/子串/长度/总量裁剪），再转 JSON
@@ -511,22 +515,26 @@ class SYLogger:
         if check_env_flag(['DEV_LOG']):
             print(log_dict)
 
+    # enabled 采用「隐式参数」：不显式写入签名（保持 *args/**kwargs 与历史调用 100%
+    # 兼容），而是从 **kwargs 中按名取出。这样老项目里已有的 SYLogger.info(msg, exec=xxx)
+    # 等任意写法都不受影响，无需逐项目排查；新功能通过 SYLogger.info(msg, enabled=True)
+    # 触发。_log 内部用 `is True` / `is False` 严格判定，非布尔值回退为「跟随全局」。
     @staticmethod
-    def info(msg: any, *args, enabled: bool = None, **kwargs):
-        SYLogger._log(msg, "INFO", enabled)
+    def info(msg: any, *args, **kwargs):
+        SYLogger._log(msg, "INFO", kwargs.get("enabled"))
 
     @staticmethod
-    def warning(msg: any, *args, enabled: bool = None, **kwargs):
-        SYLogger._log(msg, "WARNING", enabled)
+    def warning(msg: any, *args, **kwargs):
+        SYLogger._log(msg, "WARNING", kwargs.get("enabled"))
 
     @staticmethod
-    def debug(msg: any, *args, enabled: bool = None, **kwargs):
-        SYLogger._log(msg, "DEBUG", enabled)
+    def debug(msg: any, *args, **kwargs):
+        SYLogger._log(msg, "DEBUG", kwargs.get("enabled"))
 
     @staticmethod
-    def error(msg: any, *args, enabled: bool = None, **kwargs):
-        SYLogger._log(msg, "ERROR", enabled)
+    def error(msg: any, *args, **kwargs):
+        SYLogger._log(msg, "ERROR", kwargs.get("enabled"))
 
     @staticmethod
-    def exception(msg: any, *args, enabled: bool = None, **kwargs):
-        SYLogger._log(msg, "ERROR", enabled)
+    def exception(msg: any, *args, **kwargs):
+        SYLogger._log(msg, "ERROR", kwargs.get("enabled"))

{sycommon_python_lib-0.2.7a3.dist-info → sycommon_python_lib-0.2.7a4.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sycommon-python-lib
-Version: 0.2.7a3
+Version: 0.2.7a4
 Summary: Add your description here
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown

{sycommon_python_lib-0.2.7a3.dist-info → sycommon_python_lib-0.2.7a4.dist-info}/RECORD

@@ -211,7 +211,7 @@ sycommon/llm/tiktoken_cache/9b5ad71b2ce5302211f9c61530b329a4922fc6a4,sha256=Ijkh
 sycommon/llm/tiktoken_cache/fb374d419588a4632f3f557e76b4b70aebbca790,sha256=RGqVOMtsNI41FhINfAiwn1fDZJXirP_-WaW_iwz7Gi0,3613922
 sycommon/logging/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 sycommon/logging/async_sql_logger.py,sha256=TIUAqK8_F9H7Graw00hNjEI3DJ1ZRo5fRUcnqaMZlbU,2187
-sycommon/logging/kafka_log.py,sha256=R2n58T4FaaIbFgl1_cknGa3N25YJWtK0NrcTReCGSSA,19836
+sycommon/logging/kafka_log.py,sha256=H_nnSQtCXalxUyKzpjpa_6iTp1brGRRhyQhXH5qEjd0,20656
 sycommon/logging/log_masker.py,sha256=o4yE1rZ8f8a3xwTLV7TZvAt9nPB2IjacKCxoJspbhBM,12797
 sycommon/logging/logger_levels.py,sha256=xJBzPV2H7GpEQggOIjyckEsA4yf6s4NpI9ckgO3xWKA,1154
 sycommon/logging/logger_wrapper.py,sha256=TtzmGw_K5NjBGBq9Gjqtnh834izAv8TQwsOeL2fIbAI,481
@@ -301,8 +301,8 @@ sycommon/tools/syemail.py,sha256=BDFhgf7WDOQeTcjxJEQdu0dQhnHFPO_p3eI0-Ni3LhQ,561
 sycommon/tools/timing.py,sha256=OiiE7P07lRoMzX9kzb8sZU9cDb0zNnqIlY5pWqHcnkY,2064
 sycommon/xxljob/__init__.py,sha256=7eoBlQxv-B39IfRSCY2bkqdGYs1QRe1umAWd88VMEEM,86
 sycommon/xxljob/xxljob_service.py,sha256=1yifwIBNGsCIxLnQjHKiBlbsigc_zvPH-dMTZcNxe-Q,7649
-sycommon_python_lib-0.2.7a3.dist-info/METADATA,sha256=C7X28BU9_mSW37Apz_U3OiIIEvmdCquOP9sxQzPvs2E,7960
-sycommon_python_lib-0.2.7a3.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
-sycommon_python_lib-0.2.7a3.dist-info/entry_points.txt,sha256=gsR4SssKxDWjRU8ggidzNcdMXDPRSKRS7UaGyNP84Qg,92
-sycommon_python_lib-0.2.7a3.dist-info/top_level.txt,sha256=RgphKrg7nJyZ7irJqbxFr-5H2LUYTvI7ivoWZH2hcD0,29
-sycommon_python_lib-0.2.7a3.dist-info/RECORD,,
+sycommon_python_lib-0.2.7a4.dist-info/METADATA,sha256=uZ0e_w_up1416YQu001gfJPQu6CJMVseAeBRddj8Yck,7960
+sycommon_python_lib-0.2.7a4.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+sycommon_python_lib-0.2.7a4.dist-info/entry_points.txt,sha256=gsR4SssKxDWjRU8ggidzNcdMXDPRSKRS7UaGyNP84Qg,92
+sycommon_python_lib-0.2.7a4.dist-info/top_level.txt,sha256=RgphKrg7nJyZ7irJqbxFr-5H2LUYTvI7ivoWZH2hcD0,29
+sycommon_python_lib-0.2.7a4.dist-info/RECORD,,