debugbundle-python 0.1.1__tar.gz → 0.1.3__tar.gz

{debugbundle_python-0.1.1 → debugbundle_python-0.1.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: debugbundle-python
-Version: 0.1.1
+Version: 0.1.3
 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.1 → debugbundle_python-0.1.3}/README.md

@@ -20,8 +20,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.1 → debugbundle_python-0.1.3}/pyproject.toml

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

{debugbundle_python-0.1.1 → debugbundle_python-0.1.3}/src/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,
@@ -44,6 +53,11 @@ LEVEL_RANKS = {
     "error": 40,
     "critical": 50,
 }
+BALANCED_IMMEDIATE_REQUEST_STATUSES = {408, 423, 424, 425, 429}
+INVESTIGATIVE_IMMEDIATE_REQUEST_STATUSES = BALANCED_IMMEDIATE_REQUEST_STATUSES | {409}
+BALANCED_STANDARD_ANOMALY_STATUSES = {401, 403, 404, 409, 422}
+BALANCED_HIGH_VOLUME_ANOMALY_STATUSES = {400, 410}
+INVESTIGATIVE_ANOMALY_STATUSES = BALANCED_STANDARD_ANOMALY_STATUSES | BALANCED_HIGH_VOLUME_ANOMALY_STATUSES
 
 
 @dataclass
@@ -225,7 +239,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()
@@ -595,7 +609,7 @@ class DebugBundleSdk:
             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:
+        if _is_immediate_request_incident_status(status_code, self._capture_policy.preset):
             return True
         if policy == "off":
             return False
@@ -606,7 +620,7 @@ class DebugBundleSdk:
         if status_code is None:
             return policy == "filtered"
         if policy == "failures_only":
-            return False
+            return _is_request_anomaly_candidate_status(status_code, self._capture_policy.preset)
         if policy == "filtered":
             return False
         return True
@@ -699,6 +713,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] = {
@@ -792,6 +851,28 @@ def _iso_now(time_provider: Callable[[], float]) -> str:
     return datetime.fromtimestamp(time_provider(), tz=timezone.utc).isoformat().replace("+00:00", "Z")
 
 
+def _is_immediate_request_incident_status(status_code: int | None, preset: str) -> bool:
+    if status_code is None:
+        return False
+    if status_code >= 500:
+        return True
+    if preset == "investigative":
+        return status_code in INVESTIGATIVE_IMMEDIATE_REQUEST_STATUSES
+    if preset == "balanced":
+        return status_code in BALANCED_IMMEDIATE_REQUEST_STATUSES
+    return False
+
+
+def _is_request_anomaly_candidate_status(status_code: int | None, preset: str) -> bool:
+    if status_code is None or status_code < 400 or status_code >= 500:
+        return False
+    if preset == "investigative":
+        return status_code in INVESTIGATIVE_ANOMALY_STATUSES
+    if preset == "balanced":
+        return status_code in BALANCED_STANDARD_ANOMALY_STATUSES or status_code in BALANCED_HIGH_VOLUME_ANOMALY_STATUSES
+    return False
+
+
 def _time_now() -> float:
     return datetime.now(tz=timezone.utc).timestamp()
 

{debugbundle_python-0.1.1 → debugbundle_python-0.1.3}/src/debugbundle_python.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: debugbundle-python
-Version: 0.1.1
+Version: 0.1.3
 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.1 → debugbundle_python-0.1.3}/tests/test_remote_config.py

@@ -226,4 +226,88 @@ def test_capture_policy_filters_logs_and_request_events_from_remote_config() ->
     events = _events(transport)
     assert [event["event_type"] for event in events] == ["log_event", "request_event"]
     assert events[0]["payload"]["message"] == "error kept"
