Network¶

A small, dependency-free async HTTP client. Use fetch for the common "call a JSON API" path; reach for httpx / aiohttp if you need multipart, streaming, or HTTP/2.

Async HTTP client (pn.fetch).

A small, dependency-free coroutine wrapper around :mod:urllib.request. Operates on bytes internally and exposes a :class:Response with text(), json(), and bytes accessors.

The implementation is deliberately minimal — it covers the "call a JSON API" path that's overwhelmingly the use case for mobile apps. For streaming, multipart uploads, or HTTP/2, integrate httpx / aiohttp directly; this module won't try to compete.

Example

import pythonnative as pn


async def load_user(user_id):
    resp = await pn.fetch(
        f"https://api.example.com/users/{user_id}",
        headers={"Accept": "application/json"},
    )
    resp.raise_for_status()
    return resp.json()

Classes:

Name	Description
`Response`	The result of a `fetch` call.
`HTTPError`	Raised by `Response.raise_for_status`.

Functions:

Name	Description
`set_default_ssl_context`	Override the SSL context used by `fetch`.
`fetch`	Make an HTTP request and return a `Response`.

Response `dataclass` ¶

Response(status: int, url: str, headers: Mapping[str, str] = dict(), content: bytes = b'')

The result of a fetch call.

Attributes:

Name	Type	Description
`status`	`int`	HTTP status code (e.g. `200`).
`url`	`str`	Final URL after any redirects.
`headers`	`Mapping[str, str]`	Response headers, case-insensitive.
`content`	`bytes`	Raw response body.

Methods:

Name	Description
`text`	Decode `content` to `str`.
`json`	Parse the response body as JSON.
`raise_for_status`	Raise `HTTPError` for non-2xx responses.

ok `property` ¶

ok: bool

True if the status is in the 2xx range.

text ¶

text(encoding: Optional[str] = None) -> str

Decode content to str.

Parameters:

Name	Type	Description	Default
`encoding`	`Optional[str]`	Optional override; defaults to the `charset` parameter of `Content-Type` (or UTF-8).	`None`

json ¶

json() -> Any

Parse the response body as JSON.

Raises:

Type	Description
`JSONDecodeError`	If the body isn't valid JSON.

raise_for_status ¶

raise_for_status() -> None

Raise HTTPError for non-2xx responses.

HTTPError ¶

HTTPError(status: int, url: str, body: str)

Bases: Exception

Raised by Response.raise_for_status.

set_default_ssl_context ¶

set_default_ssl_context(context: Optional[SSLContext]) -> None

Override the SSL context used by fetch.

None (the default) means urllib builds a context from the system trust store. Tests can pass an unverified context.

fetch `async` ¶

fetch(url: str, *, method: str = 'GET', headers: Optional[Mapping[str, str]] = None, body: Union[bytes, str, Mapping[str, Any], None] = None, params: Optional[Mapping[str, Any]] = None, timeout: float = 30.0) -> Response

Make an HTTP request and return a Response.