httpr 0.2.5__cp314-cp314t-manylinux_2_17_armv7l.manylinux2014_armv7l.whl

httpr/__init__.py

@@ -0,0 +1,1066 @@
+"""
+httpr - Blazing fast HTTP client for Python, built in Rust.
+
+httpr is a high-performance HTTP client that can be used as a drop-in replacement
+for `httpx` and `requests` in most cases.
+
+Example:
+    Simple GET request:
+
+    ```python
+    import httpr
+
+    response = httpr.get("https://httpbin.org/get")
+    print(response.json())
+    ```
+
+    Using a client for connection pooling:
+
+    ```python
+    import httpr
+
+    with httpr.Client() as client:
+        response = client.get("https://httpbin.org/get")
+        print(response.status_code)
+    ```
+"""
+
+from __future__ import annotations
+
+import asyncio
+import sys
+from collections.abc import AsyncIterator, Generator
+from contextlib import asynccontextmanager, contextmanager
+from functools import partial
+from typing import TYPE_CHECKING, TypedDict
+
+if sys.version_info <= (3, 11):
+    from typing_extensions import Unpack
+else:
+    from typing import Unpack
+
+
+from .httpr import CaseInsensitiveHeaderMap, RClient, Response, StreamingResponse
+
+if TYPE_CHECKING:
+    from .httpr import ClientRequestParams, HttpMethod, RequestParams
+else:
+
+    class _Unpack:
+        @staticmethod
+        def __getitem__(*args, **kwargs):
+            pass
+
+    Unpack = _Unpack()
+    RequestParams = ClientRequestParams = TypedDict
+
+
+class Client(RClient):
+    """
+    A synchronous HTTP client with connection pooling.
+
+    The Client class provides a high-level interface for making HTTP requests.
+    It supports connection pooling, automatic cookie handling, and various
+    authentication methods.
+
+    Example:
+        Basic usage:
+
+        ```python
+        import httpr
+
+        # Using context manager (recommended)
+        with httpr.Client() as client:
+            response = client.get("https://httpbin.org/get")
+            print(response.json())
+
+        # Or manually
+        client = httpr.Client()
+        response = client.get("https://httpbin.org/get")
+        client.close()
+        ```
+
+        With configuration:
+
+        ```python
+        import httpr
+
+        client = httpr.Client(
+            auth_bearer="your-api-token",
+            headers={"User-Agent": "my-app/1.0"},
+            timeout=30,
+        )
+        ```
+
+    Attributes:
+        headers: Default headers sent with all requests. Excludes Cookie header.
+        cookies: Default cookies sent with all requests.
+        auth: Basic auth credentials as (username, password) tuple.
+        params: Default query parameters added to all requests.
+        timeout: Default timeout in seconds.
+        proxy: Proxy URL for requests.
+    """
+
+    def __init__(
+        self,
+        auth: tuple[str, str | None] | None = None,
+        auth_bearer: str | None = None,
+        params: dict[str, str] | None = None,
+        headers: dict[str, str] | None = None,
+        cookies: dict[str, str] | None = None,
+        cookie_store: bool | None = True,
+        referer: bool | None = True,
+        proxy: str | None = None,
+        timeout: float | None = 30,
+        follow_redirects: bool | None = True,
+        max_redirects: int | None = 20,
+        verify: bool | None = True,
+        ca_cert_file: str | None = None,
+        client_pem: str | None = None,
+        https_only: bool | None = False,
+        http2_only: bool | None = False,
+    ):
+        """
+        Initialize an HTTP client.
+
+        Args:
+            auth: Basic auth credentials as (username, password). Password can be None.
+            auth_bearer: Bearer token for Authorization header.
+            params: Default query parameters to include in all requests.
+            headers: Default headers to send with all requests.
+            cookies: Default cookies to send with all requests.
+            cookie_store: Enable persistent cookie store. Cookies from responses will be
+                preserved and included in subsequent requests. Default is True.
+            referer: Automatically set Referer header. Default is True.
+            proxy: Proxy URL (e.g., "http://proxy:8080" or "socks5://127.0.0.1:1080").
+                Falls back to HTTPR_PROXY environment variable.
+            timeout: Request timeout in seconds. Default is 30.
+            follow_redirects: Follow HTTP redirects. Default is True.
+            max_redirects: Maximum redirects to follow. Default is 20.
+            verify: Verify SSL certificates. Default is True.
+            ca_cert_file: Path to CA certificate bundle (PEM format).
+            client_pem: Path to client certificate for mTLS (PEM format).
+            https_only: Only allow HTTPS requests. Default is False.
+            http2_only: Use HTTP/2 only (False uses HTTP/1.1). Default is False.
+
+        Example:
+            ```python
+            import httpr
+
+            # Simple client
+            client = httpr.Client()
+
+            # Client with authentication
+            client = httpr.Client(
+                auth=("username", "password"),
+                timeout=60,
+            )
+
+            # Client with bearer token
+            client = httpr.Client(
+                auth_bearer="your-api-token",
+                headers={"Accept": "application/json"},
+            )
+
+            # Client with proxy
+            client = httpr.Client(proxy="http://proxy.example.com:8080")
+
+            # Client with mTLS
+            client = httpr.Client(
+                client_pem="/path/to/client.pem",
+                ca_cert_file="/path/to/ca.pem",
+            )
+            ```
+        """
+        super().__init__()
+
+    def __enter__(self) -> Client:
+        """Enter context manager."""
+        return self
+
+    def __exit__(self, *args):
+        """Exit context manager and close client."""
+        del self
+
+    def close(self) -> None:
+        """
+        Close the client and release resources.
+
+        Example:
+            ```python
+            client = httpr.Client()
+            try:
+                response = client.get("https://example.com")
+            finally:
+                client.close()
+            ```
+        """
+        del self
+
+    def request(
+        self,
+        method: HttpMethod,
+        url: str,
+        **kwargs: Unpack[RequestParams],
+    ) -> Response:
+        """
+        Make an HTTP request.
+
+        Args:
+            method: HTTP method (GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS).
+            url: Request URL.
+            **kwargs: Request parameters (see below).
+
+        Keyword Args:
+            params (dict[str, str] | None): Query parameters to append to URL.
+            headers (dict[str, str] | None): Request headers (merged with client defaults).
+            cookies (dict[str, str] | None): Request cookies (merged with client defaults).
+            auth (tuple[str, str | None] | None): Basic auth credentials (overrides client default).
+            auth_bearer (str | None): Bearer token (overrides client default).
+            timeout (float | None): Request timeout in seconds (overrides client default).
+            content (bytes | None): Raw bytes for request body.
+            data (dict[str, Any] | None): Form data for request body (application/x-www-form-urlencoded).
+            json (Any | None): JSON data for request body (application/json).
+            files (dict[str, str] | None): Files for multipart upload (dict mapping field names to file paths).
+
+        Returns:
+            Response object with status, headers, and body.
+
+        Raises:
+            ValueError: If method is not a valid HTTP method.
+            Exception: If request fails (timeout, connection error, etc.).
+
+        Example:
+            ```python
+            response = client.request("GET", "https://httpbin.org/get")
+            response = client.request("POST", "https://httpbin.org/post", json={"key": "value"})
+            ```
+
+        Note:
+            Only one of `content`, `data`, `json`, or `files` can be specified per request.
+        """
+        if method not in ["GET", "HEAD", "OPTIONS", "DELETE", "POST", "PUT", "PATCH"]:
+            raise ValueError(f"Unsupported HTTP method: {method}")
+        if "params" in kwargs and kwargs["params"] is not None:
+            kwargs["params"] = {k: str(v) for k, v in kwargs["params"].items()}
+
+        return super().request(method=method, url=url, **kwargs)
+
+    def get(self, url: str, **kwargs: Unpack[RequestParams]) -> Response:
+        """
+        Make a GET request.
+
+        Args:
+            url: Request URL.
+            **kwargs: Request parameters (params, headers, cookies, auth, auth_bearer, timeout).
+
+        Returns:
+            Response object.
+
+        Example:
+            ```python
+            response = client.get(
+                "https://httpbin.org/get",
+                params={"key": "value"},
+                headers={"Accept": "application/json"},
+            )
+            print(response.json())
+            ```
+        """
+        return self.request(method="GET", url=url, **kwargs)
+
+    def head(self, url: str, **kwargs: Unpack[RequestParams]) -> Response:
+        """
+        Make a HEAD request.
+
+        Returns only headers, no response body.
+
+        Args:
+            url: Request URL.
+            **kwargs: Request parameters (params, headers, cookies, auth, auth_bearer, timeout).
+
+        Returns:
+            Response object (body will be empty).
+
+        Example:
+            ```python
+            response = client.head("https://httpbin.org/get")
+            print(response.headers["content-length"])
+            ```
+        """
+        return self.request(method="HEAD", url=url, **kwargs)
+
+    def options(self, url: str, **kwargs: Unpack[RequestParams]) -> Response:
+        """
+        Make an OPTIONS request.
+
+        Args:
+            url: Request URL.
+            **kwargs: Request parameters (params, headers, cookies, auth, auth_bearer, timeout).
+
+        Returns:
+            Response object.
+
+        Example:
+            ```python
+            response = client.options("https://httpbin.org/get")
+            print(response.headers.get("allow"))
+            ```
+        """
+        return self.request(method="OPTIONS", url=url, **kwargs)
+
+    def delete(self, url: str, **kwargs: Unpack[RequestParams]) -> Response:
+        """
+        Make a DELETE request.
+
+        Args:
+            url: Request URL.
+            **kwargs: Request parameters (params, headers, cookies, auth, auth_bearer, timeout).
+
+        Returns:
+            Response object.
+
+        Example:
+            ```python
+            response = client.delete("https://httpbin.org/delete")
+            print(response.status_code)
+            ```
+        """
+        return self.request(method="DELETE", url=url, **kwargs)
+
+    def post(self, url: str, **kwargs: Unpack[RequestParams]) -> Response:
+        """
+        Make a POST request.
+
+        Args:
+            url: Request URL.
+            **kwargs: Request parameters including body options.
+
+        Keyword Args:
+            params (dict[str, str] | None): Query parameters.
+            headers (dict[str, str] | None): Request headers.
+            cookies (dict[str, str] | None): Request cookies.
+            auth (tuple[str, str | None] | None): Basic auth credentials.
+            auth_bearer (str | None): Bearer token.
+            timeout (float | None): Request timeout.
+            content (bytes | None): Raw bytes body.
+            data (dict[str, Any] | None): Form-encoded body.
+            json (Any | None): JSON body.
+            files (dict[str, str] | None): Multipart file uploads.
+
+        Returns:
+            Response object.
+
+        Example:
+            ```python
+            # JSON body
+            response = client.post(
+                "https://httpbin.org/post",
+                json={"name": "httpr", "fast": True},
+            )
+
+            # Form data
+            response = client.post(
+                "https://httpbin.org/post",
+                data={"username": "user", "password": "pass"},
+            )
+
+            # File upload
+            response = client.post(
+                "https://httpbin.org/post",
+                files={"document": "/path/to/file.pdf"},
+            )
+            ```
+        """
+        return self.request(method="POST", url=url, **kwargs)
+
+    def put(self, url: str, **kwargs: Unpack[RequestParams]) -> Response:
+        """
+        Make a PUT request.
+
+        Args:
+            url: Request URL.
+            **kwargs: Request parameters including body options.
+
+        Returns:
+            Response object.
+
+        Example:
+            ```python
+            response = client.put(
+                "https://httpbin.org/put",
+                json={"key": "updated_value"},
+            )
+            ```
+        """
+        return self.request(method="PUT", url=url, **kwargs)
+
+    def patch(self, url: str, **kwargs: Unpack[RequestParams]) -> Response:
+        """
+        Make a PATCH request.
+
+        Args:
+            url: Request URL.
+            **kwargs: Request parameters including body options.
+
+        Returns:
+            Response object.
+
+        Example:
+            ```python
+            response = client.patch(
+                "https://httpbin.org/patch",
+                json={"field": "new_value"},
+            )
+            ```
+        """
+        return self.request(method="PATCH", url=url, **kwargs)
+
+    @contextmanager
+    def stream(
+        self,
+        method: HttpMethod,
+        url: str,
+        **kwargs: Unpack[RequestParams],
+    ) -> Generator[StreamingResponse, None, None]:
+        """
+        Make a streaming HTTP request.
+
+        Returns a context manager that yields a StreamingResponse for iterating
+        over the response body in chunks without buffering the entire response
+        in memory.
+
+        Args:
+            method: HTTP method (GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS).
+            url: Request URL.
+            **kwargs: Request parameters (same as request()).
+
+        Yields:
+            StreamingResponse: A response object that can be iterated to receive chunks.
+
+        Example:
+            Basic streaming:
+
+            ```python
+            with client.stream("GET", "https://example.com/large-file") as response:
+                for chunk in response.iter_bytes():
+                    process(chunk)
+            ```
+
+            Streaming text:
+
+            ```python
+            with client.stream("GET", "https://example.com/text") as response:
+                for text in response.iter_text():
+                    print(text, end="")
+            ```
+
+            Streaming lines (e.g., Server-Sent Events):
+
+            ```python
+            with client.stream("GET", "https://example.com/events") as response:
+                for line in response.iter_lines():
+                    print(line.strip())
+            ```
+
+            Conditional reading:
+
+            ```python
+            with client.stream("GET", url) as response:
+                if response.status_code == 200:
+                    content = response.read()  # Read all remaining content
+                else:
+                    pass  # Don't read the body
+            ```
+
+        Note:
+            The response body is only read when you iterate over it or call read().
+            Always use this as a context manager to ensure proper cleanup.
+        """
+        if method not in ["GET", "HEAD", "OPTIONS", "DELETE", "POST", "PUT", "PATCH"]:
+            raise ValueError(f"Unsupported HTTP method: {method}")
+        if "params" in kwargs and kwargs["params"] is not None:
+            kwargs["params"] = {k: str(v) for k, v in kwargs["params"].items()}
+
+        response = super()._stream(method=method, url=url, **kwargs)
+        try:
+            yield response
+        finally:
+            response.close()
+
+
+class AsyncClient(Client):
+    """
+    An asynchronous HTTP client for use with asyncio.
+
+    AsyncClient wraps the synchronous Client using asyncio.run_in_executor(),
+    providing an async interface while leveraging the Rust implementation's
+    performance.
+
+    Example:
+        Basic usage:
+
+        ```python
+        import asyncio
+        import httpr
+
+        async def main():
+            async with httpr.AsyncClient() as client:
+                response = await client.get("https://httpbin.org/get")
+                print(response.json())
+
+        asyncio.run(main())
+        ```
+
+        Concurrent requests:
+
+        ```python
+        import asyncio
+        import httpr
+
+        async def main():
+            async with httpr.AsyncClient() as client:
+                tasks = [
+                    client.get("https://httpbin.org/get"),
+                    client.get("https://httpbin.org/ip"),
+                ]
+                responses = await asyncio.gather(*tasks)
+                for response in responses:
+                    print(response.json())
+
+        asyncio.run(main())
+        ```
+
+    Note:
+        AsyncClient runs synchronous Rust code in a thread executor.
+        It provides concurrency benefits for I/O-bound tasks but is not
+        native async I/O.
+    """
+
+    def __init__(self, *args, **kwargs):
+        """
+        Initialize an async HTTP client.
+
+        Accepts the same parameters as Client.
+        """
+        super().__init__(*args, **kwargs)
+
+    async def __aenter__(self) -> AsyncClient:
+        """Enter async context manager."""
+        return self
+
+    async def __aexit__(self, *args):
+        """Exit async context manager and close client."""
+        del self
+
+    async def aclose(self):
+        """
+        Close the async client.
+
+        Example:
+            ```python
+            client = httpr.AsyncClient()
+            try:
+                response = await client.get("https://example.com")
+            finally:
+                await client.aclose()
+            ```
+        """
+        del self
+        return
+
+    async def _run_sync_asyncio(self, fn, *args, **kwargs):
+        """Run a synchronous function in an executor."""
+        loop = asyncio.get_running_loop()
+        return await loop.run_in_executor(None, partial(fn, *args, **kwargs))
+
+    async def request(  # type: ignore[override]
+        self,
+        method: HttpMethod,
+        url: str,
+        **kwargs: Unpack[RequestParams],
+    ) -> Response:
+        """
+        Make an async HTTP request.
+
+        Args:
+            method: HTTP method.
+            url: Request URL.
+            **kwargs: Request parameters.
+
+        Returns:
+            Response object.
+
+        Example:
+            ```python
+            response = await client.request("GET", "https://httpbin.org/get")
+            ```
+        """
+        if method not in ["GET", "HEAD", "OPTIONS", "DELETE", "POST", "PUT", "PATCH"]:
+            raise ValueError(f"Unsupported HTTP method: {method}")
+        if "params" in kwargs and kwargs["params"] is not None:
+            kwargs["params"] = {k: str(v) for k, v in kwargs["params"].items()}
+
+        return await self._run_sync_asyncio(super().request, method=method, url=url, **kwargs)
+
+    async def get(  # type: ignore[override]
+        self,
+        url: str,
+        **kwargs: Unpack[RequestParams],
+    ) -> Response:
+        """
+        Make an async GET request.
+
+        Args:
+            url: Request URL.
+            **kwargs: Request parameters.
+
+        Returns:
+            Response object.
+
+        Example:
+            ```python
+            response = await client.get("https://httpbin.org/get")
+            ```
+        """
+        return await self.request(method="GET", url=url, **kwargs)
+
+    async def head(  # type: ignore[override]
+        self,
+        url: str,
+        **kwargs: Unpack[RequestParams],
+    ) -> Response:
+        """
+        Make an async HEAD request.
+
+        Args:
+            url: Request URL.
+            **kwargs: Request parameters.
+
+        Returns:
+            Response object.
+        """
+        return await self.request(method="HEAD", url=url, **kwargs)
+
+    async def options(  # type: ignore[override]
+        self,
+        url: str,
+        **kwargs: Unpack[RequestParams],
+    ) -> Response:
+        """
+        Make an async OPTIONS request.
+
+        Args:
+            url: Request URL.
+            **kwargs: Request parameters.
+
+        Returns:
+            Response object.
+        """
+        return await self.request(method="OPTIONS", url=url, **kwargs)
+
+    async def delete(  # type: ignore[override]
+        self,
+        url: str,
+        **kwargs: Unpack[RequestParams],
+    ) -> Response:
+        """
+        Make an async DELETE request.
+
+        Args:
+            url: Request URL.
+            **kwargs: Request parameters.
+
+        Returns:
+            Response object.
+        """
+        return await self.request(method="DELETE", url=url, **kwargs)
+
+    async def post(  # type: ignore[override]
+        self,
+        url: str,
+        **kwargs: Unpack[RequestParams],
+    ) -> Response:
+        """
+        Make an async POST request.
+
+        Args:
+            url: Request URL.
+            **kwargs: Request parameters including body options.
+
+        Returns:
+            Response object.
+
+        Example:
+            ```python
+            response = await client.post(
+                "https://httpbin.org/post",
+                json={"key": "value"},
+            )
+            ```
+        """
+        return await self.request(method="POST", url=url, **kwargs)
+
+    async def put(  # type: ignore[override]
+        self,
+        url: str,
+        **kwargs: Unpack[RequestParams],
+    ) -> Response:
+        """
+        Make an async PUT request.
+
+        Args:
+            url: Request URL.
+            **kwargs: Request parameters including body options.
+
+        Returns:
+            Response object.
+        """
+        return await self.request(method="PUT", url=url, **kwargs)
+
+    async def patch(  # type: ignore[override]
+        self,
+        url: str,
+        **kwargs: Unpack[RequestParams],
+    ) -> Response:
+        """
+        Make an async PATCH request.
+
+        Args:
+            url: Request URL.
+            **kwargs: Request parameters including body options.
+
+        Returns:
+            Response object.
+        """
+        return await self.request(method="PATCH", url=url, **kwargs)
+
+    @asynccontextmanager
+    async def stream(  # type: ignore[override]
+        self,
+        method: HttpMethod,
+        url: str,
+        **kwargs: Unpack[RequestParams],
+    ) -> AsyncIterator[StreamingResponse]:
+        """
+        Make an async streaming HTTP request.
+
+        Returns an async context manager that yields a StreamingResponse for
+        iterating over the response body in chunks.
+
+        Args:
+            method: HTTP method.
+            url: Request URL.
+            **kwargs: Request parameters.
+
+        Yields:
+            StreamingResponse: A response object that can be iterated.
+
+        Example:
+            ```python
+            async with client.stream("GET", "https://example.com/large-file") as response:
+                for chunk in response.iter_bytes():
+                    process(chunk)
+            ```
+
+        Note:
+            Iteration over the response is synchronous (uses iter_bytes, iter_text,
+            iter_lines). The async part is initiating the request and entering
+            the context manager.
+        """
+        if method not in ["GET", "HEAD", "OPTIONS", "DELETE", "POST", "PUT", "PATCH"]:
+            raise ValueError(f"Unsupported HTTP method: {method}")
+        if "params" in kwargs and kwargs["params"] is not None:
+            kwargs["params"] = {k: str(v) for k, v in kwargs["params"].items()}
+
+        # Run the sync _stream in executor
+        response = await self._run_sync_asyncio(super(Client, self)._stream, method=method, url=url, **kwargs)
+        try:
+            yield response
+        finally:
+            response.close()
+
+
+def request(
+    method: HttpMethod,
+    url: str,
+    verify: bool | None = True,
+    ca_cert_file: str | None = None,
+    client_pem: str | None = None,
+    **kwargs: Unpack[RequestParams],
+) -> Response:
+    """
+    Make an HTTP request using a temporary client.
+
+    This is a convenience function for one-off requests. For multiple requests,
+    use a Client instance for better performance (connection pooling).
+
+    Args:
+        method: HTTP method (GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS).
+        url: Request URL.
+        verify: Verify SSL certificates. Default is True.
+        ca_cert_file: Path to CA certificate bundle.
+        client_pem: Path to client certificate for mTLS.
+        **kwargs: Additional request parameters.
+
+    Returns:
+        Response object.
+
+    Example:
+        ```python
+        import httpr
+
+        response = httpr.request("GET", "https://httpbin.org/get")
+        response = httpr.request("POST", "https://httpbin.org/post", json={"key": "value"})
+        ```
+    """
+    with Client(
+        verify=verify,
+        ca_cert_file=ca_cert_file,
+        client_pem=client_pem,
+    ) as client:
+        return client.request(method, url, **kwargs)
+
+
+def get(url: str, **kwargs: Unpack[ClientRequestParams]) -> Response:
+    """
+    Make a GET request using a temporary client.
+
+    Args:
+        url: Request URL.
+        **kwargs: Request parameters (params, headers, cookies, auth, timeout, etc.).
+
+    Returns:
+        Response object.
+
+    Example:
+        ```python
+        import httpr
+
+        response = httpr.get("https://httpbin.org/get", params={"key": "value"})
+        print(response.json())
+        ```
+    """
+    return request(method="GET", url=url, **kwargs)
+
+
+def head(url: str, **kwargs: Unpack[ClientRequestParams]) -> Response:
+    """
+    Make a HEAD request using a temporary client.
+
+    Args:
+        url: Request URL.
+        **kwargs: Request parameters.
+
+    Returns:
+        Response object (body will be empty).
+
+    Example:
+        ```python
+        import httpr
+
+        response = httpr.head("https://httpbin.org/get")
+        print(response.headers)
+        ```
+    """
+    return request(method="HEAD", url=url, **kwargs)
+
+
+def options(url: str, **kwargs: Unpack[ClientRequestParams]) -> Response:
+    """
+    Make an OPTIONS request using a temporary client.
+
+    Args:
+        url: Request URL.
+        **kwargs: Request parameters.
+
+    Returns:
+        Response object.
+
+    Example:
+        ```python
+        import httpr
+
+        response = httpr.options("https://httpbin.org/get")
+        ```
+    """
+    return request(method="OPTIONS", url=url, **kwargs)
+
+
+def delete(url: str, **kwargs: Unpack[ClientRequestParams]) -> Response:
+    """
+    Make a DELETE request using a temporary client.
+
+    Args:
+        url: Request URL.
+        **kwargs: Request parameters.
+
+    Returns:
+        Response object.
+
+    Example:
+        ```python
+        import httpr
+
+        response = httpr.delete("https://httpbin.org/delete")
+        ```
+    """
+    return request(method="DELETE", url=url, **kwargs)
+
+
+def post(url: str, **kwargs: Unpack[ClientRequestParams]) -> Response:
+    """
+    Make a POST request using a temporary client.
+
+    Args:
+        url: Request URL.
+        **kwargs: Request parameters (json, data, content, files, etc.).
+
+    Returns:
+        Response object.
+
+    Example:
+        ```python
+        import httpr
+
+        # JSON body
+        response = httpr.post("https://httpbin.org/post", json={"key": "value"})
+
+        # Form data
+        response = httpr.post("https://httpbin.org/post", data={"field": "value"})
+        ```
+    """
+    return request(method="POST", url=url, **kwargs)
+
+
+def put(url: str, **kwargs: Unpack[ClientRequestParams]) -> Response:
+    """
+    Make a PUT request using a temporary client.
+
+    Args:
+        url: Request URL.
+        **kwargs: Request parameters.
+
+    Returns:
+        Response object.
+
+    Example:
+        ```python
+        import httpr
+
+        response = httpr.put("https://httpbin.org/put", json={"key": "value"})
+        ```
+    """
+    return request(method="PUT", url=url, **kwargs)
+
+
+def patch(url: str, **kwargs: Unpack[ClientRequestParams]) -> Response:
+    """
+    Make a PATCH request using a temporary client.
+
+    Args:
+        url: Request URL.
+        **kwargs: Request parameters.
+
+    Returns:
+        Response object.
+
+    Example:
+        ```python
+        import httpr
+
+        response = httpr.patch("https://httpbin.org/patch", json={"field": "new_value"})
+        ```
+    """
+    return request(method="PATCH", url=url, **kwargs)
+
+
+# Import exceptions from the Rust module
+from .httpr import (  # noqa: E402
+    CloseError,
+    # Network exceptions
+    ConnectError,
+    # Timeout exceptions
+    ConnectTimeout,
+    CookieConflict,
+    DecodingError,
+    # Base exceptions
+    HTTPError,
+    HTTPStatusError,
+    # Other exceptions
+    InvalidURL,
+    # Protocol exceptions
+    LocalProtocolError,
+    NetworkError,
+    PoolTimeout,
+    ProtocolError,
+    ProxyError,
+    ReadError,
+    ReadTimeout,
+    RemoteProtocolError,
+    RequestError,
+    RequestNotRead,
+    ResponseNotRead,
+    StreamClosed,
+    # Stream exceptions
+    StreamConsumed,
+    StreamError,
+    TimeoutException,
+    TooManyRedirects,
+    TransportError,
+    # Other transport/request exceptions
+    UnsupportedProtocol,
+    WriteError,
+    WriteTimeout,
+)
+
+__all__ = [
+    # Client and request functions
+    "Client",
+    "AsyncClient",
+    "request",
+    "get",
+    "head",
+    "options",
+    "delete",
+    "post",
+    "put",
+    "patch",
+    # Response classes
+    "Response",
+    "StreamingResponse",
+    "CaseInsensitiveHeaderMap",
+    # Base exceptions
+    "HTTPError",
+    "RequestError",
+    "TransportError",
+    "NetworkError",
+    "TimeoutException",
+    "ProtocolError",
+    "StreamError",
+    # Timeout exceptions
+    "ConnectTimeout",
+    "ReadTimeout",
+    "WriteTimeout",
+    "PoolTimeout",
+    # Network exceptions
+    "ConnectError",
+    "ReadError",
+    "WriteError",
+    "CloseError",
+    # Protocol exceptions
+    "LocalProtocolError",
+    "RemoteProtocolError",
+    # Other exceptions
+    "UnsupportedProtocol",
+    "ProxyError",
+    "TooManyRedirects",
+    "HTTPStatusError",
+    "DecodingError",
+    "StreamConsumed",
+    "ResponseNotRead",
+    "RequestNotRead",
+    "StreamClosed",
+    "InvalidURL",
+    "CookieConflict",
+]