debugbundle-python 1.0.0__py3-none-any.whl → 1.1.2__py3-none-any.whl

debugbundle/config.py

@@ -6,6 +6,13 @@ from typing import Any
 DEFAULT_PROBES_POLL_INTERVAL_MS = 60_000
 
 
+@dataclass(frozen=True)
+class ImmediateClientErrorPathRule:
+    status_code: int
+    path_pattern: str
+    methods: tuple[str, ...]
+
+
 @dataclass(frozen=True)
 class CapturePolicy:
     preset: str
@@ -14,6 +21,7 @@ class CapturePolicy:
     capture_breadcrumbs: str
     capture_probe_events: str
     immediate_client_error_statuses: tuple[int, ...]
+    immediate_client_error_path_rules: tuple[ImmediateClientErrorPathRule, ...] = ()
 
 
 @dataclass(frozen=True)
@@ -42,6 +50,7 @@ BALANCED_CAPTURE_POLICY = CapturePolicy(
     capture_breadcrumbs="exception_only",
     capture_probe_events="buffer_only",
     immediate_client_error_statuses=(),
+    immediate_client_error_path_rules=(),
 )
 
 MINIMAL_CAPTURE_POLICY = CapturePolicy(
@@ -51,6 +60,7 @@ MINIMAL_CAPTURE_POLICY = CapturePolicy(
     capture_breadcrumbs="local_only",
     capture_probe_events="buffer_only",
     immediate_client_error_statuses=(),
+    immediate_client_error_path_rules=(),
 )
 
 
@@ -123,6 +133,9 @@ def _parse_capture_policy(payload: object) -> CapturePolicy | None:
     immediate_client_error_statuses = _parse_immediate_client_error_statuses(
         payload.get("immediate_client_error_statuses")
     )
+    immediate_client_error_path_rules = _parse_immediate_client_error_path_rules(
+        payload.get("immediate_client_error_path_rules")
+    )
 
     if capture_logs not in {"off", "error", "warning", "info"}:
         return None
@@ -132,7 +145,7 @@ def _parse_capture_policy(payload: object) -> CapturePolicy | None:
         return None
     if capture_probe_events not in {"buffer_only", "standalone_when_activated"}:
         return None
-    if immediate_client_error_statuses is None:
+    if immediate_client_error_statuses is None or immediate_client_error_path_rules is None:
         return None
 
     return CapturePolicy(
@@ -142,6 +155,7 @@ def _parse_capture_policy(payload: object) -> CapturePolicy | None:
         capture_breadcrumbs=capture_breadcrumbs,
         capture_probe_events=capture_probe_events,
         immediate_client_error_statuses=immediate_client_error_statuses,
+        immediate_client_error_path_rules=immediate_client_error_path_rules,
     )
 
 
@@ -160,6 +174,56 @@ def _parse_immediate_client_error_statuses(value: object) -> tuple[int, ...] | N
     return tuple(sorted(set(statuses)))
 
 
+def _parse_immediate_client_error_path_rules(value: object) -> tuple[ImmediateClientErrorPathRule, ...] | None:
+    if value is None:
+        return ()
+    if not isinstance(value, list) or len(value) > 25:
+        return None
+
+    rules: list[ImmediateClientErrorPathRule] = []
+    for item in value:
+        if not isinstance(item, dict):
+            return None
+        status_code = item.get("status_code")
+        path_pattern = item.get("path_pattern")
+        raw_methods = item.get("methods", [])
+        if (
+            not isinstance(status_code, int)
+            or isinstance(status_code, bool)
+            or status_code < 400
+            or status_code > 499
+            or not isinstance(path_pattern, str)
+            or not _is_valid_path_pattern(path_pattern)
+            or not isinstance(raw_methods, list)
+            or len(raw_methods) > 7
+        ):
+            return None
+
+        methods: list[str] = []
+        for raw_method in raw_methods:
+            method = raw_method.upper() if isinstance(raw_method, str) else ""
+            if method not in {"GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS"}:
+                return None
+            if method not in methods:
+                methods.append(method)
+        rules.append(
+            ImmediateClientErrorPathRule(
+                status_code=status_code,
+                path_pattern=path_pattern,
+                methods=tuple(methods),
+            )
+        )
+
+    return tuple(rules)
+
+
+def _is_valid_path_pattern(value: str) -> bool:
+    if not value.startswith("/") or len(value) == 0 or len(value) > 256 or "?" in value or "#" in value:
+        return False
+    wildcard_index = value.find("*")
+    return wildcard_index == -1 or wildcard_index == len(value) - 1
+
+
 def _parse_directive(payload: object) -> RemoteProbeDirective | None:
     if not isinstance(payload, dict):
         return None

debugbundle/core.py

@@ -55,9 +55,6 @@ LEVEL_RANKS = {
 }
 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
@@ -286,7 +283,12 @@ class DebugBundleSdk:
         context: Mapping[str, object] | None = None,
     ) -> None:
         with self._lock:
