rnet 3.0.0rc1__cp311-abi3-macosx_10_12_x86_64.whl → 3.0.0rc3__cp311-abi3-macosx_10_12_x86_64.whl

rnet/__init__.pyi

@@ -23,9 +23,58 @@ try:
 except ImportError:
     from typing_extensions import Unpack, NotRequired
 
+class ClientParams(TypedDict, closed=True):
+    emulation: NotRequired[Union[Emulation, EmulationOption]]
+    user_agent: NotRequired[str]
+    headers: NotRequired[Union[Dict[str, str], HeaderMap]]
+    orig_headers: NotRequired[Union[List[str], OrigHeaderMap]]
+    referer: NotRequired[bool]
+    history: NotRequired[bool]
+    allow_redirects: NotRequired[bool]
+    max_redirects: NotRequired[int]
+    cookie_store: NotRequired[bool]
+    cookie_provider: NotRequired[Jar]
+    timeout: NotRequired[int]
+    connect_timeout: NotRequired[int]
+    read_timeout: NotRequired[int]
+    tcp_keepalive: NotRequired[int]
+    tcp_keepalive_interval: NotRequired[int]
+    tcp_keepalive_retries: NotRequired[int]
+    tcp_user_timeout: NotRequired[int]
+    tcp_nodelay: NotRequired[bool]
+    tcp_reuse_address: NotRequired[bool]
+    pool_idle_timeout: NotRequired[int]
+    pool_max_idle_per_host: NotRequired[int]
+    pool_max_size: NotRequired[int]
+    http1_only: NotRequired[bool]
+    http2_only: NotRequired[bool]
+    https_only: NotRequired[bool]
+    http2_max_retry_count: NotRequired[int]
+    verify: NotRequired[Union[bool, Path, CertStore]]
+    identity: NotRequired[Identity]
+    keylog: NotRequired[KeyLogPolicy]
+    tls_info: NotRequired[bool]
+    min_tls_version: NotRequired[TlsVersion]
+    max_tls_version: NotRequired[TlsVersion]
+    no_proxy: NotRequired[bool]
+    proxies: NotRequired[List[Proxy]]
+    local_address: NotRequired[Union[str, ipaddress.IPv4Address, ipaddress.IPv6Address]]
+    interface: NotRequired[str]
+    gzip: NotRequired[bool]
+    brotli: NotRequired[bool]
+    deflate: NotRequired[bool]
+    zstd: NotRequired[bool]
+
+class ProxyParams(TypedDict, closed=True):
+    username: NotRequired[str]
+    password: NotRequired[str]
+    custom_http_auth: NotRequired[str]
+    custom_http_headers: NotRequired[Union[Dict[str, str], HeaderMap]]
+    exclusion: NotRequired[str]
+
 class Request(TypedDict, closed=True):
     emulation: NotRequired[Union[Emulation, EmulationOption]]
-    proxy: NotRequired[Union[str, Proxy]]
+    proxy: NotRequired[Proxy]
     local_address: NotRequired[Union[ipaddress.IPv4Address, ipaddress.IPv6Address]]
     interface: NotRequired[str]
     timeout: NotRequired[int]
@@ -59,7 +108,7 @@ class Request(TypedDict, closed=True):
 
 class WebSocketRequest(TypedDict, closed=True):
     emulation: NotRequired[Union[Emulation, EmulationOption]]
-    proxy: NotRequired[Union[str, Proxy]]
+    proxy: NotRequired[Proxy]
     local_address: NotRequired[Union[str, ipaddress.IPv4Address, ipaddress.IPv6Address]]
     interface: NotRequired[str]
     headers: NotRequired[Union[Dict[str, str], HeaderMap]]
@@ -79,62 +128,14 @@ class WebSocketRequest(TypedDict, closed=True):
     max_frame_size: NotRequired[int]
     accept_unmasked_frames: NotRequired[bool]
 
-class ProxyParams(TypedDict, closed=True):
-    username: NotRequired[str]
-    password: NotRequired[str]
-    custom_http_auth: NotRequired[str]
-    custom_http_headers: NotRequired[Union[Dict[str, str], HeaderMap]]
-    exclusion: NotRequired[str]
-
 class Client:
     r"""
     A client for making HTTP requests.
     """
 
