debugbundle-python 1.5.0__tar.gz → 2.0.0__tar.gz

{debugbundle_python-1.5.0 → debugbundle_python-2.0.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: debugbundle-python
-Version: 1.5.0
+Version: 2.0.0
 Summary: DebugBundle SDK for Python
 Author: DebugBundle
 License-Expression: Apache-2.0
@@ -51,6 +51,8 @@ Use this package to capture Python backend exceptions, request metadata, structu
 
 Requires Python 3.10 or newer.
 
+Version 2.0.0 protects capture callers with bounded, priority-aware background delivery. Review the [2.0 migration guide](MIGRATION-2.0.md) before upgrading from 1.x.
+
 ## Automatic capture and application filtering
 
 `capture_logging()` attaches the stdlib logging handler and detects installed structlog/loguru integrations. Obtain structlog loggers after attachment. Structlog level filters and `DropEvent` processors run before capture; stdlib-backed structlog loggers also honor logger filters, disabled state and `logging.disable()`. Bound context and async logging are supported. SDK disposal stops capture through cached proxies. DebugBundle has its own minimum capture level; destination-specific filters on other handlers or Loguru sinks do not configure the DebugBundle handler.
@@ -99,6 +101,7 @@ debugbundle.capture_log("payment retry failed", level="warning", context={"order
 debugbundle.capture_message("worker started")
 debugbundle.probe("checkout.cart", {"item_count": len(cart.items)})
 
+# Use only during controlled teardown or tests, never on a request path.
 debugbundle.flush()
 ```
 
@@ -283,8 +286,10 @@ Post-V1 planned expansions from `spec/sdk-language-targets.md` remain out of sco
 ## Safety Defaults
 
 - SDK failures are caught internally and do not crash the host process.
+- A forked worker starts with a fresh SDK queue, lock, context and built-in HTTP client. Initialize the SDK in each child when remote configuration must poll there; custom transports must be fork-safe.
 - Sensitive fields are redacted before transport.
 - Duplicate event storms are suppressed locally.
+- Full-queue capture sheds warning/request noise before context scans. Exceptions, ERROR logs, and 5xx request incidents have priority over pending lower-priority events; all-error overloads are bounded and summarized.
 - Runtime context excludes environment variables.
 - Browser relay requests cannot smuggle server-side credentials.
 

{debugbundle_python-1.5.0 → debugbundle_python-2.0.0}/README.md

@@ -10,6 +10,8 @@ Use this package to capture Python backend exceptions, request metadata, structu
 
 Requires Python 3.10 or newer.
 
+Version 2.0.0 protects capture callers with bounded, priority-aware background delivery. Review the [2.0 migration guide](MIGRATION-2.0.md) before upgrading from 1.x.
+
 ## Automatic capture and application filtering
 
 `capture_logging()` attaches the stdlib logging handler and detects installed structlog/loguru integrations. Obtain structlog loggers after attachment. Structlog level filters and `DropEvent` processors run before capture; stdlib-backed structlog loggers also honor logger filters, disabled state and `logging.disable()`. Bound context and async logging are supported. SDK disposal stops capture through cached proxies. DebugBundle has its own minimum capture level; destination-specific filters on other handlers or Loguru sinks do not configure the DebugBundle handler.
@@ -58,6 +60,7 @@ debugbundle.capture_log("payment retry failed", level="warning", context={"order
 debugbundle.capture_message("worker started")
 debugbundle.probe("checkout.cart", {"item_count": len(cart.items)})
 
+# Use only during controlled teardown or tests, never on a request path.
 debugbundle.flush()
 ```
 
@@ -242,8 +245,10 @@ Post-V1 planned expansions from `spec/sdk-language-targets.md` remain out of sco
 ## Safety Defaults
 
 - SDK failures are caught internally and do not crash the host process.
+- A forked worker starts with a fresh SDK queue, lock, context and built-in HTTP client. Initialize the SDK in each child when remote configuration must poll there; custom transports must be fork-safe.
 - Sensitive fields are redacted before transport.
 - Duplicate event storms are suppressed locally.
+- Full-queue capture sheds warning/request noise before context scans. Exceptions, ERROR logs, and 5xx request incidents have priority over pending lower-priority events; all-error overloads are bounded and summarized.
 - Runtime context excludes environment variables.
 - Browser relay requests cannot smuggle server-side credentials.
 

{debugbundle_python-1.5.0 → debugbundle_python-2.0.0}/pyproject.toml

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

debugbundle_python-2.0.0/src/debugbundle/capture_hooks.py

@@ -0,0 +1,65 @@
+"""Logger adapter and bounded capture admission for callback-heavy paths."""
+
+from __future__ import annotations
+
+import logging
+import re
+import time
+from typing import TYPE_CHECKING
+
+from .process_support import ensure_current_process
+
+if TYPE_CHECKING:
+    from .core import DebugBundleSdk
+
+
+def try_capture_lock(sdk: DebugBundleSdk) -> bool:
+    ensure_current_process(sdk)
+    for _ in range(8):
+        if sdk._lock.acquire(blocking=False):
+            return True
+        time.sleep(0)
+    return False
+
+
+class DebugBundleLogHandler(logging.Handler):
+    def __init__(self, sdk: DebugBundleSdk) -> None:
+        super().__init__()
+        self._sdk = sdk
+
+    def emit(self, record: logging.LogRecord) -> None:
+        if not self._sdk._log_level_eligible(record.levelname.lower()):
+            return
+        self._sdk.capture_log(
+            safe_log_message(record),
+            level=record.levelname.lower(),
+            context={
+                "logger_name": record.name,
+                "pathname": record.pathname,
+                "lineno": record.lineno,
+            },
+        )
+
+
+_PLACEHOLDER = re.compile(r"%[sdif]")
+
+
+def safe_log_message(record: logging.LogRecord) -> str:
+    template = record.msg
+    if type(template) is not str:
+        return "[non-string log message withheld]"
+    template = template[:16_384]
+    args = record.args
+    if not args:
+        return template
+    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)
+        else "[unsupported argument]"
+        for value in args
+    ]
+    if len(_PLACEHOLDER.findall(template)) != len(safe_args):
+        return (template + " [args: " + ", ".join(safe_args) + "]")[:16_384]
+    iterator = iter(safe_args)
+    return _PLACEHOLDER.sub(lambda _match: next(iterator), template)[:16_384]