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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: debugbundle-python
-Version: 1.4.2
+Version: 2.0.0
 Summary: DebugBundle SDK for Python
 Author: DebugBundle
 License-Expression: Apache-2.0
@@ -17,6 +17,8 @@ Classifier: Programming Language :: Python :: 3 :: Only
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
 Classifier: Typing :: Typed
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
@@ -24,7 +26,7 @@ License-File: LICENSE
 Requires-Dist: httpx<0.29,>=0.27
 Provides-Extra: dev
 Requires-Dist: build<2,>=1; extra == "dev"
-Requires-Dist: django<6,>=5; extra == "dev"
+Requires-Dist: django<7,>=5; extra == "dev"
 Requires-Dist: fastapi<1,>=0.115; extra == "dev"
 Requires-Dist: flask<4,>=3; extra == "dev"
 Requires-Dist: jsonschema<5,>=4.23; extra == "dev"
@@ -49,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.
@@ -97,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()
 ```
 
@@ -263,8 +268,8 @@ There is no zero-install fallback for the Python SDK itself in V1. The nearest l
 
 | Surface | Minimum compatibility version | Recommended production version | Installed-base compatibility lane | Rolling CI lane | Out of scope |
 | --- | --- | --- | --- | --- | --- |
-| Python runtime | 3.10 | 3.12 | 3.10 and 3.11 remain supported for installed-base coverage | 3.12 | 3.9 and older |
-| Django | 5.x | latest 5.x patch | 5.x compatibility support | repo release smoke and tests install Django 5.x | Django 4.x and older |
+| Python runtime | 3.10 | 3.14 | 3.10 through 3.13 remain supported for installed-base coverage | 3.10 through 3.14 | 3.9 and older |
+| Django | 5.x | latest 6.1 patch | 5.x compatibility support | Python 3.14 suite exercises Django 6.1 | Django 4.x and older |
 | Flask | 3.x | latest 3.x patch | 3.x compatibility support | repo release smoke installs Flask 3.x | Flask 2.x and older |
 | FastAPI | 0.115+ | latest 0.115+ patch line | 0.115+ compatibility support | repo tests install FastAPI 0.115+ | standalone Starlette, older FastAPI lines |
 
@@ -275,14 +280,16 @@ Post-V1 planned expansions from `spec/sdk-language-targets.md` remain out of sco
 `debugbundle-python` ships as one package in V1, so there is no multi-package version-alignment step like a BOM or plugin family lock.
 
 - Pin one `debugbundle-python` version across your service and worker repos when you want identical SDK behavior everywhere.
-- Keep framework dependencies inside the supported lanes above: Django 5.x, Flask 3.x, and FastAPI 0.115+.
+- Keep framework dependencies inside the supported lanes above: Django 5.x or 6.x, Flask 3.x, and FastAPI 0.115+.
 - The packaged HTTP client dependency is `httpx>=0.27,<0.29`; if you override transport behavior in tests or wrappers, stay inside that range unless you retest the SDK.
 
 ## 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.4.2 → 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()
 ```
 
@@ -224,8 +227,8 @@ There is no zero-install fallback for the Python SDK itself in V1. The nearest l
 
 | Surface | Minimum compatibility version | Recommended production version | Installed-base compatibility lane | Rolling CI lane | Out of scope |
 | --- | --- | --- | --- | --- | --- |
-| Python runtime | 3.10 | 3.12 | 3.10 and 3.11 remain supported for installed-base coverage | 3.12 | 3.9 and older |
-| Django | 5.x | latest 5.x patch | 5.x compatibility support | repo release smoke and tests install Django 5.x | Django 4.x and older |
+| Python runtime | 3.10 | 3.14 | 3.10 through 3.13 remain supported for installed-base coverage | 3.10 through 3.14 | 3.9 and older |
+| Django | 5.x | latest 6.1 patch | 5.x compatibility support | Python 3.14 suite exercises Django 6.1 | Django 4.x and older |
 | Flask | 3.x | latest 3.x patch | 3.x compatibility support | repo release smoke installs Flask 3.x | Flask 2.x and older |
 | FastAPI | 0.115+ | latest 0.115+ patch line | 0.115+ compatibility support | repo tests install FastAPI 0.115+ | standalone Starlette, older FastAPI lines |
 
@@ -236,14 +239,16 @@ Post-V1 planned expansions from `spec/sdk-language-targets.md` remain out of sco
 `debugbundle-python` ships as one package in V1, so there is no multi-package version-alignment step like a BOM or plugin family lock.
 
 - Pin one `debugbundle-python` version across your service and worker repos when you want identical SDK behavior everywhere.
-- Keep framework dependencies inside the supported lanes above: Django 5.x, Flask 3.x, and FastAPI 0.115+.
+- Keep framework dependencies inside the supported lanes above: Django 5.x or 6.x, Flask 3.x, and FastAPI 0.115+.
 - The packaged HTTP client dependency is `httpx>=0.27,<0.29`; if you override transport behavior in tests or wrappers, stay inside that range unless you retest the SDK.
 
 ## 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.4.2 → debugbundle_python-2.0.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "debugbundle-python"
-version = "1.4.2"
+version = "2.0.0"
 description = "DebugBundle SDK for Python"
 readme = "README.md"
 requires-python = ">=3.10"
@@ -21,6 +21,8 @@ classifiers = [
   "Programming Language :: Python :: 3.10",
   "Programming Language :: Python :: 3.11",
   "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
+  "Programming Language :: Python :: 3.14",
   "Typing :: Typed"
 ]
 dependencies = [
@@ -30,7 +32,7 @@ dependencies = [
 [project.optional-dependencies]
 dev = [
   "build>=1,<2",
-  "django>=5,<6",
+  "django>=5,<7",
   "fastapi>=0.115,<1",
   "flask>=3,<4",
   "jsonschema>=4.23,<5",

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]