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

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

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

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

{debugbundle_python-0.1.1 → 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()
@@ -699,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.1 → 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.1
+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.1 → 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: