eggfetch 0.1.8__cp314-cp314-win_amd64.whl

eggfetch/__init__.py

@@ -0,0 +1,146 @@
+"""eggfetch - Python bindings for the eggfetch HTTP client engine.
+
+Provides both sync and async APIs over the async Rust core via PyO3.
+The sync API blocks on the async engine while releasing the GIL.
+The async API integrates with asyncio.
+"""
+
+from eggfetch._native import (
+    __version__,
+    AsyncClient,
+    AsyncNetworkStream,
+    AsyncStreamingBytesIterator,
+    AsyncStreamingLinesIterator,
+    AsyncStreamingRawBytesIterator,
+    AsyncStreamingTextIterator,
+    BasicAuth,
+    BearerAuth,
+    Client,
+    NetworkStream,
+    Cookie,
+    Cookies,
+    File,
+    Headers,
+    Limits,
+    NoAuth,
+    Response,
+    StreamingBytesIterator,
+    StreamingLinesIterator,
+    StreamingRawBytesIterator,
+    StreamingResponse,
+    StreamingTextIterator,
+    Timeout,
+    NOAUTH,
+    # Top-level helpers
+    request,
+    get,
+    post,
+    put,
+    patch,
+    delete,
+    head,
+    options,
+    # Exceptions
+    EggfetchError,
+    RequestError,
+    InvalidUrl,
+    TimeoutException,
+    PoolTimeout,
+    ConnectTimeout,
+    ReadTimeout,
+    WriteTimeout,
+    NetworkError,
+    ProtocolError,
+    BodyError,
+    DecompressionError,
+    UnsupportedContentEncoding,
+    HTTPStatusError,
+    UnsupportedKwarg,
+    TooManyRedirects,
+    StreamConsumed,
+    StreamClosed,
+    ResponseNotRead,
+    ProxyError,
+    ProxyConnectError,
+    ProxyAuthError,
+    Retry,
+    BodyNotReplayableForRetry,
+    RetryBudgetExhausted,
+    RetryNotConfigured,
+    Http2Error,
+    Http2GoAway,
+    Http2StreamReset,
+    Http2FlowControlError,
+    H3Error,
+    H3ConnectError,
+    H3ProtocolError,
+)
+
+__all__ = [
+    "__version__",
+    "AsyncClient",
+    "AsyncNetworkStream",
+    "AsyncStreamingBytesIterator",
+    "AsyncStreamingLinesIterator",
+    "AsyncStreamingRawBytesIterator",
+    "AsyncStreamingTextIterator",
+    "BasicAuth",
+    "BearerAuth",
+    "Client",
+    "NetworkStream",
+    "Cookie",
+    "Cookies",
+    "File",
+    "Headers",
+    "Limits",
+    "NoAuth",
+    "NOAUTH",
+    "Response",
+    "StreamingBytesIterator",
+    "StreamingLinesIterator",
+    "StreamingRawBytesIterator",
+    "StreamingResponse",
+    "StreamingTextIterator",
+    "Timeout",
+    "request",
+    "get",
+    "post",
+    "put",
+    "patch",
+    "delete",
+    "head",
+    "options",
+    "EggfetchError",
+    "RequestError",
+    "InvalidUrl",
+    "TimeoutException",
+    "PoolTimeout",
+    "ConnectTimeout",
+    "ReadTimeout",
+    "WriteTimeout",
+    "NetworkError",
+    "ProtocolError",
+    "BodyError",
+    "DecompressionError",
+    "UnsupportedContentEncoding",
+    "HTTPStatusError",
+    "UnsupportedKwarg",
+    "TooManyRedirects",
+    "StreamConsumed",
+    "StreamClosed",
+    "ResponseNotRead",
+    "ProxyError",
+    "ProxyConnectError",
+    "ProxyAuthError",
+    "Retry",
+    "BodyNotReplayableForRetry",
+    "RetryBudgetExhausted",
+    "RetryNotConfigured",
+    "Http2Error",
+    "Http2GoAway",
+    "Http2StreamReset",
+    "Http2FlowControlError",
+    "H3Error",
+    "H3ConnectError",
+    "H3ProtocolError",
+]

eggfetch/__init__.pyi

@@ -0,0 +1,89 @@
+"""Reviewed public typing surface for the native :mod:`eggfetch` package."""
+
+from ._native import (
+    AsyncClient,
+    AsyncNetworkStream,
+    AsyncStreamingBytesIterator,
+    AsyncStreamingLinesIterator,
+    AsyncStreamingRawBytesIterator,
+    AsyncStreamingTextIterator,
+    BasicAuth,
+    BearerAuth,
+    BodyError,
+    BodyNotReplayableForRetry,
+    Client,
+    ConnectTimeout,
+    Cookie,
+    Cookies,
+    DecompressionError,
+    EggfetchError,
+    File,
+    H3ConnectError,
+    H3Error,
+    H3ProtocolError,
+    Headers,
+    Http2Error,
+    Http2FlowControlError,
+    Http2GoAway,
+    Http2StreamReset,
+    HTTPStatusError,
+    InvalidUrl,
+    Limits,
+    NetworkError,
+    NetworkStream,
+    NoAuth,
+    NOAUTH,
+    options,
+    PoolTimeout,
+    ProtocolError,
+    ProxyAuthError,
+    ProxyConnectError,
+    ProxyError,
+    ReadTimeout,
+    RequestError,
+    request,
+    Response,
+    ResponseNotRead,
+    Retry,
+    RetryBudgetExhausted,
+    RetryNotConfigured,
+    StreamingBytesIterator,
+    StreamingLinesIterator,
+    StreamingRawBytesIterator,
+    StreamingResponse,
+    StreamingTextIterator,
+    StreamClosed,
+    StreamConsumed,
+    Timeout,
+    TimeoutException,
+    TooManyRedirects,
+    UnsupportedContentEncoding,
+    UnsupportedKwarg,
+    WriteTimeout,
+    delete,
+    get,
+    head,
+    patch,
+    post,
+    put,
+    __version__,
+)
+
+__all__ = [
+    "__version__", "AsyncClient", "AsyncNetworkStream",
+    "AsyncStreamingBytesIterator", "AsyncStreamingLinesIterator",
+    "AsyncStreamingRawBytesIterator", "AsyncStreamingTextIterator",
+    "BasicAuth", "BearerAuth", "Client", "NetworkStream", "Cookie",
+    "Cookies", "File", "Headers", "Limits", "NoAuth", "NOAUTH",
+    "Response", "StreamingBytesIterator", "StreamingLinesIterator",
+    "StreamingRawBytesIterator", "StreamingResponse", "StreamingTextIterator",
+    "Timeout", "request", "get", "post", "put", "patch", "delete", "head",
+    "options", "EggfetchError", "RequestError", "InvalidUrl", "TimeoutException",
+    "PoolTimeout", "ConnectTimeout", "ReadTimeout", "WriteTimeout", "NetworkError",
+    "ProtocolError", "BodyError", "DecompressionError", "UnsupportedContentEncoding",
+    "HTTPStatusError", "UnsupportedKwarg", "TooManyRedirects", "StreamConsumed",
+    "StreamClosed", "ResponseNotRead", "ProxyError", "ProxyConnectError",
+    "ProxyAuthError", "Retry", "BodyNotReplayableForRetry", "RetryBudgetExhausted",
+    "RetryNotConfigured", "Http2Error", "Http2GoAway", "Http2StreamReset",
+    "Http2FlowControlError", "H3Error", "H3ConnectError", "H3ProtocolError",
+]

eggfetch/_native.pyi

