debugbundle-python 0.1.0__tar.gz → 0.1.2__tar.gz

{debugbundle_python-0.1.0 → debugbundle_python-0.1.2}/PKG-INFO

@@ -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 → debugbundle_python-0.1.2}/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.0 → debugbundle_python-0.1.2}/pyproject.toml

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

{debugbundle_python-0.1.0 → debugbundle_python-0.1.2}/src/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_python-0.1.0 → debugbundle_python-0.1.2}/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,
@@ -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_python-0.1.0 → debugbundle_python-0.1.2}/src/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 → debugbundle_python-0.1.2}/src/debugbundle_python.egg-info/PKG-INFO

@@ -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 → debugbundle_python-0.1.2}/tests/test_framework_integrations.py

@@ -178,14 +178,14 @@ def test_django_middleware_captures_requests_logs_and_errors() -> None:
 
     factory = RequestFactory()
 
-    def ok_response(request: object) -> HttpResponse:
-        logging.getLogger("django-test").warning("django ok warning")
-        return HttpResponse("ok")
+    def server_error_response(request: object) -> HttpResponse:
+        logging.getLogger("django-test").warning("django server warning")
+        return HttpResponse("failed", status=503)
 
-    middleware = DebugBundleDjangoMiddleware(ok_response, sdk=sdk)
-    request = factory.get("/ok", HTTP_X_DEBUGBUNDLE_TRACE_ID="trace-django")
+    middleware = DebugBundleDjangoMiddleware(server_error_response, sdk=sdk)
+    request = factory.get("/failed", HTTP_X_DEBUGBUNDLE_TRACE_ID="trace-django")
     response = middleware(request)
-    assert response.status_code == 200
+    assert response.status_code == 503
 
     raising_middleware = DebugBundleDjangoMiddleware(
         lambda request: (_ for _ in ()).throw(RuntimeError("django failure")),

{debugbundle_python-0.1.0 → debugbundle_python-0.1.2}/tests/test_relay.py

@@ -166,7 +166,7 @@ def test_preserves_correlation_trace_id() -> None:
 
 def test_accepts_all_supported_event_types() -> None:
     handler = BrowserRelayHandler(allowed_origins=["https://example.com"])
-    for event_type in ("frontend_exception", "error_suppressed", "frontend_breadcrumb", "probe_event"):
+    for event_type in ("frontend_exception", "error_suppressed", "frontend_breadcrumb", "request_event", "probe_event"):
         evt = _valid_event(event_type)
         response = handler.handle(
             _make_request(body={"batch": [evt]}, ip_address=f"10.0.0.{hash(event_type) % 254 + 1}")
@@ -174,6 +174,30 @@ def test_accepts_all_supported_event_types() -> None:
         assert response.status == 202, f"Failed for event type: {event_type}"
 
 
+def test_accepts_browser_request_event_payloads() -> None:
+    accepted: list[BrowserRelayAcceptedBatch] = []
+    handler = BrowserRelayHandler(
+        allowed_origins=["https://example.com"],
+        on_accept=lambda batch: accepted.append(batch),
+    )
+    event = _valid_event("request_event")
+    event["payload"] = {
+        "method": "POST",
+        "path": "/v1/billing/checkout",
+        "query": {"plan": "team"},
+        "headers": {},
+        "response_status": 503,
+        "duration_ms": 84,
+    }
+
+    response = handler.handle(_make_request(body={"batch": [event]}))
+
+    assert response.status == 202
+    assert len(accepted) == 1
+    assert accepted[0].events[0]["event_type"] == "request_event"
+    assert accepted[0].events[0]["payload"]["response_status"] == 503
+
+
 def test_rejects_event_with_missing_required_fields() -> None:
     handler = BrowserRelayHandler(allowed_origins=["https://example.com"])
     bad_event = {"event_type": "frontend_exception"}

{debugbundle_python-0.1.0 → debugbundle_python-0.1.2}/tests/test_remote_config.py

@@ -111,8 +111,8 @@ def test_remote_config_uses_etag_and_activates_heavy_probes_only_while_directive
                     "capture_policy": {
                         "preset": "balanced",
                         "capture_logs": "warning",
-                        "capture_request_events": "all",
-                        "capture_breadcrumbs": "local_only",
+                        "capture_request_events": "failures_only",
+                        "capture_breadcrumbs": "exception_only",
                         "capture_probe_events": "standalone_when_activated",
                     },
                 },
@@ -173,14 +173,17 @@ def test_failed_init_config_fetch_falls_back_to_minimal_policy() -> None:
         probes_poll_interval=25000,
     )
 
-    sdk.capture_message("warning still allowed", level="warning")
+    sdk.capture_message("warning blocked", level="warning")
+    sdk.capture_message("error still allowed", level="error")
     sdk.capture_message("info blocked", level="info")
     sdk.capture_request({"method": "GET", "path": "/ok", "headers": {}}, {"status_code": 200})
+    sdk.capture_request({"method": "GET", "path": "/boom", "headers": {}}, {"status_code": 503})
     sdk.flush()
 
     events = _events(transport)
-    assert [event["event_type"] for event in events] == ["log_event"]
-    assert events[0]["payload"]["message"] == "warning still allowed"
+    assert [event["event_type"] for event in events] == ["log_event", "request_event"]
+    assert events[0]["payload"]["message"] == "error still allowed"
+    assert events[1]["payload"]["response_status"] == 503
 
 
 def test_capture_policy_filters_logs_and_request_events_from_remote_config() -> None:

{debugbundle_python-0.1.0 → debugbundle_python-0.1.2}/tests/test_repository_metadata.py

@@ -25,6 +25,15 @@ def test_pyproject_points_to_standalone_repository_urls() -> None:
     assert 'Issues = "https://github.com/debugbundle/debugbundle-python/issues"' in pyproject
 
 
+def test_standalone_changelog_and_security_policy_are_launch_ready() -> None:
+    changelog = (REPO_ROOT / "CHANGELOG.md").read_text(encoding="utf-8")
+    security = (REPO_ROOT / "SECURITY.md").read_text(encoding="utf-8")
+
+    assert "## [Unreleased]" in changelog
+    assert "## [0.1.0] - 2026-05-07" in changelog
+    assert "https://github.com/debugbundle/debugbundle-python/security/advisories/new" in security
+
+
 def test_standalone_ci_workflow_covers_python_sdk_checks() -> None:
     workflow = (REPO_ROOT / ".github/workflows/ci.yml").read_text(encoding="utf-8")
 

{debugbundle_python-0.1.0 → debugbundle_python-0.1.2}/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: