httpware 0.1.0__tar.gz → 0.3.0__tar.gz

httpware-0.3.0/PKG-INFO

@@ -0,0 +1,84 @@
+Metadata-Version: 2.4
+Name: httpware
+Version: 0.3.0
+Summary: Resilience-first async HTTP client framework for Python
+Keywords: http,async,client,resilience,retry,circuit-breaker,middleware,httpx,pydantic
+Author: Artur Shiriev
+Author-email: Artur Shiriev <me@shiriev.ru>
+License-Expression: MIT
+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: Typing :: Typed
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: Internet :: WWW/HTTP
+Classifier: Framework :: AsyncIO
+Requires-Dist: httpx2>=2.0.0,<3.0
+Requires-Dist: httpware[pydantic,msgspec,otel] ; extra == 'all'
+Requires-Dist: msgspec>=0.18 ; extra == 'msgspec'
+Requires-Dist: opentelemetry-api>=1.20 ; extra == 'otel'
+Requires-Dist: opentelemetry-sdk>=1.20 ; extra == 'otel'
+Requires-Dist: pydantic>=2.0,<3.0 ; extra == 'pydantic'
+Requires-Python: >=3.11, <4
+Project-URL: repository, https://github.com/modern-python/httpware
+Project-URL: docs, https://httpware.readthedocs.io
+Provides-Extra: all
+Provides-Extra: msgspec
+Provides-Extra: otel
+Provides-Extra: pydantic
+Description-Content-Type: text/markdown
+
+# 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 thin opinionated wrapper around `httpx2`. It re-exports `httpx2.Request`/`httpx2.Response`, adds a middleware chain composed at client construction, supports opt-in typed response decoding (pydantic and msgspec are both extras), and raises a status-keyed exception tree automatically on 4xx/5xx.
+
+> **Status:** Pre-1.0 (0.3.0). 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                # core only — no decoder
+pip install httpware[pydantic]      # + PydanticDecoder (the default-decoder path)
+pip install httpware[msgspec]       # + MsgspecDecoder
+pip install httpware[all]           # everything declared above (pydantic, msgspec, otel)
+```
+
+`AsyncClient()` with no `decoder=` argument defaults to constructing a `PydanticDecoder`; that path requires the `pydantic` extra and raises `ImportError` at `AsyncClient.__init__` if it is missing. The `otel` extra is declared but the OpenTelemetry middleware (Epic 5) has not shipped yet.
+
+## Quickstart
+
+> Requires: `pip install httpware[pydantic]`
+
+```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.3.0/README.md

@@ -0,0 +1,53 @@
+# 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 thin opinionated wrapper around `httpx2`. It re-exports `httpx2.Request`/`httpx2.Response`, adds a middleware chain composed at client construction, supports opt-in typed response decoding (pydantic and msgspec are both extras), and raises a status-keyed exception tree automatically on 4xx/5xx.
+
+> **Status:** Pre-1.0 (0.3.0). 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                # core only — no decoder
+pip install httpware[pydantic]      # + PydanticDecoder (the default-decoder path)
+pip install httpware[msgspec]       # + MsgspecDecoder
+pip install httpware[all]           # everything declared above (pydantic, msgspec, otel)
+```
+
+`AsyncClient()` with no `decoder=` argument defaults to constructing a `PydanticDecoder`; that path requires the `pydantic` extra and raises `ImportError` at `AsyncClient.__init__` if it is missing. The `otel` extra is declared but the OpenTelemetry middleware (Epic 5) has not shipped yet.
+
+## Quickstart
+
+> Requires: `pip install httpware[pydantic]`
+
+```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.3.0}/pyproject.toml

@@ -26,27 +26,26 @@ classifiers = [
     "Topic :: Internet :: WWW/HTTP",
     "Framework :: AsyncIO",
 ]
-version = "0.1.0"
+version = "0.3.0"
 dependencies = [
     "httpx2>=2.0.0,<3.0",
-    "pydantic>=2.0,<3.0",
 ]
 
 [project.optional-dependencies]
+pydantic = ["pydantic>=2.0,<3.0"]
 msgspec = ["msgspec>=0.18"]
 otel = [
     "opentelemetry-api>=1.20",
     "opentelemetry-sdk>=1.20",
 ]
-niquests = ["niquests>=3.18"]
-all = ["httpware[msgspec,otel,niquests]"]
+all = ["httpware[pydantic,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.3.0}/src/httpware/__init__.py

@@ -1,9 +1,7 @@
-"""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 (
     STATUS_TO_EXCEPTION,
     BadRequestError,
@@ -23,41 +21,26 @@ 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",

{httpware-0.1.0 → httpware-0.3.0}/src/httpware/_internal/import_checker.py

@@ -4,3 +4,4 @@ from importlib.util import find_spec
 
 
 is_msgspec_installed = find_spec("msgspec") is not None
+is_pydantic_installed = find_spec("pydantic") is not None