debugbundle-python 1.4.2__py3-none-any.whl → 2.0.0__py3-none-any.whl

debugbundle/suppression.py

@@ -1,5 +1,6 @@
 from __future__ import annotations
 
+from collections import OrderedDict
 from dataclasses import dataclass
 from hashlib import sha256
 
@@ -9,6 +10,7 @@ LOOP_THRESHOLD = 10
 LOOP_RESET_AFTER_SECONDS = 60.0
 LOOP_CHECKPOINT_SECONDS = 30.0
 MAX_NORMAL_EVENTS_PER_WINDOW = 3
+MAX_TRACKED_FINGERPRINTS = 2_048
 
 
 @dataclass
@@ -27,25 +29,30 @@ class SuppressionState:
 
 class EventSuppressionTracker:
     def __init__(self) -> None:
-        self._states: dict[str, SuppressionState] = {}
+        self._states: OrderedDict[str, SuppressionState] = OrderedDict()
 
     def should_capture(self, key: str, now: float) -> bool:
-        state = self._states.get(key)
+        fingerprint = sha256(key.encode("utf-8")).hexdigest()
+        state = self._states.get(fingerprint)
         if state is None:
+            if len(self._states) >= MAX_TRACKED_FINGERPRINTS:
+                self._states.popitem(last=False)
             state = SuppressionState(
                 window_started_at=now,
                 loop_window_started_at=now,
                 last_seen_at=now,
             )
-            self._states[key] = state
+            self._states[fingerprint] = state
+        else:
+            self._states.move_to_end(fingerprint)
 
         if state.suppression_mode and now - state.last_seen_at >= LOOP_RESET_AFTER_SECONDS:
