httpware 0.15.2__tar.gz → 0.16.1__tar.gz

{httpware-0.15.2 → httpware-0.16.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: httpware
-Version: 0.15.2
+Version: 0.16.1
 Summary: Python HTTP client framework with sync & async clients and built-in resilience
 Keywords: http-client,httpx,async,asyncio,resilience,retry,circuit-breaker,bulkhead,middleware,pydantic,msgspec,python
 Author: Artur Shiriev
@@ -12,6 +12,7 @@ Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: Free Threading :: 2 - Beta
 Classifier: Typing :: Typed
 Classifier: Topic :: Software Development :: Libraries
 Classifier: Topic :: Internet :: WWW/HTTP
@@ -119,7 +120,7 @@ Full guides live at **[httpware.modern-python.org](https://httpware.modern-pytho
 - **[Testing](https://httpware.modern-python.org/testing/)** — `httpx2.MockTransport` injection.
 - **[Recipes](https://httpware.modern-python.org/recipes/modern-di/)** — DI wiring, phase-decorator patterns, link-header pagination.
 
-## 🗒️ [Release notes](https://github.com/modern-python/httpware/releases) · 📦 [PyPI](https://pypi.org/project/httpware) · 📝 [License](LICENSE)
+## 🗒️ [Release notes](https://github.com/modern-python/httpware/releases) · 📦 [PyPI](https://pypi.org/project/httpware) · 📝 [License](https://github.com/modern-python/httpware/blob/main/LICENSE)
 
 ## Part of `modern-python`
 

{httpware-0.15.2 → httpware-0.16.1}/README.md

@@ -84,7 +84,7 @@ Full guides live at **[httpware.modern-python.org](https://httpware.modern-pytho
 - **[Testing](https://httpware.modern-python.org/testing/)** — `httpx2.MockTransport` injection.
 - **[Recipes](https://httpware.modern-python.org/recipes/modern-di/)** — DI wiring, phase-decorator patterns, link-header pagination.
 
-## 🗒️ [Release notes](https://github.com/modern-python/httpware/releases) · 📦 [PyPI](https://pypi.org/project/httpware) · 📝 [License](LICENSE)
+## 🗒️ [Release notes](https://github.com/modern-python/httpware/releases) · 📦 [PyPI](https://pypi.org/project/httpware) · 📝 [License](https://github.com/modern-python/httpware/blob/main/LICENSE)
 
 ## Part of `modern-python`
 

httpware-0.16.1/pyproject.toml

@@ -0,0 +1,126 @@
+[project]
+name = "httpware"
+description = "Python HTTP client framework with sync & async clients and built-in resilience"
+requires-python = ">=3.11,<4"
+license = "MIT"
+readme = "README.md"
+keywords = [
+    "http-client",
+    "httpx",
+    "async",
+    "asyncio",
+    "resilience",
+    "retry",
+    "circuit-breaker",
+    "bulkhead",
+    "middleware",
+    "pydantic",
+    "msgspec",
+    "python",
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Programming Language :: Python :: Free Threading :: 2 - Beta",
+    "Typing :: Typed",
+    "Topic :: Software Development :: Libraries",
+    "Topic :: Internet :: WWW/HTTP",
+    "Framework :: AsyncIO",
+]
+version = "0.16.1"
+dependencies = ["httpx2>=2.0.0,<3.0"]
+
+[[project.authors]]
+name = "Artur Shiriev"
+email = "me@shiriev.ru"
+
+[project.optional-dependencies]
+pydantic = ["pydantic>=2.0,<3.0"]
+msgspec = ["msgspec>=0.18"]
+otel = ["opentelemetry-api>=1.20"]
+all = ["httpware[pydantic,msgspec,otel]"]
+
+[project.urls]
+Homepage = "https://httpware.modern-python.org"
+Documentation = "https://httpware.modern-python.org"
+Repository = "https://github.com/modern-python/httpware"
+Issues = "https://github.com/modern-python/httpware/issues"
+Changelog = "https://github.com/modern-python/httpware/releases"
+
+[build-system]
+requires = ["uv_build>=0.11,<1.0"]
+build-backend = "uv_build"
+
+[tool.uv.build-backend]
+module-name = "httpware"
+module-root = "src"
+
+[tool.ruff]
+fix = true
+unsafe-fixes = true
+line-length = 120
+
+[tool.ruff.lint]
+select = ["ALL"]
+ignore = [
+    "D1",
+    "D203",
+    "D213",
+    "COM812",
+    "ISC001",
+    "CPY001",
+    "FBT",
+    "TCH",
+]
+
+[tool.ruff.lint.isort]
+lines-after-imports = 2
+no-lines-before = [
+    "standard-library",
+    "local-folder",
+]
+
+[tool.ruff.lint.per-file-ignores]
+"src/httpware/client.py" = [
+    "ASYNC109",
+    "ANN401",
+]
+"tests/**" = ["S101"]
+
+[tool.pytest.ini_options]
+addopts = ""
+asyncio_mode = "auto"
+pythonpath = ["src"]
+asyncio_default_fixture_loop_scope = "function"
+markers = ["stress: concurrency stress test; proves thread-safety under free-threaded CPython (3.14t). Runs under the GIL too, so it counts toward coverage."]
+
+[tool.coverage.run]
+concurrency = ["thread"]
+omit = ["benchmarks/*"]
+
+[tool.coverage.report]
+exclude_also = [
+    "if typing.TYPE_CHECKING:",
+    'pytest\.fail\(',
+]
+fail_under = 100
+
+[dependency-groups]
+dev = [
+    "pytest",
+    "pytest-cov",
+    "pytest-asyncio",
+    "pytest-repeat",
+    "pytest-benchmark",
+    "hypothesis",
+]
+lint = [
+    "ruff",
+    "ty",
+    "eof-fixer",
+    "typing-extensions",
+]

httpware-0.15.2/pyproject.toml → httpware-0.16.1/pyproject.toml.orig

@@ -26,12 +26,13 @@ classifiers = [
     "Programming Language :: Python :: 3.12",
     "Programming Language :: Python :: 3.13",
     "Programming Language :: Python :: 3.14",
+    "Programming Language :: Python :: Free Threading :: 2 - Beta",
     "Typing :: Typed",
     "Topic :: Software Development :: Libraries",
     "Topic :: Internet :: WWW/HTTP",
     "Framework :: AsyncIO",
 ]
-version = "0.15.2"
+version = "0.16.1"
 dependencies = [
     "httpx2>=2.0.0,<3.0",
 ]
@@ -77,32 +78,37 @@ lint = [
 fix = true
 unsafe-fixes = true
 line-length = 120
-target-version = "py311"
 
 [tool.ruff.lint]
 select = ["ALL"]
 ignore = [
-    "D1",     # allow missing docstrings
-    "S101",   # allow asserts
-    "TCH",    # ignore flake8-type-checking
-    "FBT",    # allow boolean args
-    "D203",   # "one-blank-line-before-class" conflicting with D211
-    "D213",   # "multi-line-summary-second-line" conflicting with D212
-    "COM812", # flake8-commas "Trailing comma missing"
-    "ISC001", # flake8-implicit-str-concat
+    "D1",     # docstrings are not forced; a docstring exists when it says something
+    "D203",   # conflicts with D211
+    "D213",   # conflicts with D212
+    "COM812", # conflicts with the formatter
+    "ISC001", # conflicts with the formatter
+    "CPY001", # no per-file copyright header
+    "FBT",    # boolean positional arguments are fine
+    "TCH",    # imports stay real; TYPE_CHECKING-only imports break runtime introspection
 ]
 isort.lines-after-imports = 2
 isort.no-lines-before = ["standard-library", "local-folder"]
 
 [tool.ruff.lint.per-file-ignores]
 "src/httpware/client.py" = ["ASYNC109", "ANN401"]
+"tests/**" = ["S101"]
 
 [tool.pytest.ini_options]
-addopts = "--cov=. --cov-report term-missing --cov-fail-under=100"
+addopts = ""
 asyncio_mode = "auto"
 pythonpath = ["src"]
 asyncio_default_fixture_loop_scope = "function"
+markers = [
+    "stress: concurrency stress test; proves thread-safety under free-threaded CPython (3.14t). Runs under the GIL too, so it counts toward coverage.",
+]
 
 [tool.coverage]
 run.concurrency = ["thread"]
+run.omit = ["benchmarks/*"]
 report.exclude_also = ["if typing.TYPE_CHECKING:", 'pytest\.fail\(']
+report.fail_under = 100

{httpware-0.15.2 → httpware-0.16.1}/src/httpware/_internal/observability.py

@@ -1,7 +1,5 @@
 """Observability emission helper — structured logging + opt-in OpenTelemetry span events.
 
-See architecture/resilience.md (Observability section) for the contract.
-
 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

{httpware-0.15.2 → httpware-0.16.1}/src/httpware/client.py

@@ -1035,7 +1035,8 @@ class AsyncClient:
         is closed when the context exits.
 
         Bypasses the middleware chain (no AsyncRetry, no AsyncBulkhead, no user-installed
-        middleware) — see architecture/client.md for the contract.
+        middleware): the protocol is typed on a fully-buffered response, and reading it
+        would consume the stream.
 
         Auto-raises StatusError subclasses on 4xx/5xx (NotFoundError,
         ServiceUnavailableError, etc.) — consistent with client.get()/post()/etc.

{httpware-0.15.2 → httpware-0.16.1}/src/httpware/decoders/_resolver.py

@@ -8,7 +8,7 @@ client calls `resolve` before `_dispatch` — so a missing decoder fails before
 the request goes out — and `_BoundDecoder.decode` after the response arrives.
 
 Both clients hold one `_DecoderResolver`; it is fully synchronous, so there is
-no sync/async split. See architecture/decoders.md for the full Seam B contract.
+no sync/async split.
 """
 
 from typing import Generic, TypeVar

{httpware-0.15.2 → httpware-0.16.1}/src/httpware/middleware/resilience/_event_loop_guard.py

@@ -30,8 +30,8 @@ def check_event_loop(
         cached = get_loop()
         if cached is None:
             set_loop(current)
-        # pragma below: inner double-check-with-lock race arm; only reachable when
-        # two threads simultaneously pass the outer check, which single-threaded
-        # tests can't trigger.
+        # pragma below: inner double-check-with-lock race arm. Reachable only when two
+        # threads pass the outer check and race for loop_lock — free-threaded CPython can
+        # reach it, but only nondeterministically, so it stays excluded from coverage.
         elif cached is not current:  # pragma: no cover
             raise RuntimeError(message_template.format(first=cached, current=current))

{httpware-0.15.2 → httpware-0.16.1}/src/httpware/middleware/resilience/budget.py

@@ -1,7 +1,5 @@
 """Finagle-style token-bucket retry budget.
 
-See architecture/resilience.md (Retry + RetryBudget section) for the contract.
-
 Thread-safe and asyncio-safe: all mutations go through a threading.Lock,
 which ensures no torn state across concurrent accesses. When a RetryBudget
 is shared between a sync Client (pool thread) and an AsyncClient (event-loop

{httpware-0.15.2 → httpware-0.16.1}/src/httpware/middleware/resilience/bulkhead.py

@@ -1,7 +1,5 @@
 """AsyncBulkhead middleware — concurrency limiter via asyncio.Semaphore.
 
-See architecture/resilience.md (Bulkhead section) for the contract.
-
 The middleware owns an asyncio.Semaphore(max_concurrent). On each request,
 it acquires a slot (bounded by acquire_timeout via asyncio.timeout) and
 releases the slot in a try/finally so success, exceptions, and cancellation

{httpware-0.15.2 → httpware-0.16.1}/src/httpware/middleware/resilience/circuit_breaker.py

@@ -1,7 +1,5 @@
 """CircuitBreaker + AsyncCircuitBreaker — consecutive-failure and failure-rate circuit breakers.
 
-See architecture/resilience.md (CircuitBreaker + AsyncTimeout section) for the contract.
-
 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

{httpware-0.15.2 → httpware-0.16.1}/src/httpware/middleware/resilience/retry.py

@@ -1,7 +1,5 @@
 """AsyncRetry + Retry middleware — automatic retry of transient failures with budget control.
 
-See architecture/resilience.md (Retry + RetryBudget section) for the full contract.
-
 Status-code retry: the client terminal raises StatusError subclasses on 4xx/5xx,
 so the retry middleware catches StatusError and inspects exc.response.status_code. The
 original StatusError subclass is re-raised unwrapped on exhaustion, with a PEP 678 note