debugbundle-python 0.1.0__py3-none-any.whl → 0.1.2__py3-none-any.whl

debugbundle/config.py

@@ -37,15 +37,15 @@ class RemoteConfigSnapshot:
 BALANCED_CAPTURE_POLICY = CapturePolicy(
     preset="balanced",
     capture_logs="warning",
-    capture_request_events="all",
-    capture_breadcrumbs="local_only",
-    capture_probe_events="standalone_when_activated",
+    capture_request_events="failures_only",
+    capture_breadcrumbs="exception_only",
+    capture_probe_events="buffer_only",
 )
 
 MINIMAL_CAPTURE_POLICY = CapturePolicy(
     preset="minimal",
-    capture_logs="warning",
-    capture_request_events="off",
+    capture_logs="error",
+    capture_request_events="failures_only",
     capture_breadcrumbs="local_only",
     capture_probe_events="buffer_only",
 )

debugbundle/core.py

@@ -2,9 +2,12 @@ from __future__ import annotations
 
 import asyncio
 import logging
+import os
 import platform
+import socket
 import sys
 import threading
+import time
 import traceback
 import uuid
 from collections import deque
@@ -32,10 +35,16 @@ from .suppression import EventSuppressionTracker
 from .transport import HttpTransport, Transport, coerce_transport_response
 from .trigger_token import resolve_request_trigger_directives
 
+try:
+    import resource
+except ImportError:  # pragma: no cover - resource is unavailable on some platforms.
+    resource = None  # type: ignore[assignment]
+
 DEFAULT_BATCH_SIZE = 25
 DEFAULT_FLUSH_INTERVAL = 5.0
 DEFAULT_ENDPOINT = "https://api.debugbundle.com/v1/events"
 DEFAULT_LOG_LEVEL = "warning"
+PROCESS_START_MONOTONIC = time.monotonic()
 SCHEMA_VERSION = "2026-03-01"
 LEVEL_RANKS = {
     "debug": 10,
@@ -225,7 +234,7 @@ class DebugBundleSdk:
                 "handled": handled,
                 "request": request_payload,
                 "response": response_payload,
-                "runtime": {"version": platform.python_version()},
+                "runtime": _runtime_process_facts(),
             }
             if self._probe_flush_on_error:
                 probe_data = self._build_probe_data()
@@ -590,19 +599,25 @@ class DebugBundleSdk:
 
     def _should_capture_request_event(self, response: Mapping[str, object] | None) -> bool:
         policy = self._capture_policy.capture_request_events
+        status_code = None
+        if response is not None:
+            candidate = response.get("status_code") or response.get("response_status")
+            if isinstance(candidate, int):
+                status_code = candidate
+        if status_code is not None and status_code >= 500:
+            return True
         if policy == "off":
             return False
         if policy == "all":
             return True
         if response is None:
             return policy == "filtered"
-        status_code = response.get("status_code") or response.get("response_status")
-        if not isinstance(status_code, int):
+        if status_code is None:
             return policy == "filtered"
         if policy == "failures_only":
-            return status_code >= 500
+            return False
         if policy == "filtered":
-            return status_code >= 500
+            return False
         return True
 
     def _emit_probe_events(self, label: str, data: dict[str, object], directives: list[RemoteProbeDirective]) -> None:
@@ -693,6 +708,51 @@ def _redact_mapping(value: object, redact_fields: set[str]) -> Any:
     return value
 
 
+def _runtime_process_facts() -> dict[str, object]:
+    return {
+        "version": platform.python_version(),
+        "platform": sys.platform,
+        "arch": platform.machine() or None,
+        "pid": os.getpid(),
+        "cwd": _safe_cwd(),
+        "uptime_sec": round(max(0.0, time.monotonic() - PROCESS_START_MONOTONIC), 3),
+        "hostname": _safe_hostname(),
+        "thread_id": threading.get_ident(),
+        "memory": _memory_facts(),
+    }
+
+
+def _safe_cwd() -> str | None:
+    try:
+        return os.getcwd()
+    except OSError:
+        return None
+
+
+def _safe_hostname() -> str | None:
+    try:
+        return socket.gethostname()
+    except OSError:
+        return None
+
+
+def _memory_facts() -> dict[str, object]:
+    memory: dict[str, object] = {
+        "rss": None,
+        "heap_total": None,
+        "heap_used": None,
+        "external": None,
+        "peak": None,
+    }
+    if resource is None:
+        return memory
+
+    usage = resource.getrusage(resource.RUSAGE_SELF)
+    # ru_maxrss is KiB on Linux and bytes on macOS/BSD.
+    memory["peak"] = usage.ru_maxrss if sys.platform == "darwin" else usage.ru_maxrss * 1024
+    return memory
+
+
 def _backend_exception_request_payload(candidate: object | None) -> dict[str, object]:
     mapping = _dict_from_object(candidate)
     payload: dict[str, object] = {

debugbundle/relay.py

@@ -15,6 +15,7 @@ ACCEPTED_EVENT_TYPES = frozenset(
         "frontend_exception",
         "error_suppressed",
         "frontend_breadcrumb",
+        "request_event",
         "probe_event",
     }
 )

