httpware 0.10.0__tar.gz → 0.10.1__tar.gz

{httpware-0.10.0 → httpware-0.10.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: httpware
-Version: 0.10.0
+Version: 0.10.1
 Summary: Resilience-first async HTTP client framework for Python
 Keywords: http,async,client,resilience,retry,circuit-breaker,middleware,httpx,pydantic
 Author: Artur Shiriev
@@ -142,7 +142,7 @@ It does NOT pass through the middleware chain: `AsyncRetry`, `AsyncBulkhead`, an
 
 ## Errors
 
-All 4xx/5xx responses raise typed exceptions automatically: `NotFoundError`, `ServiceUnavailableError`, `RateLimitedError`, etc. — all subclasses of `httpware.StatusError`. Transport-layer transient failures raise `NetworkError`; the resilience middleware raise `RetryBudgetExhaustedError` and `BulkheadFullError`. Everything inherits `httpware.ClientError`.
+All 4xx/5xx responses raise typed exceptions automatically: `NotFoundError`, `ServiceUnavailableError`, `RateLimitedError`, etc. — all subclasses of `httpware.StatusError`. Transport-layer transient failures raise `NetworkError`; the resilience middleware raise `RetryBudgetExhaustedError`, `BulkheadFullError`, and `CircuitOpenError`. Everything inherits `httpware.ClientError`.
 
 ## Observability
 
@@ -156,7 +156,7 @@ import logging
 # Enable visibility into resilience operational events
 logging.getLogger("httpware.retry").setLevel(logging.WARNING)
 logging.getLogger("httpware.bulkhead").setLevel(logging.WARNING)
-logging.getLogger("httpware.circuit_breaker").setLevel(logging.WARNING)
+logging.getLogger("httpware.circuit_breaker").setLevel(logging.INFO)   # INFO: includes recovery events (half_open, closed)
 logging.getLogger("httpware.timeout").setLevel(logging.WARNING)
 ```
 

{httpware-0.10.0 → httpware-0.10.1}/README.md

@@ -112,7 +112,7 @@ It does NOT pass through the middleware chain: `AsyncRetry`, `AsyncBulkhead`, an
 
 ## Errors
 
-All 4xx/5xx responses raise typed exceptions automatically: `NotFoundError`, `ServiceUnavailableError`, `RateLimitedError`, etc. — all subclasses of `httpware.StatusError`. Transport-layer transient failures raise `NetworkError`; the resilience middleware raise `RetryBudgetExhaustedError` and `BulkheadFullError`. Everything inherits `httpware.ClientError`.
+All 4xx/5xx responses raise typed exceptions automatically: `NotFoundError`, `ServiceUnavailableError`, `RateLimitedError`, etc. — all subclasses of `httpware.StatusError`. Transport-layer transient failures raise `NetworkError`; the resilience middleware raise `RetryBudgetExhaustedError`, `BulkheadFullError`, and `CircuitOpenError`. Everything inherits `httpware.ClientError`.
 
 ## Observability
 
@@ -126,7 +126,7 @@ import logging
 # Enable visibility into resilience operational events
 logging.getLogger("httpware.retry").setLevel(logging.WARNING)
 logging.getLogger("httpware.bulkhead").setLevel(logging.WARNING)
-logging.getLogger("httpware.circuit_breaker").setLevel(logging.WARNING)
+logging.getLogger("httpware.circuit_breaker").setLevel(logging.INFO)   # INFO: includes recovery events (half_open, closed)
 logging.getLogger("httpware.timeout").setLevel(logging.WARNING)
 ```
 

{httpware-0.10.0 → httpware-0.10.1}/pyproject.toml

@@ -26,7 +26,7 @@ classifiers = [
     "Topic :: Internet :: WWW/HTTP",
     "Framework :: AsyncIO",
 ]
-version = "0.10.0"
+version = "0.10.1"
 dependencies = [
     "httpx2>=2.0.0,<3.0",
 ]

{httpware-0.10.0 → httpware-0.10.1}/src/httpware/_internal/observability.py

@@ -2,11 +2,13 @@
 
 See planning/specs/2026-06-05-observability-design.md for the contract.
 
-Logger names (``httpware.retry``, ``httpware.bulkhead``) and event names
-(``retry.giving_up``, ``bulkhead.rejected``, etc.) are the public observability
+Logger names (``httpware.retry``, ``httpware.bulkhead``, ``httpware.circuit_breaker``,
+``httpware.timeout``) and event names (``retry.giving_up``, ``bulkhead.rejected``,
+``circuit.opened``, ``timeout.exceeded``, etc.) are the public observability
 surface. They are stable: renames are breaking changes.
 """
 
+import contextlib
 import logging
 import typing
 
@@ -37,7 +39,7 @@ def _emit_event(
     the optional-extras isolation invariant: ``import httpware`` must not pull
     ``opentelemetry`` into ``sys.modules`` when the extra is absent.
     """
-    logger.log(level, message, extra=attributes)
+    logger.log(level, message, extra={**attributes, "event": event_name})
     if import_checker.is_otel_installed:
         try:
             from opentelemetry import trace  # noqa: PLC0415 — lazy by design (optional-extras isolation)
@@ -45,4 +47,9 @@ def _emit_event(
             # opentelemetry namespace exists but the api package is broken or missing —
             # degrade to log-only emission. The structured log record above has already fired.
             return
-        trace.get_current_span().add_event(event_name, attributes=attributes)
+        # Observability must never break the request path — suppress any failure from
+        # add_event (e.g. a recording span with a broken exporter or attribute validation).
+        # The structured log record above has already fired; CancelledError/KeyboardInterrupt
+        # are not Exception subclasses and will still propagate.
+        with contextlib.suppress(Exception):
+            trace.get_current_span().add_event(event_name, attributes=attributes)

{httpware-0.10.0 → httpware-0.10.1}/src/httpware/middleware/resilience/circuit_breaker.py

@@ -5,7 +5,10 @@ See planning/specs/2026-06-13-circuit-breaker-and-timeout-design.md for the cont
 A counted failure is a NetworkError, an httpware TimeoutError, or a StatusError whose
 status_code is in the effective failure set (default: all 5xx). 4xx — including 429 —
 count as successes: 429 means healthy-but-throttling, and tripping on it amplifies
-incidents. Any other exception propagates without affecting circuit state.
+incidents. Any other exception propagates without affecting circuit state. In
+particular, non-NetworkError transport problems — e.g. httpx2.InvalidURL from a
+malformed URL — are foreign: they propagate unchanged and do not increment the
+failure counter, so programming errors cannot trip the breaker.
 
 State machine (classic / consecutive-failure):
     CLOSED    — forward; count consecutive counted-failures; open at failure_threshold.

{httpware-0.10.0 → httpware-0.10.1}/src/httpware/middleware/resilience/timeout.py

@@ -14,6 +14,7 @@ timeouts. Sync callers configure httpx2's timeouts directly; there is no sync Ti
 
 import asyncio
 import logging
+import math
 
 import httpx2
 
@@ -22,7 +23,7 @@ from httpware.errors import TimeoutError as HttpwareTimeoutError
 from httpware.middleware import AsyncNext
 
 
-_TIMEOUT_INVALID = "timeout must be > 0"
+_TIMEOUT_INVALID = "timeout must be a finite number > 0"
 
 _LOGGER = logging.getLogger("httpware.timeout")
 
@@ -43,7 +44,7 @@ class AsyncTimeout:
     """
 
     def __init__(self, *, timeout: float) -> None:
-        if timeout <= 0:
+        if not math.isfinite(timeout) or timeout <= 0:
             raise ValueError(_TIMEOUT_INVALID)
         self._timeout = timeout