httpware 0.8.3__tar.gz → 0.8.4__tar.gz

{httpware-0.8.3 → httpware-0.8.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: httpware
-Version: 0.8.3
+Version: 0.8.4
 Summary: Resilience-first async HTTP client framework for Python
 Keywords: http,async,client,resilience,retry,circuit-breaker,middleware,httpx,pydantic
 Author: Artur Shiriev

{httpware-0.8.3 → httpware-0.8.4}/pyproject.toml

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

httpware-0.8.4/src/httpware/_internal/import_checker.py

@@ -0,0 +1,26 @@
+"""Detect optional extras without importing them. Used by adapter modules to gate hard imports."""
+
+from importlib.metadata import PackageNotFoundError, distribution
+from importlib.util import find_spec
+
+
+def _is_distribution_installed(name: str) -> bool:
+    """Probe the package registry for a distribution by name. No sys.modules side effects."""
+    try:
+        distribution(name)
+    except PackageNotFoundError:
+        return False
+    return True
+
+
+is_msgspec_installed = find_spec("msgspec") is not None
+is_pydantic_installed = find_spec("pydantic") is not None
+# opentelemetry/ is a PEP 420 namespace package — instrumentation packages create the
+# directory even without opentelemetry-api. find_spec("opentelemetry") therefore returns
+# non-None regardless of whether the api package is present, and
+# find_spec("opentelemetry.trace") populates sys.modules with the namespace parent as a
+# CPython side-effect, breaking the isolation guarantee.
+# importlib.metadata.distribution probes the package registry instead: it returns the
+# distribution when opentelemetry-api is installed and raises PackageNotFoundError when
+# it is absent, with no sys.modules side effects.
+is_otel_installed = _is_distribution_installed("opentelemetry-api")

{httpware-0.8.3 → httpware-0.8.4}/src/httpware/_internal/observability.py

@@ -29,7 +29,9 @@ def _emit_event(
        ``trace.get_current_span().add_event(event_name, attributes=attributes)``.
        When no tracer is active, ``get_current_span()`` returns a ``NonRecordingSpan``
        whose ``add_event`` is a documented no-op — so the call is unconditional
-       behind the install gate.
+       behind the install gate. If the install gate is wrong (the namespace exists
+       but the api package is missing or broken), the lazy import raises
+       ``ImportError``; we degrade silently to log-only emission.
 
     The lazy ``from opentelemetry import trace`` inside the if-block preserves
     the optional-extras isolation invariant: ``import httpware`` must not pull
@@ -37,6 +39,10 @@ def _emit_event(
     """
     logger.log(level, message, extra=attributes)
     if import_checker.is_otel_installed:
-        from opentelemetry import trace  # noqa: PLC0415 — lazy by design (optional-extras isolation)
-
+        try:
+            from opentelemetry import trace  # noqa: PLC0415 — lazy by design (optional-extras isolation)
+        except ImportError:
+            # 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)

httpware-0.8.3/src/httpware/_internal/import_checker.py

@@ -1,8 +0,0 @@
-"""Detect optional extras without importing them. Used by adapter modules to gate hard imports."""
-
-from importlib.util import find_spec
-
-
-is_msgspec_installed = find_spec("msgspec") is not None
-is_pydantic_installed = find_spec("pydantic") is not None
-is_otel_installed = find_spec("opentelemetry") is not None