{debugbundle_python-0.1.0.dist-info → debugbundle_python-0.1.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: debugbundle-python
-Version: 0.1.0
+Version: 0.1.2
 Summary: DebugBundle SDK for Python
 Author: DebugBundle
 License-Expression: AGPL-3.0-only
@@ -59,8 +59,28 @@ debugbundle.flush()
 
 ## Status
 
-This repository currently contains the full Phase 18 Python SDK scope in eleven implementation slices: core SDK surface, buffering, redaction, duplicate suppression, probe buffering, vanilla runtime hooks, framework integrations for Django, Flask, and FastAPI, remote config polling and capture-policy enforcement, optional `structlog` and `loguru` auto-detection when `capture_logging()` is enabled, contract-aligned `EventEnvelope` emission for log, request, exception, suppression, and probe payloads, explicit public wrapper signatures and a validated buildable typed package artifact, real HTTP integration coverage against a lightweight mock ingestion server, vendored machine-readable schema validation for all event types the Python SDK currently emits, a standalone CI workflow that validates Ruff, mypy, pytest, and package builds for the Python 3.10+ support floor actually used by the package, an enforced per-file coverage gate that keeps every shipped Python SDK module at or above the required 80% minimum, and request-local framework correlation binding so `X-DebugBundle-Trace-Id` flows through Django, Flask, and FastAPI into the emitted event correlation metadata for cross-context linking.
+This repository currently contains the full Phase 18 Python SDK scope in eleven implementation slices: core SDK surface, buffering, redaction, duplicate suppression, probe buffering, vanilla runtime hooks, framework integrations for Django, Flask, and FastAPI, remote config polling and capture-policy enforcement, optional `structlog` and `loguru` auto-detection when `capture_logging()` is enabled, contract-aligned `EventEnvelope` emission for log, request, exception, suppression, and probe payloads, explicit public wrapper signatures and a validated buildable typed package artifact, real HTTP integration coverage against a lightweight mock ingestion server, vendored machine-readable schema validation for all event types the Python SDK currently emits, a standalone CI workflow that validates Ruff, mypy, pytest, and package builds for the Python 3.10+ support floor actually used by the package, an enforced per-file coverage gate that keeps every shipped Python SDK module at or above the required 80% minimum, request-local framework correlation binding so `X-DebugBundle-Trace-Id` flows through Django, Flask, and FastAPI into the emitted event correlation metadata for cross-context linking, and safe backend runtime process facts on exception payloads without reading environment variables.
+
+## Runtime Context
+
+Backend exception events now include safe runtime process facts when the host exposes them, including:
+
+- Python version
+- platform
+- architecture
+- pid
+- cwd
+- uptime
+- hostname
+- thread id
+- best-effort memory metadata
+
+The SDK does not read or emit environment variables in this runtime block.
 
 ## Docs
 
 https://debugbundle.com/docs/sdk-python
+
+## License
+
+AGPL-3.0-only

{debugbundle_python-0.1.0.dist-info → debugbundle_python-0.1.2.dist-info}/RECORD

@@ -1,10 +1,10 @@
 debugbundle/__init__.py,sha256=mqibduUrdcr_fnb6k3Gwf93H7iqVBS8zd6SceX-U3Q4,5011
-debugbundle/config.py,sha256=tmXJc16v9yzldiyp1Fwo2s0j-Ek-wbKx__BeKaNw9ec,6097
-debugbundle/core.py,sha256=CTx3MmJv0x3fZr0IqTqliv0slTqmia9QVb6eEm4RPTQ,32628
+debugbundle/config.py,sha256=2dLHEsh79mUaa6p7pkrQM849khwSBPg68Aq9RaeXf-8,6105
+debugbundle/core.py,sha256=KIXboK-n1zbgmTCMO1kf-v_jtAA4SOFQvd0BahEt29s,34204
 debugbundle/logger_integrations.py,sha256=RuTNaD9RRVmiE-BBkksAXWVEGaMzLrWavVpQdgGZBpE,4564
 debugbundle/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 debugbundle/redaction.py,sha256=QTaPkSsYv54yR1mz8SB6Q4vWjvp7Ddcui4WXaH2RVz8,736
-debugbundle/relay.py,sha256=q7WjESsIGoaHETQGhWuT-4KdBmXAocuoCLXuEaz9f60,8678
+debugbundle/relay.py,sha256=TUzlUsTtDKDVVHj0RvYgQVmxy-Jl3Sp8BMBT033mGDM,8703
 debugbundle/suppression.py,sha256=XMn0GfF_-WZk2wHWk3KfbO5_u5QhEunues5h3jOInLs,4098
 debugbundle/transport.py,sha256=oOk0xazHxq9h4CneJdRODKtwDciwikvpHVJM_6iBYXU,1791
 debugbundle/trigger_token.py,sha256=YUwIWnnxu1klAVaB8Ltgk_PwWW_PPjq9rzmEbWXeFeM,4455
@@ -16,8 +16,8 @@ debugbundle/integrations/flask.py,sha256=cgyHbsAH96gpNPf_5IGJYzp2va28JdDgXROBsF-
 debugbundle/integrations/relay_django.py,sha256=_2TiH-oS0DOwThyfMJZ6ZJr5MkXEekEDaBUfPapMxt8,1523
 debugbundle/integrations/relay_fastapi.py,sha256=Z2spWy3wufVrBjYwRDDOL5Dsjgwcd5g72L23_sdulvo,1512
 debugbundle/integrations/relay_flask.py,sha256=WHk_ALOtT0xUuI1eINWFyLig9eRjSmIBpQ39xdkV608,1329
-debugbundle_python-0.1.0.dist-info/licenses/LICENSE,sha256=AKZZ5DQAHrOKGwt24VoRd-SXJLM9OloxlsX8ZgENdEY,735
-debugbundle_python-0.1.0.dist-info/METADATA,sha256=LtOnh1fp34Nt1M6Cl-K3DO9IJNEjyj6q3OXmAU9VFv4,3148
-debugbundle_python-0.1.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
-debugbundle_python-0.1.0.dist-info/top_level.txt,sha256=RCB9STTFnl1OKdojxz-xhaks2zkRFs1meZXsKnm18LM,12
-debugbundle_python-0.1.0.dist-info/RECORD,,
+debugbundle_python-0.1.2.dist-info/licenses/LICENSE,sha256=AKZZ5DQAHrOKGwt24VoRd-SXJLM9OloxlsX8ZgENdEY,735
+debugbundle_python-0.1.2.dist-info/METADATA,sha256=sJOxeZhAm37kzC-TtO0SWrIZ5FEckB8oSNGZ78RCOsY,3589
+debugbundle_python-0.1.2.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+debugbundle_python-0.1.2.dist-info/top_level.txt,sha256=RCB9STTFnl1OKdojxz-xhaks2zkRFs1meZXsKnm18LM,12
+debugbundle_python-0.1.2.dist-info/RECORD,,