httpware 0.1.0__tar.gz → 0.2.0__tar.gz

{httpware-0.1.0 → httpware-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: httpware
-Version: 0.1.0
+Version: 0.2.0
 Summary: Resilience-first async HTTP client framework for Python
 Keywords: http,async,client,resilience,retry,circuit-breaker,middleware,httpx,pydantic
 Author: Artur Shiriev
@@ -16,9 +16,8 @@ Classifier: Topic :: Internet :: WWW/HTTP
 Classifier: Framework :: AsyncIO
 Requires-Dist: httpx2>=2.0.0,<3.0
 Requires-Dist: pydantic>=2.0,<3.0
-Requires-Dist: httpware[msgspec,otel,niquests] ; extra == 'all'
+Requires-Dist: httpware[msgspec,otel] ; extra == 'all'
 Requires-Dist: msgspec>=0.18 ; extra == 'msgspec'
-Requires-Dist: niquests>=3.18 ; extra == 'niquests'
 Requires-Dist: opentelemetry-api>=1.20 ; extra == 'otel'
 Requires-Dist: opentelemetry-sdk>=1.20 ; extra == 'otel'
 Requires-Python: >=3.11, <4
@@ -26,7 +25,6 @@ Project-URL: repository, https://github.com/modern-python/httpware
 Project-URL: docs, https://httpware.readthedocs.io
 Provides-Extra: all
 Provides-Extra: msgspec
-Provides-Extra: niquests
 Provides-Extra: otel
 Description-Content-Type: text/markdown
 
@@ -39,9 +37,9 @@ Description-Content-Type: text/markdown
 
 **Async HTTP client framework for Python.**
 
-`httpware` is a typed, async HTTP client library built on `httpx2` with a protocol-based seam so the transport is swappable. Middleware composes via an onion model. Pydantic and msgspec response decoding ship out of the box. `RecordedTransport` replaces respx for transport-level tests.
+`httpware` is a typed, async HTTP client library with a protocol-based seam so the transport is swappable (`httpx2` ships as the default). Middleware composes via an onion model. Pydantic and msgspec response decoding ship out of the box. `RecordedTransport` replaces `respx` for transport-level tests.
 
-> **Status:** Pre-1.0 (0.1.0 alpha). Public API is subject to change between minor releases until v1.0. Resilience middleware (retry / timeout / bulkhead), streaming, and observability are not yet shipped — track progress on GitHub.
+> **Status:** Pre-1.0 (0.1.0 alpha). Public API is subject to change between minor releases until v1.0. Resilience middleware (retry / timeout / bulkhead), streaming, and observability are not yet shipped.
 
 ## Install
 
@@ -55,7 +53,7 @@ Optional extras:
 pip install httpware[msgspec]    # MsgspecDecoder
 ```
 
-(`otel`, `niquests`, and `all` extras are declared but their integrations have not shipped yet.)
+(`otel`, `niquests`, and `all` extras are declared; integrations have not shipped yet.)
 
 ## Quickstart
 
@@ -75,20 +73,12 @@ async def main() -> None:
         print(user.name)
 ```
 
-## What ships in 0.1.0
+## 📚 [Documentation](https://httpware.readthedocs.io)
 
-- **`AsyncClient`** — eight HTTP method shortcuts (`get`, `post`, `put`, `patch`, `delete`, `head`, `options`, `request`) with typed `response_model` overloads; per-call overrides for `headers`, `params`, `cookies`, `timeout`, `json`, `content`; httpx-style `base_url` join; `with_options(...)` returns a view sharing the same transport.
-- **Transport-agnostic seam.** `httpx2` is confined to `httpware.transports.httpx2.Httpx2Transport`. Implement the `Transport` protocol to swap backends.
-- **Middleware foundation.** `Middleware` protocol, `Next` type alias, recursive-closure `compose()` chain composition, and phase decorators (`@before_request`, `@after_response`, `@on_error`).
-- **Pluggable response decoding.** `PydanticDecoder` (default) with cached `TypeAdapter`; `MsgspecDecoder` via `httpware[msgspec]`.
-- **`RecordedTransport`** — built-in test double with a route table, observed-request list, and `aclose_calls` counter.
-- **Status-keyed exception hierarchy** — `StatusError`, 4xx / 5xx subclasses, plain typed fields (`status: int`, `body: bytes`, `headers`, `json`, `request_method`, `request_url`). Pickleable; userinfo redacted in `__repr__`.
-- **No `httpx2` exception types** leak through `httpware`. The transport seam maps them to `httpware` exceptions.
+## 📦 [PyPI](https://pypi.org/project/httpware)
+
+## 📝 [License](./LICENSE)
 
 ## Part of `modern-python`
 
 Browse the full list of templates and libraries in [`modern-python`](https://github.com/modern-python) — see the org profile for the categorized index.
-
-## License
-
-MIT — see [LICENSE](./LICENSE).

httpware-0.2.0/README.md

@@ -0,0 +1,54 @@
+# httpware
+
+[![Test](https://github.com/modern-python/httpware/actions/workflows/ci.yml/badge.svg)](https://github.com/modern-python/httpware/actions/workflows/ci.yml)
+[![PyPI version](https://badge.fury.io/py/httpware.svg)](https://pypi.org/project/httpware/)
+[![Python versions](https://img.shields.io/pypi/pyversions/httpware.svg)](https://pypi.org/project/httpware/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+**Async HTTP client framework for Python.**
+
+`httpware` is a typed, async HTTP client library with a protocol-based seam so the transport is swappable (`httpx2` ships as the default). Middleware composes via an onion model. Pydantic and msgspec response decoding ship out of the box. `RecordedTransport` replaces `respx` for transport-level tests.
+
+> **Status:** Pre-1.0 (0.1.0 alpha). Public API is subject to change between minor releases until v1.0. Resilience middleware (retry / timeout / bulkhead), streaming, and observability are not yet shipped.
+
+## Install
+
+```bash
+pip install httpware
+```
+
+Optional extras:
+
+```bash
+pip install httpware[msgspec]    # MsgspecDecoder
+```
+
+(`otel`, `niquests`, and `all` extras are declared; integrations have not shipped yet.)
+
+## Quickstart
+
+```python
+from httpware import AsyncClient
+from pydantic import BaseModel
+
+
+class User(BaseModel):
+    id: int
+    name: str
+
+
+async def main() -> None:
+    async with AsyncClient(base_url="https://api.example.com") as client:
+        user = await client.get("/users/1", response_model=User)
+        print(user.name)
+```
+
+## 📚 [Documentation](https://httpware.readthedocs.io)
+
+## 📦 [PyPI](https://pypi.org/project/httpware)
+
+## 📝 [License](./LICENSE)
+
+## Part of `modern-python`
+
+Browse the full list of templates and libraries in [`modern-python`](https://github.com/modern-python) — see the org profile for the categorized index.

{httpware-0.1.0 → httpware-0.2.0}/pyproject.toml

@@ -26,7 +26,7 @@ classifiers = [
     "Topic :: Internet :: WWW/HTTP",
     "Framework :: AsyncIO",
 ]
-version = "0.1.0"
+version = "0.2.0"
 dependencies = [
     "httpx2>=2.0.0,<3.0",
     "pydantic>=2.0,<3.0",
@@ -38,15 +38,14 @@ otel = [
     "opentelemetry-api>=1.20",
     "opentelemetry-sdk>=1.20",
 ]
-niquests = ["niquests>=3.18"]
-all = ["httpware[msgspec,otel,niquests]"]
+all = ["httpware[msgspec,otel]"]
 
 [project.urls]
 repository = "https://github.com/modern-python/httpware"
 docs = "https://httpware.readthedocs.io"
 
 [build-system]
-requires = ["uv_build>=0.11,<0.12"]
+requires = ["uv_build>=0.11,<1.0"]
 build-backend = "uv_build"
 
 [tool.uv.build-backend]
@@ -74,7 +73,6 @@ fix = true
 unsafe-fixes = true
 line-length = 120
 target-version = "py311"
-extend-exclude = ["docs"]
 
 [tool.ruff.lint]
 select = ["ALL"]
@@ -90,24 +88,16 @@ ignore = [
 ]
 isort.lines-after-imports = 2
 isort.no-lines-before = ["standard-library", "local-folder"]
-pylint.max-args = 10  # HTTP-method APIs are kwarg-rich (headers, params, cookies, timeout, json, content, response_model, …); default 5 is too strict.
 
 [tool.ruff.lint.per-file-ignores]
-# AsyncClient's HTTP-method `timeout=` is a config-value parameter forwarded to the transport,
-# not asyncio.timeout territory. The rule fires on 24+ method signatures in this one file with
-# the same false-positive justification; per-file disable is cleaner than 24 per-line noqa.
-"src/httpware/client.py" = ["ASYNC109"]
+"src/httpware/client.py" = ["ASYNC109", "ANN401"]
 
 [tool.pytest.ini_options]
-addopts = "--cov=src/httpware --cov-report term-missing -m 'not perf'"
+addopts = "--cov=. --cov-report term-missing --cov-fail-under=100"
 asyncio_mode = "auto"
 pythonpath = ["src"]
 asyncio_default_fixture_loop_scope = "function"
-markers = [
-    "perf: assertive performance tests (skipped by default; run with `pytest -m perf`)",
-]
 
 [tool.coverage]
 run.concurrency = ["thread"]
-run.omit = ["benchmarks/*"]
 report.exclude_also = ["if typing.TYPE_CHECKING:"]

{httpware-0.1.0 → httpware-0.2.0}/src/httpware/__init__.py

@@ -1,7 +1,6 @@
-"""httpware — resilience-first async HTTP client framework for Python."""
+"""httpware — thin async HTTP client wrapper over httpx2."""
 
 from httpware.client import AsyncClient
-from httpware.config import ClientConfig, Limits, Timeout
 from httpware.decoders import ResponseDecoder
 from httpware.decoders.pydantic import PydanticDecoder
 from httpware.errors import (
@@ -23,41 +22,27 @@ from httpware.errors import (
     UnprocessableEntityError,
 )
 from httpware.middleware import Middleware, Next, after_response, before_request, on_error
-from httpware.request import Request
-from httpware.response import Response, StreamResponse
-from httpware.transports import Transport
-from httpware.transports.httpx2 import Httpx2Transport
-from httpware.transports.recorded import RecordedTransport
 
 
 __all__ = [
     "STATUS_TO_EXCEPTION",
     "AsyncClient",
     "BadRequestError",
-    "ClientConfig",
     "ClientError",
     "ClientStatusError",
     "ConflictError",
     "ForbiddenError",
-    "Httpx2Transport",
     "InternalServerError",
-    "Limits",
     "Middleware",
     "Next",
     "NotFoundError",
     "PydanticDecoder",
     "RateLimitedError",
-    "RecordedTransport",
-    "Request",
-    "Response",
     "ResponseDecoder",
     "ServerStatusError",
     "ServiceUnavailableError",
     "StatusError",
-    "StreamResponse",
-    "Timeout",
     "TimeoutError",
-    "Transport",
     "TransportError",
     "UnauthorizedError",
     "UnprocessableEntityError",