-            self._states[key] = SuppressionState(
+            self._states[fingerprint] = SuppressionState(
                 window_started_at=now,
                 loop_window_started_at=now,
                 last_seen_at=now,
             )
-            state = self._states[key]
+            state = self._states[fingerprint]
 
         if now - state.window_started_at >= DUPLICATE_WINDOW_SECONDS:
             state.window_started_at = now
@@ -94,7 +101,7 @@ class EventSuppressionTracker:
                 {
                     "event_type": "error_suppressed",
                     "payload": {
-                        "fingerprint": sha256(key.encode("utf-8")).hexdigest(),
+                        "fingerprint": key,
                         "suppressed_count": state.pending_suppressed_count,
                         "first_seen": _to_iso(state.pending_first_seen_at),
                         "last_seen": _to_iso(state.pending_last_seen_at),

{debugbundle_python-1.4.2.dist-info → debugbundle_python-2.0.0.dist-info}/METADATA

@@ -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.dist-info → debugbundle_python-2.0.0.dist-info}/RECORD

@@ -1,16 +1,24 @@
 debugbundle/__init__.py,sha256=QH5RY2Cdp3Ry5PNSAhiV9akOMoS2pERRqowFnZ94roc,5131
 debugbundle/acknowledgement.py,sha256=tyI8XLRG9N3-Weo6uiGrAlf_O4tjptVe1x1cG7RjrMc,2314
 debugbundle/before_send.py,sha256=_tmV6ovHUBIxfQPMQ8a0C6r91IAnd4DVs8UcjsKhqX0,7792
+debugbundle/capture_hooks.py,sha256=70Q6ske8JulyuYpeE9FohvMreytf4DUrj4QW9f2-o2Q,1940
 debugbundle/config.py,sha256=ENRSR5jUI7xYdBqUakWws3GIjBk00GWFmwXVE_iQp2Y,9296
-debugbundle/core.py,sha256=ox4fNADe2kRic9aUePB_RJmT81vCQ9SFW6PaCSL-YL0,32888
-debugbundle/event_support.py,sha256=qsoqY3kUi9wdxDwLH2X5JpVid_KDyddpQ1J-yiTR6ds,9046
+debugbundle/core.py,sha256=XgRx92jSzrP6PjvHHRI0NlwdD53cRmBQ6qN4UtnQqIA,39310
+debugbundle/delivery_hooks.py,sha256=BUqtHuEv1MDOSLv0sUP6D582c06JofsbXhi7I7Y5IGc,2691
+debugbundle/event_support.py,sha256=MtPg2CO7B91U7-zE9XGro0-fynaEnJZmQ6Ms9arfRlg,9046
+debugbundle/exception_snapshot.py,sha256=_2p55F572sL7_ogBL6Raa137HRyUqvSaHVMwpKiC8fs,2831
+debugbundle/flush_aggregates.py,sha256=ukHsIUykeGp4YJsesA_9NCUMarg_BAXVuzO4bqJKH3Y,1464
 debugbundle/logger_integrations.py,sha256=T6LR10_DgDS8C-CUPxtC1kZz3qfX5j0B2YUV7LxDovk,3572
+debugbundle/probe_capture.py,sha256=c1a-ZKHyNeu6CMS5zgi8_wIfpLs5-pe12GEXNMpMTVM,3969
+debugbundle/process_support.py,sha256=D1aFhaP1wOGfMdzkdtEhO54R3XWa8dLCZlfWHWN3qA4,1962
 debugbundle/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-debugbundle/redaction.py,sha256=QTaPkSsYv54yR1mz8SB6Q4vWjvp7Ddcui4WXaH2RVz8,736
-debugbundle/relay.py,sha256=p5-tFXsgH8TZfB7Va3C2XFJsi8mYOMnGjr01W_kApME,14366
+debugbundle/queue_admission.py,sha256=QtFengGZ4KEVbu1UqSp3u8eLucQeS9dGIwrzq62A5cY,1433
+debugbundle/redaction.py,sha256=mxJgtILpVDUaj8LAhzswfaX1M4Ppyx87lfkhFqbMR8M,9663
+debugbundle/relay.py,sha256=9HkEEVZpqrebzH6A-sSuFVuFjyLg07JuTMpMG8pu7SY,14726
 debugbundle/relay_delivery.py,sha256=VL-nIgJR6mYXqKy-EbA0USWeY_iS_uAr1KBzrnwBnnk,4676
+debugbundle/request_capture_policy.py,sha256=fl1EilWAnBQCdGTafRpY0tMlYUoSJK_7hZyJmPHLkeI,1583
 debugbundle/structlog_integration.py,sha256=hDwCGXTQ8GAjnx2jwlRbpnvLE0y798kFFMsSB3iqOrM,6061
-debugbundle/suppression.py,sha256=XMn0GfF_-WZk2wHWk3KfbO5_u5QhEunues5h3jOInLs,4098
+debugbundle/suppression.py,sha256=V_JvDvcV7tN3EHkfpEJGK1WB2G4nR3GhXvaKd400iFQ,4418
 debugbundle/transport.py,sha256=V289FwFWL6KV5gyzOsesluEMbpRobm_FHu3x8BpOYKU,2014
 debugbundle/trigger_token.py,sha256=YUwIWnnxu1klAVaB8Ltgk_PwWW_PPjq9rzmEbWXeFeM,4455
 debugbundle/integrations/__init__.py,sha256=Jr87ImWXzUXOuFP4WlGleK14VARajSSdGZN_nHt5emw,1161
@@ -21,8 +29,8 @@ debugbundle/integrations/flask.py,sha256=cgyHbsAH96gpNPf_5IGJYzp2va28JdDgXROBsF-
 debugbundle/integrations/relay_django.py,sha256=Wj8BE9D5otU2KmtjgqdKIJ-BvXVcagCKgpLYvnPZ6WE,2281
 debugbundle/integrations/relay_fastapi.py,sha256=-Zl6bvhYMLii__mP6-UvSdwxS5VKsb9OZvk-yy-3hEw,2227
 debugbundle/integrations/relay_flask.py,sha256=VFHkDTJy4LkZzL_Ry_Ba-e_gW6UTG4PBwnLcvB_oXuQ,2011
-debugbundle_python-1.4.2.dist-info/licenses/LICENSE,sha256=z8d0m5b2O9McPEK1xHG_dWgUBT6EfBDz6wA0F7xSPTA,11358
-debugbundle_python-1.4.2.dist-info/METADATA,sha256=JB2zaShchgs9NJNvZotd2ETh3em8XHhxU776FvbeOSo,14452
-debugbundle_python-1.4.2.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
-debugbundle_python-1.4.2.dist-info/top_level.txt,sha256=RCB9STTFnl1OKdojxz-xhaks2zkRFs1meZXsKnm18LM,12
-debugbundle_python-1.4.2.dist-info/RECORD,,
+debugbundle_python-2.0.0.dist-info/licenses/LICENSE,sha256=z8d0m5b2O9McPEK1xHG_dWgUBT6EfBDz6wA0F7xSPTA,11358
+debugbundle_python-2.0.0.dist-info/METADATA,sha256=oX9_gQfmoPs8PCSNucy0tTany71DEiuHsu71IPmYBmg,15231
+debugbundle_python-2.0.0.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+debugbundle_python-2.0.0.dist-info/top_level.txt,sha256=RCB9STTFnl1OKdojxz-xhaks2zkRFs1meZXsKnm18LM,12
+debugbundle_python-2.0.0.dist-info/RECORD,,