pyqwest 0.2.0__cp313-cp313-win_amd64.whl → 0.3.0__cp313-cp313-win_amd64.whl

pyqwest/__init__.py

@@ -3,6 +3,7 @@ from __future__ import annotations
 __all__ = [
     "Client",
     "FullResponse",
+    "HTTPHeaderName",
     "HTTPTransport",
     "HTTPVersion",
     "Headers",
@@ -27,6 +28,7 @@ from ._coro import Client, Response
 from ._pyqwest import (
     FullResponse,
     Headers,
+    HTTPHeaderName,
     HTTPTransport,
     HTTPVersion,
     ReadError,

pyqwest/_coro.py

@@ -19,6 +19,10 @@ class Client:
 
     A client is a lightweight wrapper around a Transport, providing convenience methods
     for common HTTP operations with buffering.
+
+    The asynchronous client does not expose per-request timeouts on its methods.
+    Use `asyncio.wait_for` or similar to enforce timeouts per-requests or initialize
+    `HTTPTransport` with a default timeout.
     """
 
     _client: NativeClient
@@ -36,27 +40,26 @@ class Client:
         self,
         url: str,
         headers: Headers | Mapping[str, str] | Iterable[tuple[str, str]] | None = None,
-        timeout: float | None = None,
     ) -> FullResponse:
         """Executes a GET HTTP request.
 
         Args:
             url: The unencoded request URL.
             headers: The request headers.
-            timeout: The timeout for the request in seconds.
 
         Raises:
             ConnectionError: If the connection fails.
             TimeoutError: If the request times out.
+            ReadError: If an error occurs reading the response.
+            WriteError: If an error occurs writing the request.
         """
-        return await self._client.get(url, headers=headers, timeout=timeout)
+        return await self._client.get(url, headers=headers)
 
     async def post(
         self,
         url: str,
         headers: Headers | Mapping[str, str] | Iterable[tuple[str, str]] | None = None,
         content: bytes | AsyncIterator[bytes] | None = None,
-        timeout: float | None = None,
     ) -> FullResponse:
         """Executes a POST HTTP request.
 
@@ -64,79 +67,77 @@ class Client:
             url: The unencoded request URL.
             headers: The request headers.
             content: The request content.
-            timeout: The timeout for the request in seconds.
 
         Raises:
             ConnectionError: If the connection fails.
             TimeoutError: If the request times out.
+            ReadError: If an error occurs reading the response.
+            WriteError: If an error occurs writing the request.
         """
-        return await self._client.post(
-            url, headers=headers, content=content, timeout=timeout
-        )
+        return await self._client.post(url, headers=headers, content=content)
 
     async def delete(
         self,
         url: str,
         headers: Headers | Mapping[str, str] | Iterable[tuple[str, str]] | None = None,
-        timeout: float | None = None,
     ) -> FullResponse:
         """Executes a DELETE HTTP request.
 
         Args:
             url: The unencoded request URL.
             headers: The request headers.
-            timeout: The timeout for the request in seconds.
 
         Raises:
             ConnectionError: If the connection fails.
             TimeoutError: If the request times out.
+            ReadError: If an error occurs reading the response.
+            WriteError: If an error occurs writing the request.
         """
-        return await self._client.delete(url, headers=headers, timeout=timeout)
+        return await self._client.delete(url, headers=headers)
 
     async def head(
         self,
         url: str,
         headers: Headers | Mapping[str, str] | Iterable[tuple[str, str]] | None = None,
-        timeout: float | None = None,
     ) -> FullResponse:
         """Executes a HEAD HTTP request.
 
         Args:
             url: The unencoded request URL.
             headers: The request headers.
-            timeout: The timeout for the request in seconds.
 
         Raises:
             ConnectionError: If the connection fails.
             TimeoutError: If the request times out.
+            ReadError: If an error occurs reading the response.
+            WriteError: If an error occurs writing the request.
         """
-        return await self._client.head(url, headers=headers, timeout=timeout)
+        return await self._client.head(url, headers=headers)
 
     async def options(
         self,
         url: str,
         headers: Headers | Mapping[str, str] | Iterable[tuple[str, str]] | None = None,
-        timeout: float | None = None,
     ) -> FullResponse:
         """Executes a OPTIONS HTTP request.
 
         Args:
             url: The unencoded request URL.
             headers: The request headers.
-            timeout: The timeout for the request in seconds.
 
         Raises:
             ConnectionError: If the connection fails.
             TimeoutError: If the request times out.
+            ReadError: If an error occurs reading the response.
+            WriteError: If an error occurs writing the request.
         """
-        return await self._client.options(url, headers=headers, timeout=timeout)
+        return await self._client.options(url, headers=headers)
 
     async def patch(
         self,
         url: str,
         headers: Headers | Mapping[str, str] | Iterable[tuple[str, str]] | None = None,
         content: bytes | AsyncIterator[bytes] | None = None,
-        timeout: float | None = None,
     ) -> FullResponse:
         """Executes a PATCH HTTP request.
 
@@ -144,22 +145,20 @@ class Client:
             url: The unencoded request URL.
             headers: The request headers.
             content: The request content.
-            timeout: The timeout for the request in seconds.
 
         Raises:
             ConnectionError: If the connection fails.
             TimeoutError: If the request times out.
+            ReadError: If an error occurs reading the response.
+            WriteError: If an error occurs writing the request.
         """
-        return await self._client.patch(
-            url, headers=headers, content=content, timeout=timeout
-        )
+        return await self._client.patch(url, headers=headers, content=content)
 
     async def put(
         self,
         url: str,
         headers: Headers | Mapping[str, str] | Iterable[tuple[str, str]] | None = None,
         content: bytes | AsyncIterator[bytes] | None = None,
-        timeout: float | None = None,
     ) -> FullResponse:
         """Executes a PUT HTTP request.
 
@@ -167,15 +166,14 @@ class Client:
             url: The unencoded request URL.
             headers: The request headers.
             content: The request content.
-            timeout: The timeout for the request in seconds.
 
         Raises:
             ConnectionError: If the connection fails.
             TimeoutError: If the request times out.
+            ReadError: If an error occurs reading the response.
+            WriteError: If an error occurs writing the request.
         """
-        return await self._client.put(
-            url, headers=headers, content=content, timeout=timeout
-        )
+        return await self._client.put(url, headers=headers, content=content)
 
     async def execute(
         self,
@@ -183,7 +181,6 @@ class Client:
         url: str,
         headers: Headers | Mapping[str, str] | Iterable[tuple[str, str]] | None = None,
         content: bytes | AsyncIterator[bytes] | None = None,
-        timeout: float | None = None,
     ) -> FullResponse:
         """Executes an HTTP request, returning the full buffered response.
 
@@ -192,15 +189,14 @@ class Client:
             url: The unencoded request URL.
             headers: The request headers.
             content: The request content.
-            timeout: The timeout for the request in seconds.
 
         Raises:
             ConnectionError: If the connection fails.
             TimeoutError: If the request times out.
+            ReadError: If an error occurs reading the response.
+            WriteError: If an error occurs writing the request.
         """
-        return await self._client.execute(
-            method, url, headers=headers, content=content, timeout=timeout
-        )
+        return await self._client.execute(method, url, headers=headers, content=content)
 
     @asynccontextmanager
     async def stream(
@@ -209,7 +205,6 @@ class Client:
         url: str,
         headers: Headers | Mapping[str, str] | Iterable[tuple[str, str]] | None = None,
         content: bytes | AsyncIterator[bytes] | None = None,
-        timeout: float | None = None,
     ) -> AsyncIterator[Response]:
         """Executes an HTTP request, allowing the response content to be streamed.
 
@@ -218,14 +213,15 @@ class Client:
             url: The unencoded request URL.
             headers: The request headers.
             content: The request content.
-            timeout: The timeout for the request in seconds.
 
         Raises:
             ConnectionError: If the connection fails.
             TimeoutError: If the request times out.
+            ReadError: If an error occurs reading the response.
+            WriteError: If an error occurs writing the request.
         """
         response = await self._client.stream(
-            method, url, headers=headers, content=content, timeout=timeout
+            method, url, headers=headers, content=content
         )
         async with response:
             yield response

pyqwest/_pyqwest.pyi

@@ -1,3 +1,4 @@
+import datetime
 from collections.abc import (
     AsyncIterator,
     Awaitable,
@@ -29,7 +30,10 @@ class Headers:
     """
 
     def __init__(
-        self, items: Mapping[str, str] | Iterable[tuple[str, str]] | None = None
+        self,
+        items: Mapping[str | HTTPHeaderName, str]
+        | Iterable[tuple[str | HTTPHeaderName, str]]
+        | None = None,
     ) -> None:
         """Creates a new Headers object.
 
@@ -37,7 +41,7 @@ class Headers:
             items: Initial headers to add.
         """
 
-    def __getitem__(self, key: str) -> str:
+    def __getitem__(self, key: str | HTTPHeaderName) -> str:
         """Return the header value for the key.
 
         If multiple values are present for the key, returns the first value.
@@ -49,7 +53,7 @@ class Headers:
             KeyError: If the key is not present.
         """
 
-    def __setitem__(self, key: str, value: str) -> None:
+    def __setitem__(self, key: str | HTTPHeaderName, value: str) -> None:
         """Sets the header value for the key, replacing any existing values.
 
         Args:
@@ -57,7 +61,7 @@ class Headers:
             value: The header value.
         """
 
-    def __delitem__(self, key: str) -> None:
+    def __delitem__(self, key: str | HTTPHeaderName) -> None:
         """Deletes all values for the key.
 
         Args:
@@ -81,7 +85,7 @@ class Headers:
             other: The object to compare against.
         """
 
-    def get(self, key: str, default: str | None = None) -> str | None:
+    def get(self, key: str | HTTPHeaderName, default: str | None = None) -> str | None:
         """Returns the header value for the key, or default if not present.
 
         Args:
@@ -90,7 +94,7 @@ class Headers:
         """
 
     @overload
-    def pop(self, key: str) -> str:
+    def pop(self, key: str | HTTPHeaderName) -> str:
         """Removes and returns the header value for the key.
 
         Args:
@@ -101,7 +105,7 @@ class Headers:
         """
 
     @overload
-    def pop(self, key: str, default: _T) -> str | _T:
+    def pop(self, key: str | HTTPHeaderName, default: _T) -> str | _T:
         """Removes and returns the header value for the key, or default if not present.
 
         Args:
@@ -117,7 +121,7 @@ class Headers:
             KeyError: If the headers are empty.
         """
 
-    def setdefault(self, key: str, default: str | None = None) -> str:
+    def setdefault(self, key: str | HTTPHeaderName, default: str | None = None) -> str:
         """If the key is not present, sets it to the default value.
         Returns the value for the key.
 
@@ -126,7 +130,7 @@ class Headers:
             default: The default value to set and return if the key is not present.
         """
 
-    def add(self, key: str, value: str) -> None:
+    def add(self, key: str | HTTPHeaderName, value: str) -> None:
         """Adds a header value for the key. Existing values are preserved.
 
         Args:
@@ -143,7 +147,11 @@ class Headers:
         """
     @overload
     def update(
-        self, items: Mapping[str, str] | Iterable[tuple[str, str]], /, **kwargs: str
+        self,
+        items: Mapping[str | HTTPHeaderName, str]
+        | Iterable[tuple[str | HTTPHeaderName, str]],
+        /,
+        **kwargs: str,
     ) -> None:
         """Updates headers with the provided items. Existing values are replaced.
 
@@ -155,7 +163,7 @@ class Headers:
     def clear(self) -> None:
         """Removes all headers."""
 
-    def getall(self, key: str) -> Sequence[str]:
+    def getall(self, key: str | HTTPHeaderName) -> Sequence[str]:
         """Returns all header values for the key.
 
         Args:
@@ -190,10 +198,20 @@ class HTTPVersion:
     HTTP3: HTTPVersion
     """HTTP/3"""
 
+    def __eq__(self, other: object) -> bool: ...
+    def __ne__(self, other: object) -> bool: ...
+    def __lt__(self, other: object) -> bool: ...
+    def __le__(self, other: object) -> bool: ...
+    def __gt__(self, other: object) -> bool: ...
+    def __ge__(self, other: object) -> bool: ...
+
 class Client:
     def __init__(self, transport: Transport | None = None) -> None:
         """Creates a new asynchronous HTTP client.
 
+        The asynchronous client does not expose per-request timeouts on its methods.
+        Use `asyncio.wait_for` or similar to enforce timeouts on requests.
+
         Args:
             transport: The transport to use for requests. If None, the shared default
                        transport will be used.
@@ -203,14 +221,12 @@ class Client:
         self,
         url: str,
         headers: Headers | Mapping[str, str] | Iterable[tuple[str, str]] | None = None,
-        timeout: float | None = None,
     ) -> Awaitable[FullResponse]:
         """Executes a GET HTTP request.
 
         Args:
             url: The unencoded request URL.
             headers: The request headers.
-            timeout: The timeout for the request in seconds.
 
         Raises:
             ConnectionError: If the connection fails.
@@ -224,7 +240,6 @@ class Client:
         url: str,
         headers: Headers | Mapping[str, str] | Iterable[tuple[str, str]] | None = None,
         content: bytes | AsyncIterator[bytes] | None = None,
-        timeout: float | None = None,
     ) -> Awaitable[FullResponse]:
         """Executes a POST HTTP request.
 
@@ -232,7 +247,6 @@ class Client:
             url: The unencoded request URL.
             headers: The request headers.
             content: The request content.
-            timeout: The timeout for the request in seconds.
 
         Raises:
             ConnectionError: If the connection fails.
@@ -245,14 +259,12 @@ class Client:
         self,
         url: str,
         headers: Headers | Mapping[str, str] | Iterable[tuple[str, str]] | None = None,
-        timeout: float | None = None,
     ) -> Awaitable[FullResponse]:
         """Executes a DELETE HTTP request.
 
         Args:
             url: The unencoded request URL.
             headers: The request headers.
-            timeout: The timeout for the request in seconds.
 
         Raises:
             ConnectionError: If the connection fails.
@@ -265,14 +277,12 @@ class Client:
         self,
         url: str,
         headers: Headers | Mapping[str, str] | Iterable[tuple[str, str]] | None = None,
-        timeout: float | None = None,
     ) -> Awaitable[FullResponse]:
         """Executes a HEAD HTTP request.
 
         Args:
             url: The unencoded request URL.
             headers: The request headers.
-            timeout: The timeout for the request in seconds.
 
         Raises:
             ConnectionError: If the connection fails.
@@ -285,14 +295,12 @@ class Client:
         self,
         url: str,
         headers: Headers | Mapping[str, str] | Iterable[tuple[str, str]] | None = None,
-        timeout: float | None = None,
     ) -> Awaitable[FullResponse]:
         """Executes a OPTIONS HTTP request.
 
         Args:
             url: The unencoded request URL.
             headers: The request headers.