-    def __new__(
+    def __init__(
         cls,
-        emulation: Optional[Union[Emulation, EmulationOption]] = None,
-        user_agent: Optional[str] = None,
-        headers: Optional[Union[Dict[str, str], HeaderMap]] = None,
-        orig_headers: Optional[Union[List[str], OrigHeaderMap]] = None,
-        referer: Optional[bool] = None,
-        allow_redirects: Optional[bool] = None,
-        max_redirects: Optional[int] = None,
-        cookie_store: Optional[bool] = None,
-        cookie_provider: Optional[Jar] = None,
-        timeout: Optional[int] = None,
-        connect_timeout: Optional[int] = None,
-        read_timeout: Optional[int] = None,
-        no_keepalive: Optional[bool] = None,
-        tcp_keepalive: Optional[int] = None,
-        tcp_keepalive_interval: Optional[int] = None,
-        tcp_keepalive_retries: Optional[int] = None,
-        tcp_user_timeout: Optional[int] = None,
-        tcp_nodelay: Optional[bool] = None,
-        tcp_reuse_address: Optional[bool] = None,
-        pool_idle_timeout: Optional[int] = None,
-        pool_max_idle_per_host: Optional[int] = None,
-        pool_max_size: Optional[int] = None,
-        http1_only: Optional[bool] = None,
-        http2_only: Optional[bool] = None,
-        https_only: Optional[bool] = None,
-        http2_max_retry_count: Optional[int] = None,
-        verify: Optional[Union[bool, Path, CertStore]] = None,
-        identity: Optional[Identity] = None,
-        keylog: Optional[KeyLogPolicy] = None,
-        tls_info: Optional[bool] = None,
-        min_tls_version: Optional[TlsVersion] = None,
-        max_tls_version: Optional[TlsVersion] = None,
-        no_proxy: Optional[bool] = None,
-        proxies: Optional[List[Proxy]] = None,
-        local_address: Optional[
-            Union[str, ipaddress.IPv4Address, ipaddress.IPv6Address]
-        ] = None,
-        interface: Optional[str] = None,
-        gzip: Optional[bool] = None,
-        brotli: Optional[bool] = None,
-        deflate: Optional[bool] = None,
-        zstd: Optional[bool] = None,
+        **kwargs: Unpack[ClientParams],
     ) -> Client:
         r"""
         Creates a new Client instance.
@@ -152,7 +153,6 @@ class Client:
             timeout: Total timeout (seconds).
             connect_timeout: Connection timeout (seconds).
             read_timeout: Read timeout (seconds).
-            no_keepalive: Disable HTTP keep-alive.
             tcp_keepalive: TCP keepalive time (seconds).
             tcp_keepalive_interval: TCP keepalive interval (seconds).
             tcp_keepalive_retries: TCP keepalive retry count.
@@ -444,7 +444,7 @@ class Multipart:
     A multipart form for a request.
     """
 
-    def __new__(cls, *parts) -> Multipart:
+    def __init__(cls, *parts) -> Multipart:
         r"""
         Creates a new multipart form.
         """
@@ -454,7 +454,7 @@ class Part:
     A part of a multipart form.
     """
 
-    def __new__(
+    def __init__(
         cls,
         name: str,
         value: Union[
@@ -507,51 +507,62 @@ class Response:
 
     url: str
     r"""
-    Returns the URL of the response.
+    Get the URL of the response.
     """
+
     status: StatusCode
     r"""
-    Returns the status code of the response.
+    Get the status code of the response.
     """
+
     version: Version
     r"""
-    Returns the HTTP version of the response.
+    Get the HTTP version of the response.
     """
+
     headers: HeaderMap
     r"""
-    Returns the headers of the response.
+    Get the headers of the response.
     """
+
     cookies: List[Cookie]
     r"""
-    Returns the cookies of the response.
+    Get the cookies of the response.
     """
+
     content_length: int
     r"""
-    Returns the content length of the response.
+    Get the content length of the response.
     """
+
     remote_addr: Optional[SocketAddr]
     r"""
-    Returns the remote address of the response.
+    Get the remote address of the response.
     """
-    encoding: str
+
+    local_addr: Optional[SocketAddr]
     r"""
-    Encoding to decode with when accessing text.
+    Get the local address of the response.
+    """
+
+    history: List[History]
+    r"""
+    Get the redirect history of the Response.
+    """
+
+    peer_certificate: Optional[bytes]
+    r"""
+    Get the DER encoded leaf certificate of the response.
     """
-    def __aenter__(self) -> Any: ...
-    def __aexit__(self, _exc_type: Any, _exc_value: Any, _traceback: Any) -> Any: ...
-    def peer_certificate(self) -> Optional[bytes]:
-        r"""
-        Returns the TLS peer certificate of the response.
-        """
 
     async def text(self) -> str:
         r"""
-        Returns the text content of the response.
+        Get the text content of the response.
         """
 
     async def text_with_charset(self, encoding: str) -> str:
         r"""
-        Returns the text content of the response with a specific charset.
+        Get the text content of the response with a specific charset.
 
         # Arguments
 
@@ -560,24 +571,48 @@ class Response:
 
     async def json(self) -> Any:
         r"""
-        Returns the JSON content of the response.
+        Get the JSON content of the response.
         """
 
     async def bytes(self) -> bytes:
         r"""
-        Returns the bytes content of the response.
+        Get the bytes content of the response.
         """
 
     def stream(self) -> Streamer:
         r"""
-        Convert the response into a `Stream` of `Bytes` from the body.
+        Get the response into a `Stream` of `Bytes` from the body.
         """
 
     async def close(self) -> None:
         r"""
-        Closes the response connection.
+        Close the response connection.
         """
 
+    async def __aenter__(self) -> Any: ...
+    async def __aexit__(
+        self, _exc_type: Any, _exc_value: Any, _traceback: Any
+    ) -> Any: ...
+
+class History:
+    """
+    An entry in the redirect history.
+    """
+
+    status: int
+    """Get the status code of the redirect response."""
+
+    url: str
+    """Get the URL of the redirect response."""
+
+    previous: str
+    """Get the previous URL before the redirect response."""
+
+    headers: HeaderMap
+    """Get the headers of the redirect response."""
+
+    def __str__(self) -> str: ...
+
 class SocketAddr:
     r"""
     A IP socket address.
@@ -647,14 +682,6 @@ class Streamer:
 
     async def main():
         resp = await rnet.get("https://httpbin.org/stream/20")
-        print("Status Code: ", resp.status)
-        print("Version: ", resp.version)
-        print("Response URL: ", resp.url)
-        print("Headers: ", resp.headers)
-        print("Content-Length: ", resp.content_length)
-        print("Encoding: ", resp.encoding)
-        print("Remote Address: ", resp.remote_addr)
-
         async with resp.stream() as streamer:
             async for chunk in streamer:
                 print("Chunk: ", chunk)
@@ -665,12 +692,14 @@ class Streamer:
     ```
     """
 
-    def __aiter__(self) -> Streamer: ...
-    def __anext__(self) -> Any: ...
-    def __aenter__(self) -> Any: ...
-    def __aexit__(self, _exc_type: Any, _exc_value: Any, _traceback: Any) -> Any: ...
+    async def __aiter__(self) -> Streamer: ...
+    async def __anext__(self) -> Optional[bytes]: ...
+    async def __aenter__(self) -> Any: ...
+    async def __aexit__(
+        self, _exc_type: Any, _exc_value: Any, _traceback: Any
+    ) -> Any: ...
     def __iter__(self) -> Streamer: ...
-    def __next__(self) -> Any: ...
+    def __next__(self) -> bytes: ...
     def __enter__(self) -> Streamer: ...
     def __exit__(self, _exc_type: Any, _exc_value: Any, _traceback: Any) -> None: ...
 
@@ -1094,33 +1123,34 @@ class WebSocket:
 
     status: StatusCode
     r"""
-    Returns the status code of the response.
+    Get the status code of the response.
     """
     version: Version
     r"""
-    Returns the HTTP version of the response.
+    Get the HTTP version of the response.
     """
     headers: HeaderMap
     r"""
-    Returns the headers of the response.
+    Get the headers of the response.
     """
     cookies: List[Cookie]
     r"""
-    Returns the cookies of the response.
+    Get the cookies of the response.
     """
     remote_addr: Optional[SocketAddr]
     r"""
-    Returns the remote address of the response.
+    Get the remote address of the response.
     """
     protocol: Optional[str]
     r"""
-    Returns the WebSocket protocol.
+    Get the WebSocket protocol.
     """
-    def __aiter__(self) -> WebSocket: ...
-    def __anext__(self) -> Any: ...
+
     def __aenter__(self) -> Any: ...
     def __aexit__(self, _exc_type: Any, _exc_value: Any, _traceback: Any) -> Any: ...
-    async def recv(self) -> Optional[Message]:
+    async def recv(
+        self, timeout: datetime.timedelta | None = None
+    ) -> Optional[Message]:
         r"""
         Receives a message from the WebSocket.
         """

rnet/blocking.py

@@ -1,21 +1,15 @@
-from typing import Unpack
-from rnet import Message, Proxy, Request, Streamer, WebSocketRequest
-import ipaddress
+import datetime
+from rnet import ClientParams, History, Message, Request, Streamer, WebSocketRequest
 from typing import (
     Optional,
-    Union,
     Any,
-    Dict,
     List,
     Unpack,
 )
-from pathlib import Path
 
 from rnet import Version, Method, SocketAddr, StatusCode
-from rnet.tls import CertStore, KeyLogPolicy, TlsVersion, Identity
-from rnet.header import HeaderMap, OrigHeaderMap
-from rnet.cookie import Cookie, Jar
-from rnet.emulation import EmulationOption, Emulation
+from rnet.header import HeaderMap
+from rnet.cookie import Cookie
 
 
 class Client:
@@ -23,50 +17,9 @@ class Client:
     A blocking client for making HTTP requests.
     """
 
-    def __new__(
+    def __init__(
         cls,
-        emulation: Optional[Union[Emulation, EmulationOption]] = None,
-        user_agent: Optional[str] = None,
-        headers: Optional[Union[Dict[str, str], HeaderMap]] = None,
-        orig_headers: Optional[Union[List[str], OrigHeaderMap]] = None,
-        referer: Optional[bool] = None,
-        allow_redirects: Optional[bool] = None,
-        max_redirects: Optional[int] = None,
-        cookie_store: Optional[bool] = None,
-        cookie_provider: Optional[Jar] = None,
-        timeout: Optional[int] = None,
-        connect_timeout: Optional[int] = None,
-        read_timeout: Optional[int] = None,
-        no_keepalive: Optional[bool] = None,
-        tcp_keepalive: Optional[int] = None,
-        tcp_keepalive_interval: Optional[int] = None,
-        tcp_keepalive_retries: Optional[int] = None,
-        tcp_user_timeout: Optional[int] = None,
-        tcp_nodelay: Optional[bool] = None,
-        tcp_reuse_address: Optional[bool] = None,
-        pool_idle_timeout: Optional[int] = None,
-        pool_max_idle_per_host: Optional[int] = None,
-        pool_max_size: Optional[int] = None,
-        http1_only: Optional[bool] = None,
-        http2_only: Optional[bool] = None,
-        https_only: Optional[bool] = None,
-        http2_max_retry_count: Optional[int] = None,
-        verify: Optional[Union[bool, Path, CertStore]] = None,
-        identity: Optional[Identity] = None,
-        keylog: Optional[KeyLogPolicy] = None,
-        tls_info: Optional[bool] = None,
-        min_tls_version: Optional[TlsVersion] = None,
-        max_tls_version: Optional[TlsVersion] = None,
-        no_proxy: Optional[bool] = None,
-        proxies: Optional[List[Proxy]] = None,
-        local_address: Optional[
-            Union[str, ipaddress.IPv4Address, ipaddress.IPv6Address]
-        ] = None,
-        interface: Optional[str] = None,
-        gzip: Optional[bool] = None,
-        brotli: Optional[bool] = None,
-        deflate: Optional[bool] = None,
-        zstd: Optional[bool] = None,
+        **kwargs: Unpack[ClientParams],
     ) -> "Client":
         r"""
         Creates a new blocking Client instance.
@@ -84,7 +37,6 @@ class Client:
             timeout: Total timeout (seconds).
             connect_timeout: Connection timeout (seconds).
             read_timeout: Read timeout (seconds).
-            no_keepalive: Disable HTTP keep-alive.
             tcp_keepalive: TCP keepalive time (seconds).
             tcp_keepalive_interval: TCP keepalive interval (seconds).
             tcp_keepalive_retries: TCP keepalive retry count.
@@ -375,52 +327,62 @@ class Response:
 
     url: str
     r"""
-    Returns the URL of the response.
+    Get the URL of the response.
     """
+
     status: StatusCode
     r"""
-    Returns the status code of the response.
+    Get the status code of the response.
     """
+
     version: Version
     r"""
-    Returns the HTTP version of the response.
+    Get the HTTP version of the response.
     """
+
     headers: HeaderMap
     r"""
-    Returns the headers of the response.
+    Get the headers of the response.
     """
+
     cookies: List[Cookie]
     r"""
-    Returns the cookies of the response.
+    Get the cookies of the response.
     """
+
     content_length: int
     r"""
-    Returns the content length of the response.
+    Get the content length of the response.
     """
+
     remote_addr: Optional[SocketAddr]
     r"""
-    Returns the remote address of the response.
+    Get the remote address of the response.
     """
-    encoding: str
+
+    local_addr: Optional[SocketAddr]
     r"""
-    Encoding to decode with when accessing text.
+    Get the local address of the response.
     """
 
-    def __enter__(self) -> "Response": ...
-    def __exit__(self, _exc_type: Any, _exc_value: Any, _traceback: Any) -> None: ...
-    def peer_certificate(self) -> Optional[bytes]:
-        r"""
-        Returns the TLS peer certificate of the response.
-        """
+    history: List[History]
+    r"""
+    Get the redirect history of the Response.
+    """
+
+    peer_certificate: Optional[bytes]
+    r"""
+    Get the DER encoded leaf certificate of the response.
+    """
 
     def text(self) -> str:
         r"""
-        Returns the text content of the response.
+        Get the text content of the response.
         """
 
     def text_with_charset(self, encoding: str) -> str:
         r"""
-        Returns the text content of the response with a specific charset.
+        Get the text content of the response with a specific charset.
 
         # Arguments
 
@@ -429,24 +391,27 @@ class Response:
 
     def json(self) -> Any:
         r"""
-        Returns the JSON content of the response.
+        Get the JSON content of the response.
         """
 
     def bytes(self) -> bytes:
         r"""
-        Returns the bytes content of the response.
+        Get the bytes content of the response.
         """
 
     def stream(self) -> Streamer:
         r"""
-        Convert the response into a `Stream` of `Bytes` from the body.
+        Get the response into a `Stream` of `Bytes` from the body.
         """
 
     def close(self) -> None:
         r"""
-        Closes the response connection.
+        Close the response connection.
         """
 
+    def __enter__(self) -> "Response": ...
+    def __exit__(self, _exc_type: Any, _exc_value: Any, _traceback: Any) -> None: ...
+
 
 class WebSocket:
     r"""
@@ -455,34 +420,33 @@ class WebSocket:
 
     status: StatusCode
     r"""
-    Returns the status code of the response.
+    Get the status code of the response.
     """
     version: Version
     r"""
-    Returns the HTTP version of the response.
+    Get the HTTP version of the response.
     """
     headers: HeaderMap
     r"""
-    Returns the headers of the response.
+    Get the headers of the response.
     """
     cookies: List[Cookie]
     r"""
-    Returns the cookies of the response.
+    Get the cookies of the response.
     """
     remote_addr: Optional[SocketAddr]
     r"""
-    Returns the remote address of the response.
+    Get the remote address of the response.
     """
     protocol: Optional[str]
     r"""
-    Returns the WebSocket protocol.
+    Get the WebSocket protocol.
     """
 
-    def __iter__(self) -> "WebSocket": ...
-    def __next__(self) -> Message: ...
     def __enter__(self) -> "WebSocket": ...
     def __exit__(self, _exc_type: Any, _exc_value: Any, _traceback: Any) -> None: ...
-    def recv(self) -> Optional[Message]:
+
+    def recv(self, timeout: datetime.timedelta | None = None) -> Optional[Message]:
         r"""
         Receives a message from the WebSocket.
         """

rnet/cookie.py

@@ -8,7 +8,7 @@ and provides a cookie jar for automatic cookie handling during HTTP requests.
 
 import datetime
 from enum import Enum, auto
-from typing import Optional
+from typing import List, Optional
 
 
 class SameSite(Enum):
@@ -67,17 +67,17 @@ class Cookie:
     The cookie expiration time.
     """
 
-    def __new__(
+    def __init__(
         cls,
         name: str,
         value: str,
-        domain: Optional[str] = None,
-        path: Optional[str] = None,
-        max_age: Optional[datetime.timedelta] = None,
-        expires: Optional[datetime.datetime] = None,
+        domain: str | None = None,
+        path: str | None = None,
+        max_age: datetime.timedelta | None = None,
+        expires: datetime.datetime | None = None,
         http_only: bool = False,
         secure: bool = False,
-        same_site: Optional[SameSite] = None,
+        same_site: SameSite | None = None,
     ) -> "Cookie":
         r"""
         Create a new cookie.
@@ -94,7 +94,7 @@ class Jar:
     to automatically handle cookies during HTTP requests and responses.
     """
 
-    def __new__(cls) -> "Jar":
+    def __init__(cls) -> "Jar":
         r"""
         Create a new cookie jar.
         """
@@ -104,12 +104,12 @@ class Jar:
         Get a cookie by name and URL.
         """
 
-    def get_all(self) -> list[Cookie]:
+    def get_all(self) -> List[Cookie]:
         r"""
         Get all cookies.
         """
 
-    def add(self, cookie: Cookie, url: str) -> None:
+    def add_cookie(self, cookie: Cookie, url: str) -> None:
         r"""
         Add a cookie to this jar.
         """

rnet/emulation.py

@@ -11,7 +11,6 @@ authentic and less likely to be blocked by anti-bot systems.
 """
 
 from enum import Enum, auto
-from typing import Optional
 
 
 class Emulation(Enum):
@@ -131,12 +130,12 @@ class EmulationOption:
     browser types with specific operating systems.
     """
 
-    def __new__(
+    def __init__(
         cls,
         emulation: Emulation,
-        emulation_os: Optional[EmulationOS] = None,
-        skip_http2: Optional[bool] = None,
-        skip_headers: Optional[bool] = None,
+        emulation_os: EmulationOS | None = None,
+        skip_http2: bool | None = None,
+        skip_headers: bool | None = None,
     ) -> "EmulationOption":
         """
         Create a new emulation configuration.

rnet/header.py

@@ -11,7 +11,7 @@ including proper support for headers that can have multiple values (like
 Set-Cookie, Accept-Encoding, etc.).
 """
 
-from typing import List, Optional, Tuple
+from typing import Iterator, List, Optional, Tuple
 
 
 class HeaderMap:
@@ -47,15 +47,15 @@ class HeaderMap:
         """Return the total number of header values (not unique names)."""
         ...
 
-    def __iter__(self) -> "HeaderMapKeysIter":
-        """Iterate over unique header names."""
+    def __iter__(self) -> Iterator[Tuple[bytes, bytes]]:
+        """Iterate all header(name, value) pairs, including duplicates for multiple values."""
         ...
 
     def __str__(self) -> str:
         """Return a string representation of all headers."""
         ...
 
-    def __new__(
+    def __init__(
         cls, init: Optional[dict] = None, capacity: Optional[int] = None
     ) -> "HeaderMap":
         """
@@ -108,12 +108,6 @@ class HeaderMap:
         Args:
             key: The header name (case-insensitive)
             value: The header value to set
-
-        Example:
-            ```python
-            headers.insert('Content-Type', 'application/json')
-            # Replaces any existing Content-Type header
-            ```
         """
 
     def append(self, key: str, value: str) -> None:
@@ -127,13 +121,6 @@ class HeaderMap:
         Args:
             key: The header name (case-insensitive)
             value: The header value to append
-
-        Example:
-            ```python
-            headers.append('Accept-Encoding', 'gzip')
-            headers.append('Accept-Encoding', 'deflate')
-            # Results in: Accept-Encoding: gzip, deflate
-            ```
         """
 
     def remove(self, key: str) -> None:
@@ -161,15 +148,9 @@ class HeaderMap:
 
         Returns:
             The first header value as bytes, or the default value
-
-        Example:
-            ```python
-            content_type = headers.get('Content-Type', b'text/plain')
-            auth = headers.get('Authorization')  # Returns None if missing
-            ```
         """
 
-    def get_all(self, key: str) -> "HeaderMapValuesIter":
+    def get_all(self, key: str) -> Iterator[bytes]:
         r"""
         Get all values for a header name.
 
@@ -182,16 +163,22 @@ class HeaderMap:
 
         Returns:
             An iterator over all header values
+        """
 
-        Example:
-            ```python
-            # Get all Set-Cookie headers
-            cookies = list(headers.get_all('Set-Cookie'))
+    def values(self) -> Iterator[bytes]:
+        """
+        Iterate over all header values.
 
-            # Process multiple Accept-Encoding values
-            for encoding in headers.get_all('Accept-Encoding'):
-                print(f"Accepts: {encoding.decode()}")
-            ```
+        Returns:
+            An iterator over all header values as bytes.
+        """
+
+    def keys(self) -> Iterator[bytes]:
+        """
+        Iterate over unique header names.
+
+        Returns:
+            An iterator over unique header names as bytes.
         """
 
     def len(self) -> int:
@@ -233,24 +220,6 @@ class HeaderMap:
         is_empty() will return True.
         """
 
-    def items(self) -> "HeaderMapItemsIter":
-        r"""
-        Get an iterator over all header name-value pairs.
-
-        Returns an iterator that yields tuples of (name, value) for each
-        header value. Headers with multiple values will appear multiple
-        times with different values.
-
-        Returns:
-            Iterator over (name, value) tuples
-
-        Example:
-            ```python
-            for name, value in headers.items():
-                print(f"{name.decode()}: {value.decode()}")
-            ```
-        """
-
 
 class OrigHeaderMap:
     """
@@ -294,33 +263,7 @@ class OrigHeaderMap:
         """
         ...
 
-    def insert(self, value: str) -> bool:
-        """
-        Insert a new header name into the collection.
-
-        If the map did not previously have this key present, then False is returned.
-        If the map did have this key present, the new value is pushed to the end
-        of the list of values currently associated with the key. The key is not
-        updated, though; this matters for types that can be == without being identical.
-
-        Args:
-            value: The header name to insert.
-
-        Returns:
-            True if the key was newly inserted, False if it already existed.
-        """
-        ...
-
-    def extend(self, other: "OrigHeaderMap") -> None:
-        """
-        Extends the map with all entries from another OrigHeaderMap, preserving order.
-
-        Args:
-            other: Another OrigHeaderMap to extend from.
-        """
-        ...
-
-    def items(self) -> "OrigHeaderMapIter":
+    def __iter__(self) -> Iterator[Tuple[bytes, bytes]]:
         """
         Returns an iterator over the (standard_name, original_name) pairs.
 
@@ -335,97 +278,28 @@ class OrigHeaderMap:
         """
         ...
 
-
-class HeaderMapItemsIter:
-    r"""
-    Iterator over header name-value pairs in a HeaderMap.
-
-    Yields tuples of (header_name, header_value) where both are bytes.
-    Headers with multiple values will appear as separate tuples.
-    """
-
-    def __iter__(self) -> "HeaderMapItemsIter":
-        """Return self as iterator."""
-        ...
-
-    def __next__(self) -> Optional[Tuple[bytes, bytes]]:
-        """
-        Get the next header name-value pair.
-
-        Returns:
-            Tuple of (header_name, header_value) or None when exhausted
-        """
-        ...
-
-
-class HeaderMapKeysIter:
-    r"""
-    Iterator over unique header names in a HeaderMap.
-
-    Yields each unique header name as bytes, regardless of how many
-    values each header has.
-    """
-
-    def __iter__(self) -> "HeaderMapKeysIter":
-        """Return self as iterator."""
-        ...
-
-    def __next__(self) -> Optional[bytes]:
-        """
-        Get the next unique header name.
-
-        Returns:
-            Header name as bytes, or None when exhausted
+    def insert(self, value: str) -> bool:
         """
-        ...
-
-
-class HeaderMapValuesIter:
-    r"""
-    Iterator over header values in a HeaderMap.
-
-    Yields header values as bytes. When used with get_all(), yields
-    all values for a specific header name. When used independently,
-    yields all values in the entire map.
-    """
+        Insert a new header name into the collection.
 
-    def __iter__(self) -> "HeaderMapValuesIter":
-        """Return self as iterator."""
-        ...
+        If the map did not previously have this key present, then False is returned.
+        If the map did have this key present, the new value is pushed to the end
+        of the list of values currently associated with the key. The key is not
+        updated, though; this matters for types that can be == without being identical.
 
-    def __next__(self) -> Optional[bytes]:
-        """
-        Get the next header value.
+        Args:
+            value: The header name to insert.
 
         Returns:
-            Header value as bytes, or None when exhausted
-        """
-        ...
-
-
-class OrigHeaderMapIter:
-    """
-    An iterator over the items in an OrigHeaderMap.
-
-    Yields tuples of (standard_header_name, original_header_name) where:
-    - standard_header_name is the normalized header name
-    - original_header_name is the header name as originally received/specified
-    """
-
-    def __iter__(self) -> "OrigHeaderMapIter":
-        """
-        Returns the iterator itself.
+            True if the key was newly inserted, False if it already existed.
         """
         ...
 
-    def __next__(self) -> Tuple[bytes, bytes]:
+    def extend(self, other: "OrigHeaderMap") -> None:
         """
-        Returns the next (standard_name, original_name) pair.
-
-        Returns:
-            A tuple of (standard_header_name, original_header_name) as bytes.
+        Extends the map with all entries from another OrigHeaderMap, preserving order.
 
-        Raises:
-            StopIteration: When there are no more items.
+        Args:
+            other: Another OrigHeaderMap to extend from.
         """
         ...

rnet/tls.py

@@ -8,7 +8,7 @@ These types are typically used to configure client-side TLS authentication and c
 
 from enum import Enum, auto
 from pathlib import Path
-from typing import List, Optional
+from typing import List
 
 
 class TlsVersion(Enum):
@@ -62,11 +62,11 @@ class CertStore:
     Represents a certificate store for verifying TLS connections.
     """
 
-    def __new__(
+    def __init__(
         cls,
-        der_certs: Optional[List[bytes]] = None,
-        pem_certs: Optional[List[str]] = None,
-        default_paths: Optional[bool] = None,
+        der_certs: List[bytes] | None = None,
+        pem_certs: List[str] | None = None,
+        default_paths: bool | None = None,
     ) -> "CertStore":
         """
         Creates a new CertStore.

{rnet-3.0.0rc1.dist-info → rnet-3.0.0rc3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: rnet
-Version: 3.0.0rc1
+Version: 3.0.0rc3
 Classifier: Programming Language :: Rust
 Classifier: Programming Language :: Python :: Implementation :: CPython
 Classifier: Programming Language :: Python :: Implementation :: PyPy
@@ -60,7 +60,7 @@ A blazing-fast Python HTTP client with advanced browser fingerprinting that accu
 This asynchronous example demonstrates how to make a simple GET request using the `rnet` library. So you need install `rnet` and run the following code:
 
 ```bash
-pip install asyncio rnet==3.0.0rc1
+pip install asyncio rnet==3.0.0rc3
 ```
 
 And then the code:
@@ -91,7 +91,8 @@ Additional learning resources include:
 - [DeepWiki](https://deepwiki.com/0x676e67/rnet)
 - [API Documentation](https://github.com/0x676e67/rnet/blob/main/python/rnet)
 - [Repository Tests](https://github.com/0x676e67/rnet/tree/main/tests)
-- [Repository Examples](https://github.com/0x676e67/rnet/tree/main/python/examples)
+- [Synchronous Examples](https://github.com/0x676e67/rnet/tree/main/python/examples/blocking)
+- [Asynchronous Examples](https://github.com/0x676e67/rnet/tree/main/python/examples)
 
 ## Platforms
 

rnet-3.0.0rc3.dist-info/RECORD

@@ -0,0 +1,14 @@
+rnet-3.0.0rc3.dist-info/METADATA,sha256=fEfWy3HHnm5piQjMxfjS8tn9XKDwVisWOB3Q9mWNRUU,10143
+rnet-3.0.0rc3.dist-info/WHEEL,sha256=N8W3-0eDM6igWj-H12r7VkxoMaJIqJLxUyWCFstEaGg,105
+rnet-3.0.0rc3.dist-info/licenses/LICENSE,sha256=ryRV02Zq6zAIr1heqDUkcGlpP7gVCDF6AqR4wRa82kI,35153
+rnet/__init__.py,sha256=gqet5qGPHqS1VRr8XjzpQOuYetNn-aLss4lTR7cZ_9M,317
+rnet/__init__.pyi,sha256=udvT5QwB905aczie87n-9BAMePfnzU_yen90CtO-F38,29301
+rnet/blocking.py,sha256=4o6eTsoP0_XboU9JwkVKwPwbo-BtzymmqJnOVRoSdt4,11325
+rnet/cookie.py,sha256=RmkrJ4NXkxapBaa-zP7zJZm-H0TRbYCyAQFtrkvEJAA,2877
+rnet/emulation.py,sha256=JBN1WqW7TrrzRFBxxm6aYYuDfGUfFV8fbWaUiTIBIFA,4993
+rnet/exceptions.py,sha256=pr8RNPhr_CswkdKgZGvamSFwyrHE6OPQk72YcJACNBo,5906
+rnet/header.py,sha256=70Ro2nLV0QJgYARpatFcKJhx3NvxrYpdv6T9WMAu82E,9559
+rnet/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+rnet/rnet.abi3.so,sha256=batcsghygmSIJSEwGudaSNTM2s18dSytSRIflMq6h1o,8350600
+rnet/tls.py,sha256=lbte5JDU9_mcPY62H3zV5aC5sPc9v4vRSf9tMrucROA,4793
+rnet-3.0.0rc3.dist-info/RECORD,,

{rnet-3.0.0rc1.dist-info → rnet-3.0.0rc3.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: maturin (1.9.3)
+Generator: maturin (1.9.4)
 Root-Is-Purelib: false
 Tag: cp311-abi3-macosx_10_12_x86_64

rnet-3.0.0rc1.dist-info/RECORD

@@ -1,14 +0,0 @@
-rnet-3.0.0rc1.dist-info/METADATA,sha256=I7WMxAsKWF5uU6WfLht1LeD4N-mMvAc3XGQ6p-FvDkw,10047
-rnet-3.0.0rc1.dist-info/WHEEL,sha256=f7YMmFV7_oMXWzGFklHTONXU-Nc4CauArX_2rsvdYdw,105
-rnet-3.0.0rc1.dist-info/licenses/LICENSE,sha256=ryRV02Zq6zAIr1heqDUkcGlpP7gVCDF6AqR4wRa82kI,35153
-rnet/__init__.py,sha256=gqet5qGPHqS1VRr8XjzpQOuYetNn-aLss4lTR7cZ_9M,317
-rnet/__init__.pyi,sha256=g74_wT2p_7-TGKTYr5xSoDCxFkn34OU1Glz4UzTnGW8,29521
-rnet/blocking.py,sha256=Xo8CwyuhyEd-k6D88nbTIB1aLb-wUbDZNy2-AaXcdrw,13536
-rnet/cookie.py,sha256=fN8V-OKr-LT3psv9XTvHfnPD8Nwp10Awxxg762ScwP0,2877
-rnet/emulation.py,sha256=i3Qv1-c0wtWgxJ_hOlS6AFjNDIO4GsSP2SvRONRS6FI,5029
-rnet/exceptions.py,sha256=pr8RNPhr_CswkdKgZGvamSFwyrHE6OPQk72YcJACNBo,5906
-rnet/header.py,sha256=xbBb0wWKZRUs2ylldU_sN13QYBUDvZ-3zynCBd4UiYs,12955
-rnet/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-rnet/rnet.abi3.so,sha256=VyiLGA0RiMM8_nLrJlqgJsEeP8L91frmdatT4a0zByk,8303376
-rnet/tls.py,sha256=Ko0h58k3twVyycuqK7zgBtN3JLnhZ8oDUZqANJshEDE,4811
-rnet-3.0.0rc1.dist-info/RECORD,,