elven-logs-interceptor-python 0.1.6__tar.gz → 0.1.7__tar.gz

{elven_logs_interceptor_python-0.1.6 → elven_logs_interceptor_python-0.1.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: elven-logs-interceptor-python
-Version: 0.1.6
+Version: 0.1.7
 Summary: Production-grade logs interceptor for Python with Loki transport, resilience, batching, and framework integrations.
 Author: Elven Observability
 License: MIT
@@ -111,8 +111,22 @@ logger.info("payload created: %s", payload_id, extra={"request_id": "req-1"})
 logger.exception("failed to create payload: %s", payload_id)
 ```
 
+When intercepting the standard Python `logging` module, `extra={...}` is
+captured under `context.extra`:
+
+```python
+logging.getLogger(__name__).info(
+    "payload created",
+    extra={"payload": payload},
+)
+```
+
 Supported aliases: `warning(...)`, `exception(...)` and `critical(...)`.
 
+Sensitive fields such as `cpf`, `password`, `token` and `authorization` are
+redacted by default. Set `LOGS_FILTER_SANITIZE=false` only when raw sensitive
+data is explicitly required and approved.
+
 ## Environment Variables
 
 The package supports all `LOGS_*` variables from the JS v3 design.

{elven_logs_interceptor_python-0.1.6 → elven_logs_interceptor_python-0.1.7}/README.md

@@ -50,8 +50,22 @@ logger.info("payload created: %s", payload_id, extra={"request_id": "req-1"})
 logger.exception("failed to create payload: %s", payload_id)
 ```
 
+When intercepting the standard Python `logging` module, `extra={...}` is
+captured under `context.extra`:
+
+```python
+logging.getLogger(__name__).info(
+    "payload created",
+    extra={"payload": payload},
+)
+```
+
 Supported aliases: `warning(...)`, `exception(...)` and `critical(...)`.
 
+Sensitive fields such as `cpf`, `password`, `token` and `authorization` are
+redacted by default. Set `LOGS_FILTER_SANITIZE=false` only when raw sensitive
+data is explicitly required and approved.
+
 ## Environment Variables
 
 The package supports all `LOGS_*` variables from the JS v3 design.

{elven_logs_interceptor_python-0.1.6 → elven_logs_interceptor_python-0.1.7}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "elven-logs-interceptor-python"
-version = "0.1.6"
+version = "0.1.7"
 description = "Production-grade logs interceptor for Python with Loki transport, resilience, batching, and framework integrations."
 readme = "README.md"
 requires-python = ">=3.10"

{elven_logs_interceptor_python-0.1.6 → elven_logs_interceptor_python-0.1.7}/src/logs_interceptor/infrastructure/interceptors/runtime_interceptor.py

@@ -12,6 +12,7 @@ from ...types import LogLevel
 from ...utils import safe_stringify
 from ..internal_capture_guard import is_internal_log_capture_suppressed
 from ..log_noise_filter import normalize_excluded_logger_prefixes, should_drop_log_record
+from ..log_record_extra import extract_log_record_extra
 
 
 class _BridgeLoggingHandler(logging.Handler):
@@ -42,6 +43,9 @@ class _BridgeLoggingHandler(logging.Handler):
             }
             if record.exc_info:
                 context["exc_info"] = "".join(traceback_module.format_exception(*record.exc_info))
+            extra = extract_log_record_extra(record)
+            if extra is not None:
+                context["extra"] = extra
             self._logger.log(level, msg, context)
         except Exception:
             return

elven_logs_interceptor_python-0.1.7/src/logs_interceptor/infrastructure/log_record_extra.py

@@ -0,0 +1,18 @@
+from __future__ import annotations
+
+import logging
+from typing import Any
+
+_STANDARD_LOG_RECORD_ATTRIBUTES = frozenset(logging.makeLogRecord({}).__dict__) | {
+    "asctime",
+    "message",
+}
+
+
+def extract_log_record_extra(record: logging.LogRecord) -> dict[str, Any] | None:
+    extras = {
+        key: value
+        for key, value in record.__dict__.items()
+        if key not in _STANDARD_LOG_RECORD_ATTRIBUTES and not key.startswith("_")
+    }
+    return extras or None

{elven_logs_interceptor_python-0.1.6 → elven_logs_interceptor_python-0.1.7}/src/logs_interceptor/integrations/logging_handler.py

@@ -10,6 +10,7 @@ from ..infrastructure.log_noise_filter import (
     normalize_excluded_logger_prefixes,
     should_drop_log_record,
 )
+from ..infrastructure.log_record_extra import extract_log_record_extra
 from ..types import LogLevel
 
 
@@ -40,6 +41,9 @@ class LoggingHandler(logging.Handler):
             }
             if record.exc_info:
                 context["exception"] = "".join(traceback_module.format_exception(*record.exc_info))
+            extra = extract_log_record_extra(record)
+            if extra is not None:
+                context["extra"] = extra
             self._logger.log(level, message, context)
         except Exception:
             return

{elven_logs_interceptor_python-0.1.6 → elven_logs_interceptor_python-0.1.7}/tests/unit/test_integration_filters.py

@@ -84,3 +84,36 @@ def test_logging_handler_ignores_configured_noisy_prefixes() -> None:
             },
         )
     ]
+
+
+def test_logging_handler_captures_python_logging_extra() -> None:
+    logger = _Logger()
+    handler = LoggingHandler(logger)
+    record = logging.getLogger("service.fenix").makeRecord(
+        name="service.fenix",
+        level=logging.INFO,
+        fn=__file__,
+        lno=158,
+        msg="Payload construído com sucesso",
+        args=(),
+        exc_info=None,
+        func="create_kit",
+        extra={"payload": {"cpf": "12345678901", "id": 42}},
+    )
+
+    handler.emit(record)
+
+    assert logger.calls == [
+        (
+            "info",
+            "Payload construído com sucesso",
+            {
+                "source": "python-logging",
+                "logger_name": "service.fenix",
+                "module": "test_integration_filters",
+                "function": "create_kit",
+                "line": 158,
+                "extra": {"payload": {"cpf": "12345678901", "id": 42}},
+            },
+        )
+    ]

{elven_logs_interceptor_python-0.1.6 → elven_logs_interceptor_python-0.1.7}/tests/unit/test_runtime_interceptor.py

@@ -65,3 +65,24 @@ def test_runtime_interceptor_ignores_records_during_internal_suppression() -> No
     assert logger.records == []
 
     interceptor.restore()
+
+
+def test_runtime_interceptor_captures_python_logging_extra() -> None:
+    logger = _Logger()
+    interceptor = RuntimeInterceptor(logger)
+    interceptor.enable()
+
+    try:
+        logging.getLogger("service.fenix").info(
+            "Payload construído com sucesso",
+            extra={"payload": {"cpf": "12345678901", "id": 42}},
+        )
+    finally:
+        interceptor.restore()
+
+    assert len(logger.records) == 1
+    level, message, context = logger.records[0]
+    assert level == "info"
+    assert message == "Payload construído com sucesso"
+    assert context is not None
+    assert context["extra"] == {"payload": {"cpf": "12345678901", "id": 42}}