-            timeout: The timeout for the request in seconds.
 
         Raises:
             ConnectionError: If the connection fails.
@@ -306,7 +314,6 @@ class Client:
         url: str,
         headers: Headers | Mapping[str, str] | Iterable[tuple[str, str]] | None = None,
         content: bytes | AsyncIterator[bytes] | None = None,
-        timeout: float | None = None,
     ) -> Awaitable[FullResponse]:
         """Executes a PATCH HTTP request.
 
@@ -328,7 +335,6 @@ class Client:
         url: str,
         headers: Headers | Mapping[str, str] | Iterable[tuple[str, str]] | None = None,
         content: bytes | AsyncIterator[bytes] | None = None,
-        timeout: float | None = None,
     ) -> Awaitable[FullResponse]:
         """Executes a PUT HTTP request.
 
@@ -336,7 +342,6 @@ class Client:
             url: The unencoded request URL.
             headers: The request headers.
             content: The request content.
-            timeout: The timeout for the request in seconds.
 
         Raises:
             ConnectionError: If the connection fails.
@@ -351,7 +356,6 @@ class Client:
         url: str,
         headers: Headers | Mapping[str, str] | Iterable[tuple[str, str]] | None = None,
         content: bytes | AsyncIterator[bytes] | None = None,
-        timeout: float | None = None,
     ) -> Awaitable[FullResponse]:
         """Executes an HTTP request, returning the full buffered response.
 
@@ -360,7 +364,6 @@ class Client:
             url: The unencoded request URL.
             headers: The request headers.
             content: The request content.
-            timeout: The timeout for the request in seconds.
 
         Raises:
             ConnectionError: If the connection fails.
@@ -375,7 +378,6 @@ class Client:
         url: str,
         headers: Headers | Mapping[str, str] | Iterable[tuple[str, str]] | None = None,
         content: bytes | AsyncIterator[bytes] | None = None,
-        timeout: float | None = None,
     ) -> Awaitable[Response]:
         """Executes an HTTP request, allowing the response content to be streamed.
 