-            if not self._enabled or not self._passes_sample_rate() or not self._should_capture_request_event(response):
+            should_capture = (
+                self._enabled
+                and self._passes_sample_rate()
+                and self._should_capture_request_event(request, response)
+            )
+            if not should_capture:
                 return
             payload = _request_event_payload(
                 _redact_mapping(dict(request), self._redact_fields),
@@ -526,23 +528,27 @@ class DebugBundleSdk:
         payload: dict[str, object],
         context: Mapping[str, object] | None = None,
     ) -> dict[str, object]:
-        return {
+        merged_context = self._merged_context(context)
+        event: dict[str, object] = {
             "schema_version": SCHEMA_VERSION,
             "event_id": str(uuid.uuid4()),
             "event_type": event_type,
             "occurred_at": _iso_now(self._time_provider),
             "sdk_name": "debugbundle-python",
             "sdk_version": _sdk_version(),
-            "sdk_language": "python",
             "service": {
                 "name": self._service,
                 "runtime": "python",
                 "framework": None,
                 "environment": self._environment,
             },
-            "correlation": _correlation_payload(self._merged_context(context)),
+            "correlation": _correlation_payload(merged_context),
             "payload": payload,
         }
+        envelope_context = _event_context(merged_context)
+        if envelope_context:
+            event["context"] = envelope_context
+        return event
 
     def _merged_context(self, context: Mapping[str, object] | None = None) -> dict[str, object]:
         merged = dict(self._context)
@@ -602,17 +608,31 @@ class DebugBundleSdk:
         policy_threshold = self._capture_policy.capture_logs
         return self._log_level if LEVEL_RANKS[self._log_level] >= LEVEL_RANKS[policy_threshold] else policy_threshold
 
-    def _should_capture_request_event(self, response: Mapping[str, object] | None) -> bool:
+    def _should_capture_request_event(
+        self,
+        request: Mapping[str, object] | None,
+        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
+        request_path = None
+        http_method = None
+        if request is not None:
+            path_candidate = request.get("path") or request.get("url")
+            method_candidate = request.get("method")
+            request_path = path_candidate if isinstance(path_candidate, str) else None
+            http_method = method_candidate if isinstance(method_candidate, str) else None
         if _is_immediate_request_incident_status(
             status_code,
             self._capture_policy.preset,
             self._capture_policy.immediate_client_error_statuses,
+            request_path,
+            http_method,
+            self._capture_policy.immediate_client_error_path_rules,
         ):
             return True
         if policy == "off":
@@ -624,7 +644,7 @@ class DebugBundleSdk:
         if status_code is None:
             return policy == "filtered"
         if policy == "failures_only":
-            return _is_request_anomaly_candidate_status(status_code, self._capture_policy.preset)
+            return status_code >= 500
         if policy == "filtered":
             return False
         return True
@@ -845,6 +865,14 @@ def _correlation_payload(context: Mapping[str, object]) -> dict[str, str | None]
     }
 
 
+def _event_context(context: Mapping[str, object]) -> dict[str, object]:
+    return {
+        str(key): value
+        for key, value in context.items()
+        if key not in {"request", "response", "correlation", "request_id", "trace_id", "session_id", "user_id_hash"}
+    }
+
+
 def _coerce_optional_string(value: object) -> str | None:
     if value is None:
         return None
@@ -859,6 +887,9 @@ def _is_immediate_request_incident_status(
     status_code: int | None,
     preset: str,
     immediate_client_error_statuses: tuple[int, ...],
+    request_path: str | None = None,
+    http_method: str | None = None,
+    immediate_client_error_path_rules: tuple[object, ...] = (),
 ) -> bool:
     if status_code is None:
         return False
@@ -866,6 +897,13 @@ def _is_immediate_request_incident_status(
         return True
     if status_code in immediate_client_error_statuses:
         return True
+    if _matches_immediate_client_error_path_rule(
+        status_code,
+        request_path,
+        http_method,
+        immediate_client_error_path_rules,
+    ):
+        return True
     if preset == "investigative":
         return status_code in INVESTIGATIVE_IMMEDIATE_REQUEST_STATUSES
     if preset == "balanced":
@@ -873,16 +911,41 @@ def _is_immediate_request_incident_status(
     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:
+def _matches_immediate_client_error_path_rule(
+    status_code: int,
+    request_path: str | None,
+    http_method: str | None,
+    rules: tuple[object, ...],
+) -> bool:
+    if status_code < 400 or status_code > 499 or request_path is None:
         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
+    normalized_path = _normalize_request_path(request_path)
+    normalized_method = http_method.upper() if isinstance(http_method, str) else None
+    for rule in rules:
+        rule_status = getattr(rule, "status_code", None)
+        path_pattern = getattr(rule, "path_pattern", None)
+        methods = getattr(rule, "methods", ())
+        if rule_status != status_code or not isinstance(path_pattern, str):
+            continue
+        if methods and (normalized_method is None or normalized_method not in methods):
+            continue
+        if path_pattern.endswith("*"):
+            if normalized_path.startswith(path_pattern[:-1]):
+                return True
+        elif normalized_path == path_pattern:
+            return True
     return False
 
 
+def _normalize_request_path(value: str) -> str:
+    from urllib.parse import urlparse
+
+    parsed = urlparse(value)
+    if parsed.path:
+        return parsed.path
+    return value.split("?", 1)[0].split("#", 1)[0] if value.startswith("/") else "/"
+
+
 def _time_now() -> float:
     return datetime.now(tz=timezone.utc).timestamp()
 
@@ -891,7 +954,7 @@ def _sdk_version() -> str:
     try:
         return metadata.version("debugbundle-python")
     except metadata.PackageNotFoundError:
-        return "1.0.0"
+        return "1.1.2"
 
 
 def _sdk_config_endpoint(events_endpoint: str) -> str:

{debugbundle_python-1.0.0.dist-info → debugbundle_python-1.1.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: debugbundle-python
-Version: 1.0.0
+Version: 1.1.2
 Summary: DebugBundle SDK for Python
 Author: DebugBundle
 License-Expression: AGPL-3.0-only

{debugbundle_python-1.0.0.dist-info → debugbundle_python-1.1.2.dist-info}/RECORD

@@ -1,6 +1,6 @@
 debugbundle/__init__.py,sha256=mqibduUrdcr_fnb6k3Gwf93H7iqVBS8zd6SceX-U3Q4,5011
-debugbundle/config.py,sha256=Cty7Wkj2nIRf5bumsI-dexrvQTFwVICPKrcx6LkhU4Q,6960
-debugbundle/core.py,sha256=e3JXW7cVA1OllcTphFLJDJpQvSPOwqigjG6JsVrez88,35772
+debugbundle/config.py,sha256=ENRSR5jUI7xYdBqUakWws3GIjBk00GWFmwXVE_iQp2Y,9296
+debugbundle/core.py,sha256=wRzT4DmGRHkrsakbqHSr35b8O8yI2V9DIjEHMdqfhGo,37776
 debugbundle/logger_integrations.py,sha256=RuTNaD9RRVmiE-BBkksAXWVEGaMzLrWavVpQdgGZBpE,4564
 debugbundle/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 debugbundle/redaction.py,sha256=QTaPkSsYv54yR1mz8SB6Q4vWjvp7Ddcui4WXaH2RVz8,736
@@ -17,8 +17,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.0.0.dist-info/licenses/LICENSE,sha256=AKZZ5DQAHrOKGwt24VoRd-SXJLM9OloxlsX8ZgENdEY,735
-debugbundle_python-1.0.0.dist-info/METADATA,sha256=woRNAvpIJvyVyCbMQ54ekzmcqKpguNTBQqEZFkr8DaY,13841
-debugbundle_python-1.0.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
-debugbundle_python-1.0.0.dist-info/top_level.txt,sha256=RCB9STTFnl1OKdojxz-xhaks2zkRFs1meZXsKnm18LM,12
-debugbundle_python-1.0.0.dist-info/RECORD,,
+debugbundle_python-1.1.2.dist-info/licenses/LICENSE,sha256=AKZZ5DQAHrOKGwt24VoRd-SXJLM9OloxlsX8ZgENdEY,735
+debugbundle_python-1.1.2.dist-info/METADATA,sha256=j72wBHvKBxZZjjTkpcUrjVuLYza_T3Hcbi37hHBRFe8,13841
+debugbundle_python-1.1.2.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+debugbundle_python-1.1.2.dist-info/top_level.txt,sha256=RCB9STTFnl1OKdojxz-xhaks2zkRFs1meZXsKnm18LM,12
+debugbundle_python-1.1.2.dist-info/RECORD,,