-    assert events[1]["payload"]["response_status"] == 503
+    assert events[1]["payload"]["response_status"] == 503
+
+
+def test_balanced_capture_policy_keeps_request_failure_anomaly_candidates() -> None:
+    clock = ManualClock()
+    fetch = FakeFetch(
+        responses=[
+            FakeConfigResponse(
+                200,
+                {
+                    "probes_enabled": True,
+                    "remote_probes_enabled": True,
+                    "active_probes": [],
+                    "poll_interval_ms": 15000,
+                    "capture_policy": {
+                        "preset": "balanced",
+                        "capture_logs": "warning",
+                        "capture_request_events": "failures_only",
+                        "capture_breadcrumbs": "exception_only",
+                        "capture_probe_events": "buffer_only",
+                    },
+                },
+            )
+        ]
+    )
+    transport = FakeTransport()
+    sdk = DebugBundleSdk(transport=transport, time_provider=clock.time)
+    sdk.init(
+        project_token="dbundle_proj_test",
+        service="checkout-api",
+        environment="production",
+        fetch_impl=fetch,
+    )
+
+    sdk.capture_request({"method": "POST", "path": "/checkout", "headers": {}}, {"status_code": 429})
+    sdk.capture_request({"method": "POST", "path": "/checkout", "headers": {}}, {"status_code": 404})
+    sdk.capture_request({"method": "POST", "path": "/checkout", "headers": {}}, {"status_code": 409})
+    sdk.flush()
+
+    events = _events(transport)
+    request_statuses = [
+        event["payload"]["response_status"]
+        for event in events
+        if event["event_type"] == "request_event"
+    ]
+    assert request_statuses == [429, 404, 409]
+
+
+def test_investigative_capture_policy_promotes_409_even_when_request_capture_is_off() -> None:
+    clock = ManualClock()
+    fetch = FakeFetch(
+        responses=[
+            FakeConfigResponse(
+                200,
+                {
+                    "probes_enabled": True,
+                    "remote_probes_enabled": True,
+                    "active_probes": [],
+                    "poll_interval_ms": 15000,
+                    "capture_policy": {
+                        "preset": "investigative",
+                        "capture_logs": "info",
+                        "capture_request_events": "off",
+                        "capture_breadcrumbs": "standalone",
+                        "capture_probe_events": "standalone_when_activated",
+                    },
+                },
+            )
+        ]
+    )
+    transport = FakeTransport()
+    sdk = DebugBundleSdk(transport=transport, time_provider=clock.time)
+    sdk.init(
+        project_token="dbundle_proj_test",
+        service="checkout-api",
+        environment="production",
+        fetch_impl=fetch,
+    )
+
+    sdk.capture_request({"method": "POST", "path": "/checkout", "headers": {}}, {"status_code": 409})
+    sdk.capture_request({"method": "POST", "path": "/checkout", "headers": {}}, {"status_code": 404})
+    sdk.flush()
+
+    events = _events(transport)
+    assert [event["payload"]["response_status"] for event in events if event["event_type"] == "request_event"] == [409]

{debugbundle_python-0.1.1 → debugbundle_python-0.1.3}/tests/test_sdk.py

@@ -1,6 +1,7 @@
 from __future__ import annotations
 
 import platform
+import sys
 import uuid
 from dataclasses import dataclass
 
@@ -234,7 +235,18 @@ def test_emits_contract_compliant_event_envelopes() -> None:
     assert exception_event["payload"]["handled"] is True
     assert exception_event["payload"]["request"]["path"] == "/checkout"
     assert exception_event["payload"]["response"]["status_code"] == 500
-    assert exception_event["payload"]["runtime"] == {"version": platform.python_version()}
+    runtime = exception_event["payload"]["runtime"]
+    assert runtime["version"] == platform.python_version()
+    assert runtime["platform"] == sys.platform
+    assert isinstance(runtime["arch"], str)
+    assert isinstance(runtime["pid"], int)
+    assert isinstance(runtime["cwd"], str)
+    assert isinstance(runtime["uptime_sec"], (int, float))
+    assert runtime["uptime_sec"] >= 0
+    assert isinstance(runtime["hostname"], str)
+    assert isinstance(runtime["thread_id"], int)
+    assert isinstance(runtime["memory"], dict)
+    assert "environment" not in runtime
 
 
 def test_suppresses_duplicate_exceptions_after_the_first_three() -> None: