rnet 3.0.0rc5__cp311-abi3-manylinux_2_34_armv7l.whl → 3.0.0rc7__cp311-abi3-manylinux_2_34_armv7l.whl

rnet/__init__.py

@@ -1,11 +1,14 @@
 # rnet/__init__.py
 
 from .rnet import *
+from .rnet import __all__
 
 from .cookie import *
 from .exceptions import *
 from .header import *
 from .emulation import *
+from .http1 import *
+from .http2 import *
 from .tls import *
 
 __all__ = (
@@ -13,5 +16,7 @@ __all__ = (
     + cookie.__all__
     + emulation.__all__
     + exceptions.__all__
+    + http1.__all__
+    + http2.__all__
     + tls.__all__
 )

rnet/__init__.pyi

@@ -16,10 +16,12 @@ from typing import (
 from pathlib import Path
 from enum import Enum, auto
 
-from .cookie import Cookie, Jar
-from .header import HeaderMap, OrigHeaderMap
-from .emulation import Emulation, EmulationOption
-from .tls import TlsVersion, Identity, KeyLogPolicy, CertStore
+from .http1 import Http1Options
+from .http2 import Http2Options
+from .cookie import *
+from .header import *
+from .emulation import *
+from .tls import *
 
 class Method(Enum):
     r"""
@@ -109,7 +111,7 @@ class Multipart:
     A multipart form for a request.
     """
 
-    def __init__(self, *parts) -> None:
+    def __init__(self, *parts: Part) -> None:
         r"""
         Creates a new multipart form.
         """
@@ -465,6 +467,16 @@ class Response:
     Get the DER encoded leaf certificate of the response.
     """
 
+    def raise_for_status(self) -> None:
+        r"""
+        Turn a response into an error if the server returned an error.
+        """
+
+    def stream(self) -> Streamer:
+        r"""
+        Get the response into a `Streamer` of `bytes` from the body.
+        """
+
     async def text(self) -> str:
         r"""
         Get the text content of the response.
@@ -485,11 +497,6 @@ class Response:
         Get the bytes content of the response.
         """
 
-    def stream(self) -> Streamer:
-        r"""
-        Get the response into a `Stream` of `Bytes` from the body.
-        """
-
     async def close(self) -> None:
         r"""
         Close the response connection.
@@ -545,19 +552,11 @@ class WebSocket:
     async def send(self, message: Message) -> None:
         r"""
         Send a message to the WebSocket.
-
-        # Arguments
-
-        * `message` - The message to send.
         """
 
     async def send_all(self, messages: List[Message]) -> None:
         r"""
         Send multiple messages to the WebSocket.
-
-        # Arguments
-
-        * `messages` - The list of messages to send.
         """
 
     async def close(
@@ -567,11 +566,6 @@ class WebSocket:
     ) -> None:
         r"""
         Close the WebSocket connection.
-
-        # Arguments
-
-        * `code` - An optional close code.
-        * `reason` - An optional reason for closing.
         """
 
     def __aenter__(self) -> Any: ...
@@ -579,194 +573,338 @@ class WebSocket:
 
 class ClientParams(TypedDict):
     emulation: NotRequired[Union[Emulation, EmulationOption]]
-    """Browser fingerprint/Emulation config."""
+    """Emulation config."""
 
     user_agent: NotRequired[str]
-    """Default User-Agent string."""
+    """
+    Default User-Agent string.
+    """
 
     headers: NotRequired[Union[Dict[str, str], HeaderMap]]
-    """Default request headers."""
+    """
+    Default request headers.
+    """
 
     orig_headers: NotRequired[Union[List[str], OrigHeaderMap]]
-    """Original request headers (case-sensitive and order)."""
+    """
+    Original request headers (case-sensitive and order).
+    """
 
     referer: NotRequired[bool]
-    """Automatically set Referer."""
+    """
+    Automatically set Referer.
+    """
 
     history: NotRequired[bool]
-    """Store redirect history."""
+    """
+    Store redirect history.
+    """
 
     allow_redirects: NotRequired[bool]
-    """Allow automatic redirects."""
+    """
+    Allow automatic redirects.
+    """
 
     max_redirects: NotRequired[int]
-    """Maximum number of redirects."""
+    """
+    Maximum number of redirects.
+    """
 
     cookie_store: NotRequired[bool]
-    """Enable cookie store."""
+    """
+    Enable cookie store.
+    """
 
     cookie_provider: NotRequired[Jar]
-    """Custom cookie provider."""
+    """
+    Custom cookie provider.
+    """
 
     lookup_ip_strategy: NotRequired[str]
-    """IP lookup strategy."""
+    """
+    IP lookup strategy.
+    """
 
     timeout: NotRequired[int]
-    """Total timeout (seconds)."""
+    """
+    Total timeout (seconds).
+    """
 
     connect_timeout: NotRequired[int]
-    """Connection timeout (seconds)."""
+    """
+    Connection timeout (seconds).
+    """
 
     read_timeout: NotRequired[int]
-    """Read timeout (seconds)."""
+    """
+    Read timeout (seconds).
+    """
 
     tcp_keepalive: NotRequired[int]
-    """TCP keepalive time (seconds)."""
+    """
+    TCP keepalive time (seconds).
+    """
 
     tcp_keepalive_interval: NotRequired[int]
-    """TCP keepalive interval (seconds)."""
+    """
+    TCP keepalive interval (seconds).
+    """
 
     tcp_keepalive_retries: NotRequired[int]
-    """TCP keepalive retry count."""
+    """
+    TCP keepalive retry count.
+    """
 
     tcp_user_timeout: NotRequired[int]
-    """TCP user timeout (seconds)."""
+    """
+    TCP user timeout (seconds).
+    """
 
     tcp_nodelay: NotRequired[bool]
-    """Enable TCP_NODELAY."""
+    """
+    Enable TCP_NODELAY.
+    """
 
     tcp_reuse_address: NotRequired[bool]
-    """Enable SO_REUSEADDR."""
+    """
+    Enable SO_REUSEADDR.
+    """
 
     pool_idle_timeout: NotRequired[int]
-    """Connection pool idle timeout (seconds)."""
+    """
+    Connection pool idle timeout (seconds).
+    """
 
     pool_max_idle_per_host: NotRequired[int]
-    """Max idle connections per host."""
+    """
+    Max idle connections per host.
+    """
 
     pool_max_size: NotRequired[int]
-    """Max total connections in pool."""
+    """
+    Max total connections in pool.
+    """
 
     http1_only: NotRequired[bool]
-    """Enable HTTP/1.1 only."""
+    """
+    Enable HTTP/1.1 only.
+    """
 
     http2_only: NotRequired[bool]
-    """Enable HTTP/2 only."""
+    """
+    Enable HTTP/2 only.
+    """
 
     https_only: NotRequired[bool]
-    """Enable HTTPS only."""
+    """
+    Enable HTTPS only.
+    """
+
+    http1_options: NotRequired[Http1Options]
+    """
+    Sets the HTTP/1 options.
+    """
+
+    http2_options: NotRequired[Http2Options]
+    """
+    Sets the HTTP/2 options.
+    """
 
     verify: NotRequired[Union[bool, Path, CertStore]]
-    """Verify SSL or specify CA path."""
+    """
+    Verify SSL or specify CA path.
+    """
+
+    verify_hostname: NotRequired[bool]
+    """
+    Configures the use of hostname verification when connecting.
+    """
 
     identity: NotRequired[Identity]
-    """Represents a private key and X509 cert as a client certificate."""
+    """
+    Represents a private key and X509 cert as a client certificate.
+    """
 
-    keylog: NotRequired[KeyLogPolicy]
-    """Key logging policy (environment or file)."""
+    keylog: NotRequired[KeyLog]
+    """
+    Key logging policy (environment or file).
+    """
 
     tls_info: NotRequired[bool]
-    """Return TLS info."""
+    """
+    Return TLS info.
+    """
 
     min_tls_version: NotRequired[TlsVersion]
-    """Minimum TLS version."""
+    """
+    Minimum TLS version.
+    """
 
     max_tls_version: NotRequired[TlsVersion]
-    """Maximum TLS version."""
+    """
+    Maximum TLS version.
+    """
+
+    tls_options: NotRequired[TlsOptions]
+    """
+    Sets the TLS options.
+    """
 
     no_proxy: NotRequired[bool]
-    """Disable proxy."""
+    """
+    Disable proxy.
+    """
 
     proxies: NotRequired[List[Proxy]]
-    """Proxy server list."""
+    """
+    Proxy server list.
+    """
 
     local_address: NotRequired[Union[str, ipaddress.IPv4Address, ipaddress.IPv6Address]]
-    """Local bind address."""
+    """
+    Local bind address.
+    """
 
     interface: NotRequired[str]
-    """Local network interface."""
+    """
+    Local network interface.
+    """
 
     gzip: NotRequired[bool]
-    """Enable gzip decompression."""
+    """
+    Enable gzip decompression.
+    """
 
     brotli: NotRequired[bool]
-    """Enable brotli decompression."""
+    """
+    Enable brotli decompression.
+    """
 
     deflate: NotRequired[bool]
-    """Enable deflate decompression."""
+    """
+    Enable deflate decompression.
+    """
 
     zstd: NotRequired[bool]
-    """Enable zstd decompression."""
+    """
+    Enable zstd decompression.
+    """
 
 class Request(TypedDict):
     emulation: NotRequired[Union[Emulation, EmulationOption]]
-    """The Emulation settings for the request."""
+    """
+    The Emulation settings for the request.
+    """
 
     proxy: NotRequired[Proxy]
-    """The proxy to use for the request."""
+    """
+    The proxy to use for the request.
+    """
 
     local_address: NotRequired[Union[ipaddress.IPv4Address, ipaddress.IPv6Address]]
-    """Bind to a local IP Address."""
+    """
+    Bind to a local IP Address.
+    """
 
     interface: NotRequired[str]
-    """Bind to an interface by SO_BINDTODEVICE."""
+    """
+    Bind to an interface by SO_BINDTODEVICE.
+    """
 
     timeout: NotRequired[int]
-    """The timeout to use for the request."""
+    """
+    The timeout to use for the request.
+    """
 
     read_timeout: NotRequired[int]
-    """The read timeout to use for the request."""
+    """
+    The read timeout to use for the request.
+    """
 
     version: NotRequired[Version]
-    """The HTTP version to use for the request."""
+    """
+    The HTTP version to use for the request.
+    """
 
     headers: NotRequired[Union[Dict[str, str], HeaderMap]]
-    """The headers to use for the request."""
+    """
+    The headers to use for the request.
+    """
 
     orig_headers: NotRequired[Union[List[str], OrigHeaderMap]]
-    """The original headers to use for the request."""
+    """
+    The original headers to use for the request.
+    """
 
     default_headers: NotRequired[bool]
-    """The option enables default headers."""
+    """
+    The option enables default headers.
+    """
 
     cookies: NotRequired[Dict[str, str]]
-    """The cookies to use for the request."""
+    """
+    The cookies to use for the request.
+    """
 
     allow_redirects: NotRequired[bool]
-    """Whether to allow redirects."""
+    """
+    Whether to allow redirects.
+    """
 
     max_redirects: NotRequired[int]
-    """The maximum number of redirects to follow."""
+    """
+    The maximum number of redirects to follow.
+    """
 
     gzip: NotRequired[bool]
-    """Sets gzip as an accepted encoding."""
+    """
+    Sets gzip as an accepted encoding.
+    """
 
     brotli: NotRequired[bool]
-    """Sets brotli as an accepted encoding."""
+    """
+    Sets brotli as an accepted encoding.
+    """
 
     deflate: NotRequired[bool]
-    """Sets deflate as an accepted encoding."""
+    """
+    Sets deflate as an accepted encoding.
+    """
 
     zstd: NotRequired[bool]
-    """Sets zstd as an accepted encoding."""
+    """
+    Sets zstd as an accepted encoding.
+    """
 
     auth: NotRequired[str]
-    """The authentication to use for the request."""
+    """
+    The authentication to use for the request.
+    """
 
     bearer_auth: NotRequired[str]
-    """The bearer authentication to use for the request."""
+    """
+    The bearer authentication to use for the request.
+    """
 
     basic_auth: NotRequired[Tuple[str, Optional[str]]]
-    """The basic authentication to use for the request."""
+    """
+    The basic authentication to use for the request.
+    """
 
     query: NotRequired[List[Tuple[str, str]]]
-    """The query parameters to use for the request."""
+    """
+    The query parameters to use for the request.
+    """
 
     form: NotRequired[List[Tuple[str, str]]]
-    """The form parameters to use for the request."""
+    """
+    The form parameters to use for the request.
+    """
 
     json: NotRequired[Dict[str, Any]]
-    """The JSON body to use for the request."""
+    """
+    The JSON body to use for the request.
+    """
 
     body: NotRequired[
         Union[
@@ -776,53 +914,85 @@ class Request(TypedDict):
             AsyncGenerator[bytes, str],
         ]
     ]
-    """The body to use for the request."""
+    """
+    The body to use for the request.
+    """
 
     multipart: NotRequired[Multipart]
-    """The multipart form to use for the request."""
+    """
+    The multipart form to use for the request.
+    """
 
 class WebSocketRequest(TypedDict):
     emulation: NotRequired[Union[Emulation, EmulationOption]]
-    """The Emulation settings for the request."""
+    """
+    The Emulation settings for the request.
+    """
 
     proxy: NotRequired[Proxy]
-    """The proxy to use for the request."""
+    """
+    The proxy to use for the request.
+    """
 
     local_address: NotRequired[Union[str, ipaddress.IPv4Address, ipaddress.IPv6Address]]
-    """Bind to a local IP Address."""
+    """
+    Bind to a local IP Address.
+    """
 
     interface: NotRequired[str]
-    """Bind to an interface by SO_BINDTODEVICE."""
+    """
+    Bind to an interface by SO_BINDTODEVICE.
+    """
 
     headers: NotRequired[Union[Dict[str, str], HeaderMap]]
-    """The headers to use for the request."""
+    """
+    The headers to use for the request.
+    """
 
     orig_headers: NotRequired[Union[List[str], OrigHeaderMap]]
-    """The original headers to use for the request."""
+    """
+    The original headers to use for the request.
+    """
 
     default_headers: NotRequired[bool]
-    """The option enables default headers."""
+    """
+    The option enables default headers.
+    """
 
     cookies: NotRequired[Dict[str, str]]
-    """The cookies to use for the request."""
+    """
+    The cookies to use for the request.
+    """
 
     protocols: NotRequired[List[str]]
-    """The protocols to use for the request."""
+    """
+    The protocols to use for the request.
+    """
 
     force_http2: NotRequired[bool]
-    """Whether to use HTTP/2 for the websocket."""
+    """
+    Whether to use HTTP/2 for the websocket.
+    """
 
     auth: NotRequired[str]
-    """The authentication to use for the request."""
+    """
+    The authentication to use for the request.
+    """
 
     bearer_auth: NotRequired[str]
-    """The bearer authentication to use for the request."""
+    """
+    The bearer authentication to use for the request.
+    """
 
     basic_auth: NotRequired[Tuple[str, Optional[str]]]
-    """The basic authentication to use for the request."""
+    """
+    The basic authentication to use for the request.
+    """
 
     query: NotRequired[List[Tuple[str, str]]]
-    """The query parameters to use for the request."""
+    """
+    The query parameters to use for the request.
+    """
 
     read_buffer_size: NotRequired[int]
     """

rnet/blocking.py

@@ -77,6 +77,17 @@ class Response:
     Get the DER encoded leaf certificate of the response.
     """
 
+    def raise_for_status(self) -> None:
+        r"""
+        Turn a response into an error if the server returned an error.
+        """
+
+    def stream(self) -> Streamer:
+        r"""
+        Get the response into a `Streamer` of `bytes` from the body.
+        """
+        ...
+
     def text(self) -> str:
         r"""
         Get the text content of the response.
@@ -100,12 +111,6 @@ class Response:
         """
         ...
 
-    def stream(self) -> Streamer:
-        r"""
-        Get the response into a `Stream` of `Bytes` from the body.
-        """
-        ...
-
     def close(self) -> None:
         r"""
         Close the response connection.

rnet/emulation.py

@@ -1,6 +1,4 @@
 """
-Browser and Client Emulation
-
 This module provides functionality for emulating various browsers and HTTP clients
 to bypass detection and fingerprinting. It supports emulating Chrome, Firefox, Edge,
 Safari, Opera, and OkHttp clients across different operating systems and versions.
@@ -50,6 +48,9 @@ class Emulation(Enum):
     Chrome135 = auto()
     Chrome136 = auto()
     Chrome137 = auto()
+    Chrome138 = auto()
+    Chrome139 = auto()
+    Chrome140 = auto()
 
     # Microsoft Edge versions
     Edge101 = auto()
@@ -69,6 +70,8 @@ class Emulation(Enum):
     Firefox136 = auto()
     FirefoxPrivate136 = auto()
     Firefox139 = auto()
+    Firefox142 = auto()
+    Firefox143 = auto()
 
     # Safari versions
     SafariIos17_2 = auto()
@@ -90,6 +93,9 @@ class Emulation(Enum):
     Safari18_3_1 = auto()
     SafariIos18_1_1 = auto()
     Safari18_5 = auto()
+    Safari26 = auto()
+    SafariIos26 = auto()
+    SafariIPad26 = auto()
 
     # OkHttp versions
     OkHttp3_9 = auto()

rnet/exceptions.py

@@ -28,6 +28,12 @@ __all__ = [
 # ========================================
 
 
+class RustPanic(Exception):
+    r"""
+    A panic occurred in the underlying Rust code.
+    """
+
+
 class DNSResolverError(RuntimeError):
     r"""
     An error occurred while resolving a DNS name.