@@ -384,7 +386,6 @@ class Client:
             url: The unencoded request URL.
             headers: The request headers.
             content: The request content.
-            timeout: The timeout for the request in seconds.
 
         Raises:
             ConnectionError: If the connection fails.
@@ -1130,3 +1131,260 @@ class ReadError(Exception):
 
 class WriteError(Exception):
     """An error representing a write error during request sending."""
+
+class HTTPHeaderName:
+    """An enum type corresponding to HTTP header names."""
+
+    def __init__(self, name: str) -> None:
+        """Creates a new HTTPHeaderName. When available, prefer one of the
+        class attributes.
+
+        Args:
+            name: The header name.
+        """
+
+    ACCEPT: HTTPHeaderName
+    """The "accept" header."""
+
+    ACCEPT_CHARSET: HTTPHeaderName
+    """The "accept-charset" header."""
+
+    ACCEPT_ENCODING: HTTPHeaderName
+    """The "accept-encoding" header."""
+
+    ACCEPT_LANGUAGE: HTTPHeaderName
+    """The "accept-language" header."""
+
+    ACCEPT_RANGES: HTTPHeaderName
+    """The "accept-ranges" header."""
+
+    ACCESS_CONTROL_ALLOW_CREDENTIALS: HTTPHeaderName
+    """The "access-control-allow-credentials" header."""
+
+    ACCESS_CONTROL_ALLOW_HEADERS: HTTPHeaderName
+    """The "access-control-allow-headers" header."""
+
+    ACCESS_CONTROL_ALLOW_METHODS: HTTPHeaderName
+    """The "access-control-allow-methods" header."""
+
+    ACCESS_CONTROL_ALLOW_ORIGIN: HTTPHeaderName
+    """The "access-control-allow-origin" header."""
+
+    ACCESS_CONTROL_EXPOSE_HEADERS: HTTPHeaderName
+    """The "access-control-expose-headers" header."""
+
+    ACCESS_CONTROL_MAX_AGE: HTTPHeaderName
+    """The "access-control-max-age" header."""
+
+    ACCESS_CONTROL_REQUEST_HEADERS: HTTPHeaderName
+    """The "access-control-request-headers" header."""
+
+    ACCESS_CONTROL_REQUEST_METHOD: HTTPHeaderName
+    """The "access-control-request-method" header."""
+
+    AGE: HTTPHeaderName
+    """The "age" header."""
+
+    ALLOW: HTTPHeaderName
+    """The "allow" header."""
+
+    ALT_SVC: HTTPHeaderName
+    """The "alt-svc" header."""
+
+    AUTHORIZATION: HTTPHeaderName
+    """The "authorization" header."""
+
+    CACHE_CONTROL: HTTPHeaderName
+    """The "cache-control" header."""
+
+    CACHE_STATUS: HTTPHeaderName
+    """The "cache-status" header."""
+
+    CDN_CACHE_CONTROL: HTTPHeaderName
+    """The "cdn-cache-control" header."""
+
+    CONNECTION: HTTPHeaderName
+    """The "connection" header."""
+
+    CONTENT_DISPOSITION: HTTPHeaderName
+    """The "content-disposition" header."""
+
+    CONTENT_ENCODING: HTTPHeaderName
+    """The "content-encoding" header."""
+
+    CONTENT_LANGUAGE: HTTPHeaderName
+    """The "content-language" header."""
+
+    CONTENT_LENGTH: HTTPHeaderName
+    """The "content-length" header."""
+
+    CONTENT_LOCATION: HTTPHeaderName
+    """The "content-location" header."""
+
+    CONTENT_RANGE: HTTPHeaderName
+    """The "content-range" header."""
+
+    CONTENT_SECURITY_POLICY: HTTPHeaderName
+    """The "content-security-policy" header."""
+
+    CONTENT_SECURITY_POLICY_REPORT_ONLY: HTTPHeaderName
+    """The "content-security-policy-report-only" header."""
+
+    CONTENT_TYPE: HTTPHeaderName
+    """The "content-type" header."""
+
+    COOKIE: HTTPHeaderName
+    """The "cookie" header."""
+
+    DNT: HTTPHeaderName
+    """The "dnt" header."""
+
+    DATE: HTTPHeaderName
+    """The "date" header."""
+
+    ETAG: HTTPHeaderName
+    """The "etag" header."""
+
+    EXPECT: HTTPHeaderName
+    """The "expect" header."""
+
+    EXPIRES: HTTPHeaderName
+    """The "expires" header."""
+
+    FORWARDED: HTTPHeaderName
+    """The "forwarded" header."""
+
+    FROM: HTTPHeaderName
+    """The "from" header."""
+
+    HOST: HTTPHeaderName
+    """The "host" header."""
+
+    IF_MATCH: HTTPHeaderName
+    """The "if-match" header."""
+
+    IF_MODIFIED_SINCE: HTTPHeaderName
+    """The "if-modified-since" header."""
+
+    IF_NONE_MATCH: HTTPHeaderName
+    """The "if-none-match" header."""
+
+    IF_RANGE: HTTPHeaderName
+    """The "if-range" header."""
+
+    IF_UNMODIFIED_SINCE: HTTPHeaderName
+    """The "if-unmodified-since" header."""
+
+    LAST_MODIFIED: HTTPHeaderName
+    """The "last-modified" header."""
+
+    LINK: HTTPHeaderName
+    """The "link" header."""
+
+    LOCATION: HTTPHeaderName
+    """The "location" header."""
+
+    MAX_FORWARDS: HTTPHeaderName
+    """The "max-forwards" header."""
+
+    ORIGIN: HTTPHeaderName
+    """The "origin" header."""
+
+    PRAGMA: HTTPHeaderName
+    """The "pragma" header."""
+
+    PROXY_AUTHENTICATE: HTTPHeaderName
+    """The "proxy-authenticate" header."""
+
+    PROXY_AUTHORIZATION: HTTPHeaderName
+    """The "proxy-authorization" header."""
+
+    PUBLIC_KEY_PINS: HTTPHeaderName
+    """The "public-key-pins" header."""
+
+    PUBLIC_KEY_PINS_REPORT_ONLY: HTTPHeaderName
+    """The "public-key-pins-report-only" header."""
+
+    RANGE: HTTPHeaderName
+    """The "range" header."""
+
+    REFERER: HTTPHeaderName
+    """The "referer" header."""
+
+    REFERRER_POLICY: HTTPHeaderName
+    """The "referrer-policy" header."""
+
+    REFRESH: HTTPHeaderName
+    """The "refresh" header."""
+
+    RETRY_AFTER: HTTPHeaderName
+    """The "retry-after" header."""
+
+    SEC_WEBSOCKET_ACCEPT: HTTPHeaderName
+    """The "sec-websocket-accept" header."""
+
+    SEC_WEBSOCKET_EXTENSIONS: HTTPHeaderName
+    """The "sec-websocket-extensions" header."""
+
+    SEC_WEBSOCKET_KEY: HTTPHeaderName
+    """The "sec-websocket-key" header."""
+
+    SEC_WEBSOCKET_PROTOCOL: HTTPHeaderName
+    """The "sec-websocket-protocol" header."""
+
+    SEC_WEBSOCKET_VERSION: HTTPHeaderName
+    """The "sec-websocket-version" header."""
+
+    SERVER: HTTPHeaderName
+    """The "server" header."""
+
+    SET_COOKIE: HTTPHeaderName
+    """The "set-cookie" header."""
+
+    STRICT_TRANSPORT_SECURITY: HTTPHeaderName
+    """The "strict-transport-security" header."""
+
+    TE: HTTPHeaderName
+    """The "te" header."""
+
+    TRAILER: HTTPHeaderName
+    """The "trailer" header."""
+
+    TRANSFER_ENCODING: HTTPHeaderName
+    """The "transfer-encoding" header."""
+
+    USER_AGENT: HTTPHeaderName
+    """The "user-agent" header."""
+
+    UPGRADE: HTTPHeaderName
+    """The "upgrade" header."""
+
+    UPGRADE_INSECURE_REQUESTS: HTTPHeaderName
+    """The "upgrade-insecure-requests" header."""
+
+    VARY: HTTPHeaderName
+    """The "vary" header."""
+
+    VIA: HTTPHeaderName
+    """The "via" header."""
+
+    WARNING: HTTPHeaderName
+    """The "warning" header."""
+
+    WWW_AUTHENTICATE: HTTPHeaderName
+    """The "www-authenticate" header."""
+
+    X_CONTENT_TYPE_OPTIONS: HTTPHeaderName
+    """The "x-content-type-options" header."""
+
+    X_DNS_PREFETCH_CONTROL: HTTPHeaderName
+    """The "x-dns-prefetch-control" header."""
+
+    X_FRAME_OPTIONS: HTTPHeaderName
+    """The "x-frame-options" header."""
+
+    X_XSS_PROTECTION: HTTPHeaderName
+    """The "x-xss-protection" header."""
+
+def set_sync_timeout(timeout: float) -> AbstractContextManager[None]: ...
+def get_sync_timeout() -> datetime.timedelta | None: ...

pyqwest/testing/_asgi.py

@@ -2,7 +2,6 @@ from __future__ import annotations
 
 import asyncio
 import contextlib
-import math
 from collections.abc import AsyncIterator
 from dataclasses import dataclass
 from typing import TYPE_CHECKING, Any
@@ -160,14 +159,9 @@ class ASGITransport(Transport):
         async def send(message: ASGISendEvent) -> None:
             await send_queue.put(message)
 
-        timeout: float | None = request._timeout  # pyright: ignore[reportAttributeAccessIssue]  # noqa: SLF001
-        if timeout is not None and (timeout < 0 or not math.isfinite(timeout)):
-            msg = "Timeout must be non-negative"
-            raise ValueError(msg)
-
         async def run_app() -> None:
             try:
-                await asyncio.wait_for(self._app(scope, receive, send), timeout=timeout)
+                await self._app(scope, receive, send)
             except asyncio.TimeoutError as e:
                 send_queue.put_nowait(TimeoutError(str(e)))
             except Exception as e:

pyqwest/testing/_wsgi.py

@@ -1,7 +1,6 @@
 from __future__ import annotations
 
 import contextlib
-import math
 import threading
 import time
 from collections.abc import Callable, Iterator
@@ -19,10 +18,10 @@ from pyqwest import (
     SyncTransport,
     WriteError,
 )
+from pyqwest._pyqwest import get_sync_timeout
 
 if TYPE_CHECKING:
     import sys
-    from types import TracebackType
 
     if sys.version_info >= (3, 11):
         from wsgiref.types import WSGIApplication, WSGIEnvironment
@@ -31,12 +30,21 @@ if TYPE_CHECKING:
 
 _UNSET_STATUS = "unset"
 
+_DEFAULT_EXECUTOR: ThreadPoolExecutor | None = None
+
+
+def get_default_executor() -> ThreadPoolExecutor:
+    global _DEFAULT_EXECUTOR  # noqa: PLW0603
+    if _DEFAULT_EXECUTOR is None:
+        _DEFAULT_EXECUTOR = ThreadPoolExecutor()
+    return _DEFAULT_EXECUTOR
+
 
 class WSGITransport(SyncTransport):
+    """Transport implementation that directly invokes a WSGI application. Useful for testing."""
+
     _app: WSGIApplication
     _http_version: HTTPVersion
-    _executor: ThreadPoolExecutor
-    _close_executor: bool
     _closed: bool
 
     def __init__(
@@ -45,23 +53,23 @@ class WSGITransport(SyncTransport):
         http_version: HTTPVersion = HTTPVersion.HTTP2,
         executor: ThreadPoolExecutor | None = None,
     ) -> None:
+        """Creates a new WSGI transport.
+
+        Args:
+            app: The WSGI application to invoke for requests.
+            http_version: The HTTP version to simulate for requests.
+            executor: An optional ThreadPoolExecutor to use for running the WSGI app.
+                      If not provided, a default executor will be used.
+        """
         self._app = app
         self._http_version = http_version
-        if executor is None:
-            self._executor = ThreadPoolExecutor()
-            self._close_executor = True
-        else:
-            self._executor = executor
-            self._close_executor = False
+        self._executor = executor or get_default_executor()
         self._closed = False
 
     def execute_sync(self, request: SyncRequest) -> SyncResponse:
-        timeout: float | None = request._timeout  # pyright: ignore[reportAttributeAccessIssue]  # noqa: SLF001
-        if timeout is not None and (timeout < 0 or not math.isfinite(timeout)):
-            msg = "Timeout must be non-negative"
-            raise ValueError(msg)
-
-        deadline = time.monotonic() + timeout if timeout is not None else None
+        deadline = None
+        if (to := get_sync_timeout()) is not None:
+            deadline = time.monotonic() + to.total_seconds()
 
         parsed_url = urlparse(request.url)
         raw_path = parsed_url.path or "/"
@@ -205,24 +213,6 @@ class WSGITransport(SyncTransport):
             trailers=trailers,
         )
 