@@ -0,0 +1,341 @@
+"""Reviewed stubs for the private PyO3 extension.
+
+The extension is private at runtime.  The public package imports the names
+listed explicitly in ``__init__.pyi``; the type aliases below are typing-only
+conveniences and are not runtime exports.
+"""
+
+from collections.abc import AsyncIterable, AsyncIterator, Iterable, Iterator, Mapping, Sequence
+import ssl
+from typing import Any, Self, TypeAlias, TypeVar, overload
+
+BytesLike: TypeAlias = bytes | bytearray | memoryview
+SyncBody: TypeAlias = BytesLike | str | Iterable[BytesLike | str]
+AsyncBody: TypeAlias = AsyncIterable[BytesLike | str]
+HeadersInput: TypeAlias = Mapping[str, str] | Sequence[tuple[str, str]]
+Auth: TypeAlias = BasicAuth | BearerAuth | NoAuth
+Verify: TypeAlias = bool | str | ssl.SSLContext | list[bytes]
+Cert: TypeAlias = str | tuple[str, str]
+
+
+class EggfetchError(Exception): ...
+class RequestError(EggfetchError): ...
+class InvalidUrl(RequestError): ...
+class TimeoutException(RequestError): ...
+class PoolTimeout(TimeoutException): ...
+class ConnectTimeout(TimeoutException): ...
+class ReadTimeout(TimeoutException): ...
+class WriteTimeout(TimeoutException): ...
+class NetworkError(RequestError): ...
+class ProtocolError(RequestError): ...
+class BodyError(RequestError): ...
+class DecompressionError(RequestError): ...
+class UnsupportedContentEncoding(RequestError): ...
+class TooManyRedirects(RequestError): ...
+class ProxyError(RequestError): ...
+class ProxyConnectError(ProxyError): ...
+class ProxyAuthError(ProxyError): ...
+class BodyNotReplayableForRetry(RequestError): ...
+class RetryBudgetExhausted(RequestError): ...
+class RetryNotConfigured(RequestError): ...
+class Http2Error(RequestError): ...
+class Http2GoAway(Http2Error): ...
+class Http2StreamReset(Http2Error): ...
+class Http2FlowControlError(Http2Error): ...
+class H3Error(RequestError): ...
+class H3ConnectError(H3Error): ...
+class H3ProtocolError(H3Error): ...
+class HTTPStatusError(EggfetchError): ...
+class UnsupportedKwarg(EggfetchError): ...
+class StreamConsumed(EggfetchError): ...
+class StreamClosed(EggfetchError): ...
+class ResponseNotRead(EggfetchError): ...
+
+
+class Headers:
+    def __init__(self, value: HeadersInput | None = ..., **kwargs: str) -> None: ...
+    def __getitem__(self, key: str) -> str: ...
+    def __contains__(self, key: str) -> bool: ...
+    def __iter__(self) -> Iterator[str]: ...
+    def __len__(self) -> int: ...
+    def get(self, name: str, default: str | None = ...) -> str | None: ...
+    def keys(self) -> list[str]: ...
+    def values(self) -> list[str]: ...
+    def items(self) -> list[tuple[str, str]]: ...
+    def get_list(self, name: str) -> list[str]: ...
+
+
+class Cookie:
+    name: str
+    value: str
+    domain: str
+    is_host_only: bool
+    path: str
+    is_secure: bool
+    is_http_only: bool
+    same_site: str | None
+    expires: float | None
+    is_persistent: bool
+    name_value_pair: str
+
+
+_CookieDefaultT = TypeVar("_CookieDefaultT")
+
+
+class Cookies:
+    def __init__(self) -> None: ...
+    def __getitem__(self, key: str) -> Cookie: ...
+    def __contains__(self, key: str) -> bool: ...
+    def __iter__(self) -> Iterator[str]: ...
+    def __len__(self) -> int: ...
+    def __setitem__(self, key: str, value: Cookie) -> None: ...
+    def __delitem__(self, key: str) -> None: ...
+    @overload
+    def get(self, name: str, default: None = ...) -> Cookie | None: ...
+    @overload
+    def get(self, name: str, default: _CookieDefaultT) -> Cookie | _CookieDefaultT: ...
+    def set(self, name: str, value: str, *, domain: str | None = ..., path: str | None = ...) -> None: ...
+    def clear(self) -> None: ...
+    def values(self) -> list[Cookie]: ...
+    def items(self) -> list[tuple[str, Cookie]]: ...
+
+
+class Timeout:
+    def __init__(
+        self,
+        seconds: float | None = ...,
+        *,
+        pool: float | None = ...,
+        connect: float | None = ...,
+        write: float | None = ...,
+        read: float | None = ...,
+        total: float | None = ...,
+    ) -> None: ...
+    pool: float | None
+    connect: float | None
+    write: float | None
+    read: float | None
+    total: float | None
+    def has_any(self) -> bool: ...
+
+
+class Limits:
+    def __init__(
+        self,
+        *,
+        max_connections: int | None = ...,
+        max_keepalive_connections: int | None = ...,
+        keepalive_expiry: float | None = ...,
+        max_connections_per_host: int | None = ...,
+    ) -> None: ...
+    max_connections: int | None
+    max_keepalive_connections: int | None
+    keepalive_expiry: float | None
+    max_connections_per_host: int | None
+
+
+class Retry:
+    def __init__(
+        self,
+        max_attempts: int = ...,
+        backoff_factor: float = ...,
+        max_delay: float = ...,
+        initial_delay: float = ...,
+        statuses: Sequence[int] | None = ...,
+        respect_retry_after: bool = ...,
+        allow_post: bool = ...,
+        allow_put: bool = ...,
+        allow_delete: bool = ...,
+        allow_patch: bool = ...,
+        max_elapsed: float | None = ...,
+    ) -> None: ...
+    max_attempts: int
+    backoff_factor: float
+    initial_delay: float
+    max_delay: float
+    respect_retry_after: bool
+    statuses: list[int]
+    max_elapsed: float | None
+    allow_post: bool
+    allow_put: bool
+    allow_delete: bool
+    allow_patch: bool
+
+
+class BasicAuth:
+    def __init__(self, username: str, password: str = ...) -> None: ...
+    username: str
+
+
+class BearerAuth:
+    def __init__(self, token: str) -> None: ...
+
+
+class NoAuth: ...
+NOAUTH: NoAuth
+
+
+class File:
+    def __init__(self, path: str, *, filename: str | None = ..., content_type: str | None = ...) -> None: ...
+    path: str
+    filename: str
+    content_type: str
+
+
+class NetworkStream:
+    def read(self, max_bytes: int = ..., timeout: float | None = ...) -> bytes: ...
+    def write(self, data: bytes, timeout: float | None = ...) -> None: ...
+    def close(self) -> None: ...
+    def get_extra_info(self, key: str) -> str | None: ...
+    @property
+    def is_upgraded(self) -> bool: ...
+    def start_tls(self, ssl_context: ssl.SSLContext | None, server_hostname: str, *, timeout: float | None = ...) -> NetworkStream: ...
+
+
+class AsyncNetworkStream:
+    async def read(self, max_bytes: int = ..., timeout: float | None = ...) -> bytes: ...
+    async def write(self, data: bytes, timeout: float | None = ...) -> None: ...
+    async def aclose(self) -> None: ...
+    def get_extra_info(self, key: str) -> str | None: ...
+    @property
+    def is_upgraded(self) -> bool: ...
+    async def start_tls(self, ssl_context: ssl.SSLContext | None, server_hostname: str, *, timeout: float | None = ...) -> AsyncNetworkStream: ...
+
+
+class Response:
+    status_code: int
+    headers: Headers
+    url: str
+    reason_phrase: str
+    http_version: str
+    encoding: str | None
+    history: list[Response]
+    cookies: Cookies
+    extensions: dict[str, Any]
+    content: bytes
+    text: str
+    is_informational: bool
+    is_success: bool
+    is_redirect: bool
+    is_client_error: bool
+    is_server_error: bool
+    is_error: bool
+    def json(self, **kwargs: Any) -> Any: ...
+    def iter_bytes(self, chunk_size: int = ...) -> Iterator[bytes]: ...
+    def iter_text(self, chunk_size: int = ...) -> Iterator[str]: ...
+    def iter_lines(self) -> Iterator[str]: ...
+    def raise_for_status(self) -> None: ...
+    def close(self) -> None: ...
+    async def aclose(self) -> None: ...
+
+
+class StreamingResponse:
+    status_code: int
+    headers: Headers
+    url: str
+    reason_phrase: str
+    http_version: str
+    encoding: str | None
+    history: list[Response]
+    cookies: Cookies
+    extensions: dict[str, Any]
+    network_stream: NetworkStream | AsyncNetworkStream | None
+    is_informational: bool
+    is_success: bool
+    is_redirect: bool
+    is_client_error: bool
+    is_server_error: bool
+    is_error: bool
+    def __enter__(self) -> Self: ...
+    def __exit__(self, _exc_type: Any = ..., _exc_value: Any = ..., _traceback: Any = ...) -> bool: ...
+    async def __aenter__(self) -> Self: ...
+    async def __aexit__(self, _exc_type: Any = ..., _exc_value: Any = ..., _traceback: Any = ...) -> bool: ...
+    def iter_bytes(self, *, chunk_size: int = ...) -> Iterator[bytes]: ...
+    def iter_text(self, *, chunk_size: int = ..., encoding: str | None = ...) -> Iterator[str]: ...
+    def iter_lines(self, *, chunk_size: int = ..., encoding: str | None = ...) -> Iterator[str]: ...
+    def iter_raw(self, *, chunk_size: int | None = ...) -> Iterator[bytes]: ...
+    def aiter_bytes(self, *, chunk_size: int = ...) -> AsyncIterator[bytes]: ...
+    def aiter_text(self, *, chunk_size: int = ..., encoding: str | None = ...) -> AsyncIterator[str]: ...
+    def aiter_lines(self, *, chunk_size: int = ..., encoding: str | None = ...) -> AsyncIterator[str]: ...
+    def aiter_raw(self, *, chunk_size: int | None = ...) -> AsyncIterator[bytes]: ...
+    def read(self) -> bytes: ...
+    def text(self) -> str: ...
+    async def aread(self) -> bytes: ...
+    def raise_for_status(self) -> None: ...
+    def close(self) -> None: ...
+    async def aclose(self) -> None: ...
+
+
+class StreamingBytesIterator(Iterator[bytes]):
+    def __iter__(self) -> Self: ...
+    def __next__(self) -> bytes: ...
+class StreamingTextIterator(Iterator[str]):
+    def __iter__(self) -> Self: ...
+    def __next__(self) -> str: ...
+class StreamingLinesIterator(Iterator[str]):
+    def __iter__(self) -> Self: ...
+    def __next__(self) -> str: ...
+class StreamingRawBytesIterator(Iterator[bytes]):
+    def __iter__(self) -> Self: ...
+    def __next__(self) -> bytes: ...
+class AsyncStreamingBytesIterator(AsyncIterator[bytes]):
+    def __aiter__(self) -> Self: ...
+    async def __anext__(self) -> bytes: ...
+class AsyncStreamingTextIterator(AsyncIterator[str]):
+    def __aiter__(self) -> Self: ...
+    async def __anext__(self) -> str: ...
+class AsyncStreamingLinesIterator(AsyncIterator[str]):
+    def __aiter__(self) -> Self: ...
+    async def __anext__(self) -> str: ...
+class AsyncStreamingRawBytesIterator(AsyncIterator[bytes]):
+    def __aiter__(self) -> Self: ...
+    async def __anext__(self) -> bytes: ...
+
+
+class Client:
+    def __init__(self, *, headers: HeadersInput | None = ..., timeout: float | Timeout | None = ..., follow_redirects: bool | None = ..., max_redirects: int | None = ..., cookies: Cookies | Mapping[str, str] | None = ..., auth: Auth | None = ..., decompress: bool | None = ..., proxy: str | None = ..., verify: Verify | None = ..., cert: Cert | None = ..., retries: Retry | None = ..., http1: bool | None = ..., http2: bool | None = ..., http3: bool | None = ..., limits: Limits | None = ..., trust_env: bool | None = ..., local_address: str | None = ..., socket_options: Sequence[tuple[int, ...]] | None = ..., uds: str | None = ...) -> None: ...
+    is_closed: bool
+    cookies: Cookies
+    def __enter__(self) -> Self: ...
+    def __exit__(self, _exc_type: Any = ..., _exc_value: Any = ..., _traceback: Any = ...) -> bool: ...
+    def request(self, method: str, url: str, *, headers: HeadersInput | None = ..., params: Any = ..., content: SyncBody | None = ..., data: Any = ..., json: Any = ..., files: Any = ..., timeout: float | Timeout | None = ..., cookies: Cookies | Mapping[str, str] | None = ..., auth: Auth | None = ..., follow_redirects: bool | None = ..., max_redirects: int | None = ..., decompress: bool | None = ..., proxy: str | None = ..., verify: Verify | None = ..., cert: Cert | None = ..., retries: Retry | None = ..., extensions: Mapping[str, Any] | None = ...) -> Response: ...
+    def get(self, url: str, *, headers: HeadersInput | None = ..., params: Any = ..., timeout: float | Timeout | None = ..., cookies: Cookies | Mapping[str, str] | None = ..., auth: Auth | None = ..., follow_redirects: bool | None = ..., max_redirects: int | None = ..., decompress: bool | None = ..., proxy: str | None = ..., verify: Verify | None = ..., cert: Cert | None = ..., retries: Retry | None = ..., extensions: Mapping[str, Any] | None = ...) -> Response: ...
+    def post(self, url: str, *, headers: HeadersInput | None = ..., params: Any = ..., content: SyncBody | None = ..., data: Any = ..., json: Any = ..., files: Any = ..., timeout: float | Timeout | None = ..., cookies: Cookies | Mapping[str, str] | None = ..., auth: Auth | None = ..., follow_redirects: bool | None = ..., max_redirects: int | None = ..., decompress: bool | None = ..., proxy: str | None = ..., verify: Verify | None = ..., cert: Cert | None = ..., retries: Retry | None = ..., extensions: Mapping[str, Any] | None = ...) -> Response: ...
+    def put(self, url: str, *, headers: HeadersInput | None = ..., params: Any = ..., content: SyncBody | None = ..., data: Any = ..., json: Any = ..., files: Any = ..., timeout: float | Timeout | None = ..., cookies: Cookies | Mapping[str, str] | None = ..., auth: Auth | None = ..., follow_redirects: bool | None = ..., max_redirects: int | None = ..., decompress: bool | None = ..., proxy: str | None = ..., verify: Verify | None = ..., cert: Cert | None = ..., retries: Retry | None = ..., extensions: Mapping[str, Any] | None = ...) -> Response: ...
+    def patch(self, url: str, *, headers: HeadersInput | None = ..., params: Any = ..., content: SyncBody | None = ..., data: Any = ..., json: Any = ..., files: Any = ..., timeout: float | Timeout | None = ..., cookies: Cookies | Mapping[str, str] | None = ..., auth: Auth | None = ..., follow_redirects: bool | None = ..., max_redirects: int | None = ..., decompress: bool | None = ..., proxy: str | None = ..., verify: Verify | None = ..., cert: Cert | None = ..., retries: Retry | None = ..., extensions: Mapping[str, Any] | None = ...) -> Response: ...
+    def delete(self, url: str, *, headers: HeadersInput | None = ..., params: Any = ..., timeout: float | Timeout | None = ..., cookies: Cookies | Mapping[str, str] | None = ..., auth: Auth | None = ..., follow_redirects: bool | None = ..., max_redirects: int | None = ..., decompress: bool | None = ..., proxy: str | None = ..., verify: Verify | None = ..., cert: Cert | None = ..., retries: Retry | None = ..., extensions: Mapping[str, Any] | None = ...) -> Response: ...
+    def head(self, url: str, *, headers: HeadersInput | None = ..., params: Any = ..., timeout: float | Timeout | None = ..., cookies: Cookies | Mapping[str, str] | None = ..., auth: Auth | None = ..., follow_redirects: bool | None = ..., max_redirects: int | None = ..., decompress: bool | None = ..., proxy: str | None = ..., verify: Verify | None = ..., cert: Cert | None = ..., retries: Retry | None = ..., extensions: Mapping[str, Any] | None = ...) -> Response: ...
+    def options(self, url: str, *, headers: HeadersInput | None = ..., params: Any = ..., timeout: float | Timeout | None = ..., cookies: Cookies | Mapping[str, str] | None = ..., auth: Auth | None = ..., follow_redirects: bool | None = ..., max_redirects: int | None = ..., decompress: bool | None = ..., proxy: str | None = ..., verify: Verify | None = ..., cert: Cert | None = ..., retries: Retry | None = ..., extensions: Mapping[str, Any] | None = ...) -> Response: ...
+    def stream(self, method: str, url: str, *, headers: HeadersInput | None = ..., params: Any = ..., content: SyncBody | None = ..., data: Any = ..., json: Any = ..., files: Any = ..., timeout: float | Timeout | None = ..., cookies: Cookies | Mapping[str, str] | None = ..., auth: Auth | None = ..., follow_redirects: bool | None = ..., max_redirects: int | None = ..., decompress: bool | None = ..., proxy: str | None = ..., verify: Verify | None = ..., cert: Cert | None = ..., retries: Retry | None = ..., extensions: Mapping[str, Any] | None = ...) -> StreamingResponse: ...
+    def close(self) -> None: ...
+
+
+class AsyncClient:
+    def __init__(self, *, headers: HeadersInput | None = ..., timeout: float | Timeout | None = ..., follow_redirects: bool | None = ..., max_redirects: int | None = ..., cookies: Cookies | Mapping[str, str] | None = ..., auth: Auth | None = ..., decompress: bool | None = ..., proxy: str | None = ..., verify: Verify | None = ..., cert: Cert | None = ..., retries: Retry | None = ..., http1: bool | None = ..., http2: bool | None = ..., http3: bool | None = ..., limits: Limits | None = ..., trust_env: bool | None = ..., local_address: str | None = ..., socket_options: Sequence[tuple[int, ...]] | None = ..., uds: str | None = ...) -> None: ...
+    is_closed: bool
+    cookies: Cookies
+    async def __aenter__(self) -> Self: ...
+    async def __aexit__(self, _exc_type: Any = ..., _exc_value: Any = ..., _traceback: Any = ...) -> bool: ...
+    async def request(self, method: str, url: str, *, headers: HeadersInput | None = ..., params: Any = ..., content: SyncBody | AsyncBody | None = ..., data: Any = ..., json: Any = ..., files: Any = ..., timeout: float | Timeout | None = ..., cookies: Cookies | Mapping[str, str] | None = ..., auth: Auth | None = ..., follow_redirects: bool | None = ..., max_redirects: int | None = ..., decompress: bool | None = ..., proxy: str | None = ..., verify: Verify | None = ..., cert: Cert | None = ..., retries: Retry | None = ..., extensions: Mapping[str, Any] | None = ...) -> Response: ...
+    async def get(self, url: str, *, headers: HeadersInput | None = ..., params: Any = ..., timeout: float | Timeout | None = ..., cookies: Cookies | Mapping[str, str] | None = ..., auth: Auth | None = ..., follow_redirects: bool | None = ..., max_redirects: int | None = ..., decompress: bool | None = ..., proxy: str | None = ..., verify: Verify | None = ..., cert: Cert | None = ..., retries: Retry | None = ..., extensions: Mapping[str, Any] | None = ...) -> Response: ...
+    async def post(self, url: str, *, headers: HeadersInput | None = ..., params: Any = ..., content: SyncBody | AsyncBody | None = ..., data: Any = ..., json: Any = ..., files: Any = ..., timeout: float | Timeout | None = ..., cookies: Cookies | Mapping[str, str] | None = ..., auth: Auth | None = ..., follow_redirects: bool | None = ..., max_redirects: int | None = ..., decompress: bool | None = ..., proxy: str | None = ..., verify: Verify | None = ..., cert: Cert | None = ..., retries: Retry | None = ..., extensions: Mapping[str, Any] | None = ...) -> Response: ...
+    async def put(self, url: str, *, headers: HeadersInput | None = ..., params: Any = ..., content: SyncBody | AsyncBody | None = ..., data: Any = ..., json: Any = ..., files: Any = ..., timeout: float | Timeout | None = ..., cookies: Cookies | Mapping[str, str] | None = ..., auth: Auth | None = ..., follow_redirects: bool | None = ..., max_redirects: int | None = ..., decompress: bool | None = ..., proxy: str | None = ..., verify: Verify | None = ..., cert: Cert | None = ..., retries: Retry | None = ..., extensions: Mapping[str, Any] | None = ...) -> Response: ...
+    async def patch(self, url: str, *, headers: HeadersInput | None = ..., params: Any = ..., content: SyncBody | AsyncBody | None = ..., data: Any = ..., json: Any = ..., files: Any = ..., timeout: float | Timeout | None = ..., cookies: Cookies | Mapping[str, str] | None = ..., auth: Auth | None = ..., follow_redirects: bool | None = ..., max_redirects: int | None = ..., decompress: bool | None = ..., proxy: str | None = ..., verify: Verify | None = ..., cert: Cert | None = ..., retries: Retry | None = ..., extensions: Mapping[str, Any] | None = ...) -> Response: ...
+    async def delete(self, url: str, *, headers: HeadersInput | None = ..., params: Any = ..., timeout: float | Timeout | None = ..., cookies: Cookies | Mapping[str, str] | None = ..., auth: Auth | None = ..., follow_redirects: bool | None = ..., max_redirects: int | None = ..., decompress: bool | None = ..., proxy: str | None = ..., verify: Verify | None = ..., cert: Cert | None = ..., retries: Retry | None = ..., extensions: Mapping[str, Any] | None = ...) -> Response: ...
+    async def head(self, url: str, *, headers: HeadersInput | None = ..., params: Any = ..., timeout: float | Timeout | None = ..., cookies: Cookies | Mapping[str, str] | None = ..., auth: Auth | None = ..., follow_redirects: bool | None = ..., max_redirects: int | None = ..., decompress: bool | None = ..., proxy: str | None = ..., verify: Verify | None = ..., cert: Cert | None = ..., retries: Retry | None = ..., extensions: Mapping[str, Any] | None = ...) -> Response: ...
+    async def options(self, url: str, *, headers: HeadersInput | None = ..., params: Any = ..., timeout: float | Timeout | None = ..., cookies: Cookies | Mapping[str, str] | None = ..., auth: Auth | None = ..., follow_redirects: bool | None = ..., max_redirects: int | None = ..., decompress: bool | None = ..., proxy: str | None = ..., verify: Verify | None = ..., cert: Cert | None = ..., retries: Retry | None = ..., extensions: Mapping[str, Any] | None = ...) -> Response: ...
+    async def stream(self, method: str, url: str, *, headers: HeadersInput | None = ..., params: Any = ..., content: SyncBody | AsyncBody | None = ..., data: Any = ..., json: Any = ..., files: Any = ..., timeout: float | Timeout | None = ..., cookies: Cookies | Mapping[str, str] | None = ..., auth: Auth | None = ..., follow_redirects: bool | None = ..., max_redirects: int | None = ..., decompress: bool | None = ..., proxy: str | None = ..., verify: Verify | None = ..., cert: Cert | None = ..., retries: Retry | None = ..., extensions: Mapping[str, Any] | None = ...) -> StreamingResponse: ...
+    def close(self) -> None: ...
+    async def aclose(self) -> None: ...
+
+
+def request(method: str, url: str, *, headers: HeadersInput | None = ..., params: Any = ..., content: SyncBody | None = ..., data: Any = ..., json: Any = ..., files: Any = ..., timeout: float | Timeout | None = ..., cookies: Cookies | Mapping[str, str] | None = ..., auth: Auth | None = ..., follow_redirects: bool | None = ..., max_redirects: int | None = ..., decompress: bool | None = ..., proxy: str | None = ..., verify: Verify | None = ..., cert: Cert | None = ..., retries: Retry | None = ..., limits: Limits | None = ...) -> Response: ...
+def get(url: str, *, headers: HeadersInput | None = ..., params: Any = ..., timeout: float | Timeout | None = ..., cookies: Cookies | Mapping[str, str] | None = ..., auth: Auth | None = ..., follow_redirects: bool | None = ..., max_redirects: int | None = ..., decompress: bool | None = ..., proxy: str | None = ..., verify: Verify | None = ..., cert: Cert | None = ..., retries: Retry | None = ..., limits: Limits | None = ...) -> Response: ...
+def post(url: str, *, headers: HeadersInput | None = ..., params: Any = ..., content: SyncBody | None = ..., data: Any = ..., json: Any = ..., files: Any = ..., timeout: float | Timeout | None = ..., cookies: Cookies | Mapping[str, str] | None = ..., auth: Auth | None = ..., follow_redirects: bool | None = ..., max_redirects: int | None = ..., decompress: bool | None = ..., proxy: str | None = ..., verify: Verify | None = ..., cert: Cert | None = ..., retries: Retry | None = ..., limits: Limits | None = ...) -> Response: ...
+def put(url: str, *, headers: HeadersInput | None = ..., params: Any = ..., content: SyncBody | None = ..., data: Any = ..., json: Any = ..., files: Any = ..., timeout: float | Timeout | None = ..., cookies: Cookies | Mapping[str, str] | None = ..., auth: Auth | None = ..., follow_redirects: bool | None = ..., max_redirects: int | None = ..., decompress: bool | None = ..., proxy: str | None = ..., verify: Verify | None = ..., cert: Cert | None = ..., retries: Retry | None = ..., limits: Limits | None = ...) -> Response: ...
+def patch(url: str, *, headers: HeadersInput | None = ..., params: Any = ..., content: SyncBody | None = ..., data: Any = ..., json: Any = ..., files: Any = ..., timeout: float | Timeout | None = ..., cookies: Cookies | Mapping[str, str] | None = ..., auth: Auth | None = ..., follow_redirects: bool | None = ..., max_redirects: int | None = ..., decompress: bool | None = ..., proxy: str | None = ..., verify: Verify | None = ..., cert: Cert | None = ..., retries: Retry | None = ..., limits: Limits | None = ...) -> Response: ...
+def delete(url: str, *, headers: HeadersInput | None = ..., params: Any = ..., timeout: float | Timeout | None = ..., cookies: Cookies | Mapping[str, str] | None = ..., auth: Auth | None = ..., follow_redirects: bool | None = ..., max_redirects: int | None = ..., decompress: bool | None = ..., proxy: str | None = ..., verify: Verify | None = ..., cert: Cert | None = ..., retries: Retry | None = ..., limits: Limits | None = ...) -> Response: ...
+def head(url: str, *, headers: HeadersInput | None = ..., params: Any = ..., timeout: float | Timeout | None = ..., cookies: Cookies | Mapping[str, str] | None = ..., auth: Auth | None = ..., follow_redirects: bool | None = ..., max_redirects: int | None = ..., decompress: bool | None = ..., proxy: str | None = ..., verify: Verify | None = ..., cert: Cert | None = ..., retries: Retry | None = ..., limits: Limits | None = ...) -> Response: ...
+def options(url: str, *, headers: HeadersInput | None = ..., params: Any = ..., timeout: float | Timeout | None = ..., cookies: Cookies | Mapping[str, str] | None = ..., auth: Auth | None = ..., follow_redirects: bool | None = ..., max_redirects: int | None = ..., decompress: bool | None = ..., proxy: str | None = ..., verify: Verify | None = ..., cert: Cert | None = ..., retries: Retry | None = ..., limits: Limits | None = ...) -> Response: ...
+
+__version__: str