You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit a6d03f4
Browse filesBrowse the repository at this point in the historyBrowse files
Copy file name to clipboardExpand all lines: README.md
+7-15Lines changed: 7 additions & 15 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -7,9 +7,9 @@
7
7
8
8
**Async HTTP client framework for Python.**
9
9
10
-
`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.
10
+
`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.
11
11
12
-
> **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.
12
+
> **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.
13
13
14
14
## Install
15
15
@@ -23,7 +23,7 @@ Optional extras:
23
23
pip install httpware[msgspec] # MsgspecDecoder
24
24
```
25
25
26
-
(`otel`, `niquests`, and `all` extras are declared but their integrations have not shipped yet.)
26
+
(`otel`, `niquests`, and `all` extras are declared; integrations have not shipped yet.)
-**`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.
49
-
-**Transport-agnostic seam.**`httpx2` is confined to `httpware.transports.httpx2.Httpx2Transport`. Implement the `Transport` protocol to swap backends.
50
-
-**Middleware foundation.**`Middleware` protocol, `Next` type alias, and phase decorators (`@before_request`, `@after_response`, `@on_error`). The chain is composed at `AsyncClient` construction; consumers don't compose chains themselves.
51
-
-**Pluggable response decoding.**`PydanticDecoder` (default) with cached `TypeAdapter`; `MsgspecDecoder` via `httpware[msgspec]`.
52
-
-**`RecordedTransport`** — built-in test double with a route table, observed-request list, and `aclose_calls` counter.
-**No `httpx2` exception types** leak through `httpware`. The transport seam maps them to `httpware` exceptions.
48
+
## 📦 [PyPI](https://pypi.org/project/httpware)
49
+
50
+
## 📝 [License](./LICENSE)
55
51
56
52
## Part of `modern-python`
57
53
58
54
Browse the full list of templates and libraries in [`modern-python`](https://github.com/modern-python) — see the org profile for the categorized index.
0 commit comments