-    def __enter__(self) -> WSGITransport:
-        return self
-
-    def __exit__(
-        self,
-        _exc_type: type[BaseException] | None,
-        _exc_value: BaseException | None,
-        _traceback: TracebackType | None,
-    ) -> None:
-        self.close()
-
-    def close(self) -> None:
-        if self._closed:
-            return
-        self._closed = True
-        if self._close_executor:
-            self._executor.shutdown()
-
 
 class RequestInput:
     def __init__(self, content: Iterator[bytes], http_version: HTTPVersion) -> None:

{pyqwest-0.2.0.dist-info → pyqwest-0.3.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pyqwest
-Version: 0.2.0
+Version: 0.3.0
 Classifier: Development Status :: 3 - Alpha
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: MIT License

pyqwest-0.3.0.dist-info/RECORD

@@ -0,0 +1,16 @@
+pyqwest\__init__.py,sha256=TqZ4ioJhL_RsgALEnb3iChY7gb9ysWc4cUA0k9rsjXI,902
+pyqwest\_coro.py,sha256=k5vVz1zeg9HQYvbbhAg9WnYiBHskkJ3Qdqfmx16HcVs,7867
+pyqwest\_glue.py,sha256=gk--twq1LRc-tsaDVwcIxcwPmaMz5kt94QQGJ0fTNFw,2530
+pyqwest\_pyqwest.cp313-win_amd64.pyd,sha256=rOryCv_cI2gWl-z7bV3x1obl3JySa2v3duIj1AvZXWU,11907584
+pyqwest\_pyqwest.pyi,sha256=QFGjqouSggefDP6lZH-bJ2aQbEJbJI7dTuREdLOwaIc,45175
+pyqwest\httpx\__init__.py,sha256=4DJZ0AMFfuScGLkd9ktwGMypll7RW6VhAMenwcEWkDw,157
+pyqwest\httpx\_transport.py,sha256=3Os8YB3Wq9dFvvYugMsXKmpM6JmuUSuSbTzBbOSf-Uw,9378
+pyqwest\py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+pyqwest\testing\__init__.py,sha256=oNW9UbowpENKwUt0QvBzHFWLWq4_7b1LMfMz3QmftQE,148
+pyqwest\testing\_asgi.py,sha256=SXYcCTmND2b-SDn18Kf8qDcBwjhh2SejD_fEs6Zz2Qs,12203
+pyqwest\testing\_asgi_compatibility.py,sha256=30rCjvyLg5L9x4vyI0LS8oqPtfY4oLctINJgqMzgLDU,3206
+pyqwest\testing\_wsgi.py,sha256=I8IZ8Dekwj_-OxiHqGZqPJP0sZs4-EywU2GELcWo_Bg,12313
+pyqwest-0.3.0.dist-info\METADATA,sha256=9g9EE8GB_Qbyl-BRDYHmNsylvR0u1jrZookvPz9CLQ4,886
+pyqwest-0.3.0.dist-info\WHEEL,sha256=n_BmF69IyGtioVWE9c3M_zsEfe6-xMZy1v5HCL_6qE0,97
+pyqwest-0.3.0.dist-info\licenses\LICENSE,sha256=e7sDs6pM-apXvhJO1bLtzngKeI1aQ6bDIyJxO7Sgv1E,1085
+pyqwest-0.3.0.dist-info\RECORD,,

pyqwest-0.2.0.dist-info/RECORD

@@ -1,16 +0,0 @@
-pyqwest\__init__.py,sha256=-u46hIqP0IGssz_qZUt2MlH7XZmK4FyRlKic8Tghjvo,860
-pyqwest\_coro.py,sha256=9Kkeyk9gA8fzFpGHhhjAz63msb98J4tuIQMPpDCOm3Y,7636
-pyqwest\_glue.py,sha256=gk--twq1LRc-tsaDVwcIxcwPmaMz5kt94QQGJ0fTNFw,2530
-pyqwest\_pyqwest.cp313-win_amd64.pyd,sha256=DLHi18Xl0Eq1pxCD2Y_-xEEHlrIxcnWzqdNWtUqVjE4,10728960
-pyqwest\_pyqwest.pyi,sha256=RkpFULa9imDZwej6D4v_yprlALlp0ngTcxu5nKWpc6I,38756
-pyqwest\httpx\__init__.py,sha256=4DJZ0AMFfuScGLkd9ktwGMypll7RW6VhAMenwcEWkDw,157
-pyqwest\httpx\_transport.py,sha256=3Os8YB3Wq9dFvvYugMsXKmpM6JmuUSuSbTzBbOSf-Uw,9378
-pyqwest\py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-pyqwest\testing\__init__.py,sha256=oNW9UbowpENKwUt0QvBzHFWLWq4_7b1LMfMz3QmftQE,148
-pyqwest\testing\_asgi.py,sha256=Jxd2cNG_DbYbUenW2LiV3Uc5x9d5ynUD7YISWiu7owU,12526
-pyqwest\testing\_asgi_compatibility.py,sha256=30rCjvyLg5L9x4vyI0LS8oqPtfY4oLctINJgqMzgLDU,3206
-pyqwest\testing\_wsgi.py,sha256=IgNpv6cGV-z1Mrrn8p2xh8XWsEOPEl5JVtuYyi57LsM,12464
-pyqwest-0.2.0.dist-info\METADATA,sha256=mHLRxgcqJckHC26TYH0gMeTi4_hvhjO5LAhh___pbMk,886
-pyqwest-0.2.0.dist-info\WHEEL,sha256=n_BmF69IyGtioVWE9c3M_zsEfe6-xMZy1v5HCL_6qE0,97
-pyqwest-0.2.0.dist-info\licenses\LICENSE,sha256=e7sDs6pM-apXvhJO1bLtzngKeI1aQ6bDIyJxO7Sgv1E,1085
-pyqwest-0.2.0.dist-info\RECORD,,