nemoguardrails.http.client

Protocols implemented by transport-neutral asynchronous HTTP clients.

Module Contents

Classes

Name	Description
`ClosableHTTPClient`	An HTTP client that exposes asynchronous resource cleanup.
`HTTPClient`	Send asynchronous HTTP requests without exposing transport-specific types.

API

class nemoguardrails.http.client.ClosableHTTPClient()

Protocol

Bases: HTTPClient

An HTTP client that exposes asynchronous resource cleanup.

nemoguardrails.http.client.ClosableHTTPClient.close() -> None

async

Release resources owned by the client.

Implementations must make repeated calls safe.

class nemoguardrails.http.client.HTTPClient()

Protocol

Send asynchronous HTTP requests without exposing transport-specific types.

nemoguardrails.http.client.HTTPClient.request(
    method: str,
    url: str,
    headers: typing.Mapping[str, str] | None = None,
    params: typing.Mapping[str, typing.Any] | None = None,
    json: typing.Any = None,
    content: bytes | str | None = None,
    timeout: float | None = None
) -> nemoguardrails.http.types.HTTPResponse

async

Send one request and return a response whose content is fully owned.

Parameters:

method

str

HTTP method, case-insensitive.

url

str

Absolute request URL.

headers

Mapping[str, str] | NoneDefaults to None

Optional request headers.

params

Mapping[str, Any] | NoneDefaults to None

Optional query parameters.

json

AnyDefaults to None

Optional JSON-serializable request body.

content

bytes | str | NoneDefaults to None

Optional raw request body.

timeout

float | NoneDefaults to None

Optional total request timeout in seconds.

Returns: HTTPResponse

A transport-neutral response containing materialized body bytes.