debugbundle-python 2.1.0__tar.gz → 2.1.1__tar.gz

{debugbundle_python-2.1.0 → debugbundle_python-2.1.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: debugbundle-python
-Version: 2.1.0
+Version: 2.1.1
 Summary: DebugBundle SDK for Python
 Author: DebugBundle
 License-Expression: Apache-2.0
@@ -41,6 +41,8 @@ Dynamic: license-file
 
 # debugbundle-python
 
+Patch 2.1.1 corrects native logger exception evidence and capture safety while preserving public APIs and event schemas. Upgrade the DebugBundle distribution to adopt the correction.
+
 Python SDK for DebugBundle.
 
 After `make install-docker`, `make evidence-performance` compares identical
@@ -59,16 +61,15 @@ Use this package to capture Python backend exceptions, request metadata, structu
 
 Requires Python 3.10 or newer.
 
-## Evidence candidate (unreleased)
+## Evidence in 2.1.0
 
-The source candidate adds `capture_exception_evidence=True` and
+Version 2.1.0 adds `capture_exception_evidence=True` and
 `capture_recovery_observations=False` installation options. Collection requires
 verified delivery/reader support, discovered on existing config/ACK traffic with
 `debugbundle_evidence=1`. No capture call performs discovery or adds polling.
 `evidence_capabilities` is an optional descriptor pin asserting the **entire**
 path, including local readers, relays and wrappers; later discovery can revoke it.
-Without proof, exception events retain their legacy shape. These additions are
-not available in the installed 2.0.1 release.
+Without proof, exception events retain their legacy shape. These additions require upgrading from 2.0.1 to 2.1.0.
 
 Native cause, implicit context and Python 3.11+ exception-group evidence excludes
 locals, source excerpts, arbitrary renderers and application properties. Python
@@ -89,7 +90,7 @@ Application results and exceptions pass through the context manager unchanged.
 The existing background sender remains best-effort at immediate process exit.
 The uncaught hook collects bounded native evidence without waiting for transport;
 applications needing a delivery attempt use explicit `flush()` in a controlled
-shutdown window. This candidate does not add default crash-file persistence or
+shutdown window. This release does not add default crash-file persistence or
 synchronous capture transport.
 
 Pass a fresh UUID v4 `failure_ref` in exception/log/request context. A valid

{debugbundle_python-2.1.0 → debugbundle_python-2.1.1}/README.md

@@ -1,5 +1,7 @@
 # debugbundle-python
 
+Patch 2.1.1 corrects native logger exception evidence and capture safety while preserving public APIs and event schemas. Upgrade the DebugBundle distribution to adopt the correction.
+
 Python SDK for DebugBundle.
 
 After `make install-docker`, `make evidence-performance` compares identical
@@ -18,16 +20,15 @@ Use this package to capture Python backend exceptions, request metadata, structu
 
 Requires Python 3.10 or newer.
 
-## Evidence candidate (unreleased)
+## Evidence in 2.1.0
 
-The source candidate adds `capture_exception_evidence=True` and
+Version 2.1.0 adds `capture_exception_evidence=True` and
 `capture_recovery_observations=False` installation options. Collection requires
 verified delivery/reader support, discovered on existing config/ACK traffic with
 `debugbundle_evidence=1`. No capture call performs discovery or adds polling.
 `evidence_capabilities` is an optional descriptor pin asserting the **entire**
 path, including local readers, relays and wrappers; later discovery can revoke it.
-Without proof, exception events retain their legacy shape. These additions are
-not available in the installed 2.0.1 release.
+Without proof, exception events retain their legacy shape. These additions require upgrading from 2.0.1 to 2.1.0.
 
 Native cause, implicit context and Python 3.11+ exception-group evidence excludes
 locals, source excerpts, arbitrary renderers and application properties. Python
@@ -48,7 +49,7 @@ Application results and exceptions pass through the context manager unchanged.
 The existing background sender remains best-effort at immediate process exit.
 The uncaught hook collects bounded native evidence without waiting for transport;
 applications needing a delivery attempt use explicit `flush()` in a controlled
-shutdown window. This candidate does not add default crash-file persistence or
+shutdown window. This release does not add default crash-file persistence or
 synchronous capture transport.
 
 Pass a fresh UUID v4 `failure_ref` in exception/log/request context. A valid

{debugbundle_python-2.1.0 → debugbundle_python-2.1.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "debugbundle-python"
-version = "2.1.0"
+version = "2.1.1"
 description = "DebugBundle SDK for Python"
 readme = "README.md"
 requires-python = ">=3.10"

{debugbundle_python-2.1.0 → debugbundle_python-2.1.1}/src/debugbundle/capture_hooks.py

@@ -30,14 +30,19 @@ class DebugBundleLogHandler(logging.Handler):
     def emit(self, record: logging.LogRecord) -> None:
         if not self._sdk._log_level_eligible(record.levelname.lower()):
             return
+        context = {"logger_name": record.name, "pathname": record.pathname, "lineno": record.lineno}
+        if (
+            record.levelno >= logging.ERROR
+            and type(record.exc_info) is tuple
+            and len(record.exc_info) == 3
+            and isinstance(record.exc_info[1], BaseException)
+        ):
+            self._sdk.capture_exception(record.exc_info[1], {**context, "log_message": safe_log_message(record)})
+            return
         self._sdk.capture_log(
             safe_log_message(record),
             level=record.levelname.lower(),
-            context={
-                "logger_name": record.name,
-                "pathname": record.pathname,
-                "lineno": record.lineno,
-            },
+            context=context,
         )
 
 
@@ -55,7 +60,10 @@ def safe_log_message(record: logging.LogRecord) -> str:
     if type(args) is not tuple or len(args) > 8:
         return template + " [log arguments withheld]"
     safe_args = [
-        value[:1024] if type(value) is str else str(value) if type(value) in (int, float, bool)
+        value[:1024]
+        if type(value) is str
+        else str(value)
+        if type(value) in (int, float, bool)
         else "[unsupported argument]"
         for value in args
     ]

{debugbundle_python-2.1.0 → debugbundle_python-2.1.1}/src/debugbundle/exception_capture.py

@@ -14,6 +14,7 @@ from .event_support import (
     runtime_process_facts,
 )
 from .exception_evidence import snapshot_exception
+from .exception_identity import admit as admit_identity
 from .exception_snapshot import exception_details
 from .process_support import ensure_current_process
 from .queue_admission import may_prepare_event
@@ -35,6 +36,9 @@ def capture_exception(
     if not sdk._enabled or not may_prepare_event(sdk, True, max_pending_events, max_pending_bytes):
         return
     try:
+        automatic = fatal or type(context) is dict and "logger_name" in context
+        if not admit_identity(sdk, error, automatic):
+            return
         name, message, stack = exception_details(error)
         redacted_context = redact_mapping(dict(context or {}), sdk._redact_fields)
         request_payload = backend_exception_request_payload(redacted_context.get("request"))
@@ -84,8 +88,10 @@ def capture_exception(
             return
         try:
             if sdk._enabled and sdk._suppression.should_capture(suppression_key, sdk._time_provider()):
-                if sdk._offer_protected_event(event, event_bytes) and fatal:
-                    sdk._hook_bypass.add(id(event))
+                if sdk._offer_protected_event(event, event_bytes):
+                    admit_identity(sdk, error, automatic, accepted=True)
+                    if fatal:
+                        sdk._hook_bypass.add(id(event))
         finally:
             sdk._lock.release()
     except BaseException:

debugbundle_python-2.1.1/src/debugbundle/exception_identity.py

@@ -0,0 +1,47 @@
+"""Opaque receipts on native exceptions; no raw exception retention or equality hooks."""
+
+from __future__ import annotations
+
+import time
+from typing import Any
+
+_SLOT = "_debugbundle_capture_receipt"
+_DICT = BaseException.__dict__["__dict__"]
+
+
+def admit(sdk: Any, error: BaseException, automatic: bool, *, accepted: bool = False) -> bool:
+    try:
+        # BaseException is not universally weak-referenceable. Store only an opaque
+        # owner, operation ID and time on its native dictionary, bypassing overrides.
+        if sdk._before_send is not None:
+            return True
+        fields = _DICT.__get__(error)
+        owner = getattr(sdk, "_exception_identity_owner", None)
+        if owner is None:
+            owner = sdk._exception_identity_owner = object()
+        operation = sdk._operations.current()
+        scope = operation.scope["operation_id"] if operation is not None else None
+        if scope is None:
+            return True
+        now = time.monotonic()
+        previous = fields.get(_SLOT)
+        if type(previous) is tuple and len(previous) == 4:
+            token, prior_scope, at, prior_automatic = previous
+            if (
+                not accepted
+                and token is owner
+                and type(prior_scope) is str
+                and scope == prior_scope
+                and type(at) is float
+                and type(prior_automatic) is bool
+                and now - at < 30
+                and automatic != prior_automatic
+            ):
+                fields.pop(_SLOT, None)
+                return False
+        if accepted:
+            fields[_SLOT] = (owner, scope, now, automatic)
+    except BaseException:
+        # Unavailable identity must preserve the failure, never infer sameness.
+        pass
+    return True

{debugbundle_python-2.1.0 → debugbundle_python-2.1.1}/src/debugbundle/logger_integrations.py

@@ -75,11 +75,27 @@ def _attach_loguru(
         return None
 
     try:
+
         def sink(message: Any) -> None:
             record = getattr(message, "record", None)
             if not isinstance(record, dict):
                 return
             context = dict(record.get("extra") or {})
+            exception = record.get("exception")
+            error = exception.value if exception is not None else None
+            level = _normalize_level(str(getattr(record.get("level"), "name", "warning")))
+            if (
+                level in {"error", "critical"}
+                and isinstance(error, BaseException)
+                and hasattr(sdk, "capture_exception")
+            ):
+                eligible = getattr(sdk, "_log_level_eligible", None)
+                if callable(eligible) and not eligible(level):
+                    return
+                sdk.capture_exception(
+                    error, {**context, "logger_name": "loguru", "log_message": str(record.get("message") or "")}
+                )
+                return
             sdk.capture_log(
                 str(record.get("message") or ""),
                 level=_normalize_level(str(getattr(record.get("level"), "name", "warning"))),

{debugbundle_python-2.1.0 → debugbundle_python-2.1.1}/src/debugbundle/structlog_integration.py

@@ -3,6 +3,7 @@ from __future__ import annotations
 import copy
 import inspect
 import logging
+import sys
 from contextvars import ContextVar
 from typing import Any
 
@@ -19,6 +20,17 @@ def _capture(sdk: Any, active: list[bool], name: str, record: dict[str, Any]) ->
         context = dict(record)
         message = str(context.pop("event", ""))
         level = {"warn": "warning", "exception": "error", "fatal": "critical"}.get(name, name)
+        info = context.get("exc_info")
+        if info is True:
+            info = sys.exc_info()
+        error = info[1] if type(info) is tuple and len(info) == 3 else info
+        if level in {"error", "critical"} and isinstance(error, BaseException) and hasattr(sdk, "capture_exception"):
+            eligible = getattr(sdk, "_log_level_eligible", None)
+            if callable(eligible) and not eligible(level):
+                return
+            context.pop("exc_info", None)
+            sdk.capture_exception(error, {**context, "logger_name": "structlog", "log_message": message})
+            return
         sdk.capture_log(message, level=level, context=context or None)
     except Exception:
         # A logger adapter must not throw into the application's logging path.
@@ -61,8 +73,10 @@ class StructlogLoggerProxy:
         if not callable(attribute):
             return attribute
         if name in _BIND_METHODS:
+
             def bind(*args: Any, **kwargs: Any) -> StructlogLoggerProxy:
                 return StructlogLoggerProxy(attribute(*args, **kwargs), self._sdk, self._active)
+
             return bind
         method_name = name[1:] if name.startswith("a") else name
         if method_name not in _LOG_METHODS:
@@ -84,6 +98,7 @@ class StructlogLoggerProxy:
                 if args:
                     record["event"] = args[1] if method_name == "log" and len(args) > 1 else args[0]
                 processors = list(bound._processors)
+                native_info = kwargs.get("exc_info", sys.exc_info() if method_name == "exception" else None)
                 if processors:
                     last = processors[-1]
 
@@ -96,6 +111,8 @@ class StructlogLoggerProxy:
                         if isinstance(snapshot, dict):
                             record.clear()
                             record.update(snapshot)
+                            if native_info is not None:
+                                record["exc_info"] = native_info
                         return result
 
                     processors[-1] = observe
@@ -107,12 +124,15 @@ class StructlogLoggerProxy:
                 return attribute
 
         if inspect.iscoroutinefunction(attribute):
+
             async def async_log(*args: Any, **kwargs: Any) -> Any:
                 return await prepare(args, kwargs)(*args, **kwargs)
+
             return async_log
 
         def log(*args: Any, **kwargs: Any) -> Any:
             return prepare(args, kwargs)(*args, **kwargs)
+
         return log
 
     def _ensure_stdlib_handler(self, sink: Any) -> None:
@@ -136,4 +156,5 @@ class StructlogLoggerProxy:
             record = {**kwargs, **{f"arg_{i}": value for i, value in enumerate(args)}, "event": event or ""}
             _capture(self._sdk, self._active, name, record)
             return result
+
         return log

{debugbundle_python-2.1.0 → debugbundle_python-2.1.1}/src/debugbundle_python.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: debugbundle-python
-Version: 2.1.0
+Version: 2.1.1
 Summary: DebugBundle SDK for Python
 Author: DebugBundle
 License-Expression: Apache-2.0
@@ -41,6 +41,8 @@ Dynamic: license-file
 
 # debugbundle-python
 
+Patch 2.1.1 corrects native logger exception evidence and capture safety while preserving public APIs and event schemas. Upgrade the DebugBundle distribution to adopt the correction.
+
 Python SDK for DebugBundle.
 
 After `make install-docker`, `make evidence-performance` compares identical
@@ -59,16 +61,15 @@ Use this package to capture Python backend exceptions, request metadata, structu
 
 Requires Python 3.10 or newer.
 
-## Evidence candidate (unreleased)
+## Evidence in 2.1.0
 
-The source candidate adds `capture_exception_evidence=True` and
+Version 2.1.0 adds `capture_exception_evidence=True` and
 `capture_recovery_observations=False` installation options. Collection requires
 verified delivery/reader support, discovered on existing config/ACK traffic with
 `debugbundle_evidence=1`. No capture call performs discovery or adds polling.
 `evidence_capabilities` is an optional descriptor pin asserting the **entire**
 path, including local readers, relays and wrappers; later discovery can revoke it.
-Without proof, exception events retain their legacy shape. These additions are
-not available in the installed 2.0.1 release.
+Without proof, exception events retain their legacy shape. These additions require upgrading from 2.0.1 to 2.1.0.
 
 Native cause, implicit context and Python 3.11+ exception-group evidence excludes
 locals, source excerpts, arbitrary renderers and application properties. Python
@@ -89,7 +90,7 @@ Application results and exceptions pass through the context manager unchanged.
 The existing background sender remains best-effort at immediate process exit.
 The uncaught hook collects bounded native evidence without waiting for transport;
 applications needing a delivery attempt use explicit `flush()` in a controlled
-shutdown window. This candidate does not add default crash-file persistence or
+shutdown window. This release does not add default crash-file persistence or
 synchronous capture transport.
 
 Pass a fresh UUID v4 `failure_ref` in exception/log/request context. A valid

{debugbundle_python-2.1.0 → debugbundle_python-2.1.1}/src/debugbundle_python.egg-info/SOURCES.txt

@@ -18,6 +18,7 @@ src/debugbundle/evidence_json.py
 src/debugbundle/evidence_wire.py
 src/debugbundle/exception_capture.py
 src/debugbundle/exception_evidence.py
+src/debugbundle/exception_identity.py
 src/debugbundle/exception_snapshot.py
 src/debugbundle/flush_aggregates.py
 src/debugbundle/flush_delivery.py
@@ -62,6 +63,7 @@ tests/test_exception_snapshot.py
 tests/test_framework_integrations.py
 tests/test_hooks.py
 tests/test_http_integration.py
+tests/test_logging_exception.py
 tests/test_optional_imports.py
 tests/test_privacy_conformance.py
 tests/test_relay.py

debugbundle_python-2.1.1/tests/test_logging_exception.py

@@ -0,0 +1,110 @@
+from __future__ import annotations
+
+import logging
+
+import pytest
+import structlog
+
+from debugbundle.capture_hooks import DebugBundleLogHandler
+from debugbundle.core import DebugBundleSdk
+from debugbundle.transport import TransportResponse
+
+_ORIGINAL_GET_LOGGER = structlog.get_logger
+
+
+@pytest.mark.parametrize("drop_first", [False, True])
+def test_repeated_native_records_and_capture_after_rejected_hook(drop_first):
+    events = []
+    calls = []
+
+    def hook(event):
+        calls.append(event)
+        return None if len(calls) == 1 else event
+
+    sdk = DebugBundleSdk(transport=lambda request: (events.extend(request["events"]), TransportResponse(202))[1])
+    sdk.init("synthetic-token", batch_size=1000, flush_interval=3600, before_send=hook if drop_first else None)
+    error = RuntimeError("reused object")
+    try:
+        with sdk.operation_context({"kind": "request"}):
+            sdk.capture_exception(error, context={"logger_name": "synthetic"})
+            sdk.flush()
+            sdk.capture_exception(error, context={} if drop_first else {"logger_name": "synthetic"})
+            sdk.flush()
+        assert len(events) == (1 if drop_first else 2)
+    finally:
+        sdk.dispose()
+
+
+def test_stdlib_exception_preserves_traceback_and_cause_without_frame_logs():
+    events = []
+
+    def send(request):
+        events.extend(request["events"])
+        return TransportResponse(202)
+
+    sdk = DebugBundleSdk(transport=send)
+    sdk.init("synthetic-token", batch_size=1000, flush_interval=3600)
+    logger = logging.Logger("synthetic", level=logging.ERROR)
+    logger.addHandler(DebugBundleLogHandler(sdk))
+    try:
+        try:
+            try:
+                raise ValueError("synthetic cause")
+            except ValueError as cause:
+                raise RuntimeError("synthetic outer") from cause
+        except RuntimeError:
+            logger.exception("operation failed")
+        logger.error("ordinary error")
+        sdk.flush()
+        assert [event["event_type"] for event in events] == ["backend_exception", "log_event"]
+        assert "synthetic cause" in events[0]["payload"]["stack"]
+        assert "test_stdlib_exception" in events[0]["payload"]["stack"]
+    finally:
+        sdk.dispose()
+
+
+def test_logger_and_explicit_capture_share_identity_only_inside_owned_operation():
+    events = []
+    sdk = DebugBundleSdk(transport=lambda request: (events.extend(request["events"]), TransportResponse(202))[1])
+    sdk.init("synthetic-token", batch_size=1000, flush_interval=3600)
+    logger = logging.Logger("synthetic", level=logging.ERROR)
+    logger.addHandler(DebugBundleLogHandler(sdk))
+    error = RuntimeError("same object")
+    try:
+        for _ in range(2):
+            with sdk.operation_context({"kind": "request"}):
+                logger.error("failed", exc_info=(RuntimeError, error, None))
+                sdk.capture_exception(error)
+        sdk.flush()
+        assert len(events) == 2
+    finally:
+        sdk.dispose()
+
+
+def test_loguru_and_structlog_preserve_native_cause_after_formatters(monkeypatch):
+    import structlog
+    from loguru import logger
+
+    events = []
+    sdk = DebugBundleSdk(transport=lambda request: (events.extend(request["events"]), TransportResponse(202))[1])
+    sdk.init("synthetic-token", batch_size=1000, flush_interval=3600)
+    previous = structlog.get_config()
+    monkeypatch.setattr(structlog, "get_logger", _ORIGINAL_GET_LOGGER)
+    structlog.configure(
+        processors=[structlog.processors.format_exc_info, structlog.processors.JSONRenderer()],
+        logger_factory=structlog.ReturnLoggerFactory(),
+    )
+    sdk.capture_logging(logger=logging.Logger("synthetic-integrations"))
+    try:
+        try:
+            raise ValueError("native cause")
+        except ValueError:
+            logger.exception("loguru failure")
+            structlog.get_logger().exception("structlog failure")
+        sdk.flush()
+        assert len(events) == 2
+        assert all(event["event_type"] == "backend_exception" for event in events)
+        assert all("native cause" in event["payload"]["stack"] for event in events)
+    finally:
+        structlog.configure(**previous)
+        sdk.dispose()