rnet 3.0.0rc2__cp311-abi3-win_arm64.whl → 3.0.0rc3__cp311-abi3-win_arm64.whl

rnet/__init__.pyi

@@ -29,6 +29,7 @@ class ClientParams(TypedDict, closed=True):
     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]
@@ -506,55 +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.
     """
+
     local_addr: Optional[SocketAddr]
     r"""
-    Returns the local address of the response.
+    Get the local address of the response.
+    """
+
+    history: List[History]
+    r"""
+    Get the redirect history of the Response.
     """
-    encoding: str
+
+    peer_certificate: Optional[bytes]
     r"""
-    Encoding to decode with when accessing text.
+    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
 
@@ -563,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.
@@ -650,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)
@@ -668,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: ...
 
@@ -1097,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,5 +1,5 @@
-from typing import Unpack
-from rnet import ClientParams, Message, Request, Streamer, WebSocketRequest
+import datetime
+from rnet import ClientParams, History, Message, Request, Streamer, WebSocketRequest
 from typing import (
     Optional,
     Any,
@@ -327,56 +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.
     """
+
     local_addr: Optional[SocketAddr]
     r"""
-    Returns the local address of the response.
+    Get the local address of the response.
     """
-    encoding: str
+
+    history: List[History]
     r"""
-    Encoding to decode with when accessing text.
+    Get the redirect history 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.
-        """
+    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
 
@@ -385,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"""
@@ -411,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

@@ -109,7 +109,7 @@ class Jar:
         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):

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,8 +47,8 @@ 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:
@@ -150,7 +150,7 @@ class HeaderMap:
             The first header value as bytes, or the default value
         """
 
-    def get_all(self, key: str) -> "HeaderMapValuesIter":
+    def get_all(self, key: str) -> Iterator[bytes]:
         r"""
         Get all values for a header name.
 
@@ -165,6 +165,22 @@ class HeaderMap:
             An iterator over all header values
         """
 
+    def values(self) -> Iterator[bytes]:
+        """
+        Iterate over all header values.
+
+        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:
         """
         Get the total number of header values.
@@ -204,18 +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
-        """
-
 
 class OrigHeaderMap:
     """
@@ -259,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.
 
@@ -300,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):

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: rnet
-Version: 3.0.0rc2
+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.0rc2
+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=VzKk74j9edmrfLIbvZwdMuE33eAWK_RyxyCclQat850,10303
+rnet-3.0.0rc3.dist-info/WHEEL,sha256=860eeFsMw4O2kbT6KMesEvy2mk35xuzbuSMVrgrvIME,95
+rnet-3.0.0rc3.dist-info/licenses/LICENSE,sha256=5kQS3sJhKesKmvxcoxk0YHWru2aLDDl9rZ1vIczCp6I,35827
+rnet/__init__.py,sha256=rCluCdsKKp_tnOimCnBRyTUwqHf6fCG5bEJvEroLVd8,336
+rnet/__init__.pyi,sha256=qj1wLkwWXpXY0LnqELqAcY79ZLasBvoazRlJbgLSTyo,30505
+rnet/blocking.py,sha256=RPPKkTTLxiVk9V3vYo0hHMH92Mc2ulkpBKsvi6QUSJI,11800
+rnet/cookie.py,sha256=sw-hikBp_2wEYLp57t-TiFseDtdUWXg11zVrJ2RHegE,3007
+rnet/emulation.py,sha256=bfI3LzRYAGXkAGSqz0mKGCAMmwJlHXSPKDGYmLh4JCs,5177
+rnet/exceptions.py,sha256=VACr1hk3RKCuj8ThQoljlsf-qN3d28-YgxQzxpIGvgc,6120
+rnet/header.py,sha256=4zTaekLR9ishXMQP5hL4MTyVTWbD1lGymwlvQUDi1NQ,9864
+rnet/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+rnet/rnet.pyd,sha256=aRePPaJWTxEGh12LQBHElWTzbsOd3oLx1fYryiGRATA,8001536
+rnet/tls.py,sha256=ZpfCqg10T2i-tAwjcYnEpusoty9hVEwV6IoLSDNVgI8,4954
+rnet-3.0.0rc3.dist-info/RECORD,,

rnet-3.0.0rc2.dist-info/RECORD

@@ -1,14 +0,0 @@
-rnet-3.0.0rc2.dist-info/METADATA,sha256=4RnxUeNeq-1PS7-_Sd1JJlHkxI46JEJIGz9xUdGDm6E,10206
-rnet-3.0.0rc2.dist-info/WHEEL,sha256=860eeFsMw4O2kbT6KMesEvy2mk35xuzbuSMVrgrvIME,95
-rnet-3.0.0rc2.dist-info/licenses/LICENSE,sha256=5kQS3sJhKesKmvxcoxk0YHWru2aLDDl9rZ1vIczCp6I,35827
-rnet/__init__.py,sha256=rCluCdsKKp_tnOimCnBRyTUwqHf6fCG5bEJvEroLVd8,336
-rnet/__init__.pyi,sha256=ZJpej4Lpt1jt5fzOUvVevwmayiyvSin_W0TpaPeJ8FU,30394
-rnet/blocking.py,sha256=t6b9wx5yy-4ShhhKKGJNThySN5tVITfSX0GBzHOD_To,11914
-rnet/cookie.py,sha256=4KnwX8EjQ0Ez4xXygkjHgTDBvusf0IgH5rMPBkagN0w,3000
-rnet/emulation.py,sha256=mLTJDDKXGO2-GhMJObTF_ybKC40AjaU4H3Eh2LnerVQ,5206
-rnet/exceptions.py,sha256=VACr1hk3RKCuj8ThQoljlsf-qN3d28-YgxQzxpIGvgc,6120
-rnet/header.py,sha256=3gLxzrxf594yE5lgoOHMokKN6D51j2YpAYKf2SFx4p0,12259
-rnet/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-rnet/rnet.pyd,sha256=Weu9HTG4Im0qnO4dJe7p2T97gakbjCspDrGDpgDUj9M,8011776
-rnet/tls.py,sha256=eFnihasc6Mcif1qK3HlJ2NdyL5MlFgDVShM149ms220,4964
-rnet-3.0.0rc2.dist-info/RECORD,,