never-primp 1.0.0__cp38-abi3-win_amd64.whl

never_primp/__init__.py

@@ -0,0 +1,269 @@
+from __future__ import annotations
+
+import asyncio
+import sys
+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 .never_primp import RClient
+
+if TYPE_CHECKING:
+    from .never_primp import IMPERSONATE, IMPERSONATE_OS, ClientRequestParams, HttpMethod, RequestParams, Response
+else:
+
+    class _Unpack:
+        @staticmethod
+        def __getitem__(*args, **kwargs):
+            pass
+
+    Unpack = _Unpack()
+    RequestParams = ClientRequestParams = TypedDict
+
+
+class Client(RClient):
+    """Initializes an HTTP client that can impersonate web browsers."""
+
+    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,
+            cookie_store: bool | None = True,
+            referer: bool | None = True,
+            proxy: str | None = None,
+            timeout: float | None = 30,
+            impersonate: IMPERSONATE | None = None,
+            impersonate_os: IMPERSONATE_OS | None = None,
+            follow_redirects: bool | None = True,
+            max_redirects: int | None = 20,
+            verify: bool | None = True,
+            ca_cert_file: str | None = None,
+            https_only: bool | None = False,
+            http2_only: bool | None = False,
+            # Performance optimization parameters
+            pool_idle_timeout: float | None = None,
+            pool_max_idle_per_host: int | None = None,
+            tcp_nodelay: bool | None = None,
+            tcp_keepalive: float | None = None,
+            # Retry mechanism
+            retry_count: int | None = None,
+            retry_backoff: float | None = None,
+    ):
+        """
+        Args:
+            auth: a tuple containing the username and an optional password for basic authentication. Default is None.
+            auth_bearer: a string representing the bearer token for bearer token authentication. Default is None.
+            params: a map of query parameters to append to the URL. Default is None.
+            headers: an optional map of HTTP headers to send with requests. Ignored if `impersonate` is set.
+            cookie_store: enable a persistent cookie store. Received cookies will be preserved and included
+                 in additional requests. Default is True.
+            referer: automatic setting of the `Referer` header. Default is True.
+            proxy: proxy URL for HTTP requests, example: "socks5://127.0.0.1:9150". Default is None.
+            timeout: timeout for HTTP requests in seconds. Default is 30.
+            impersonate: impersonate browser. Supported browsers:
+                "chrome_100", "chrome_101", "chrome_104", "chrome_105", "chrome_106",
+                "chrome_107", "chrome_108", "chrome_109", "chrome_114", "chrome_116",
+                "chrome_117", "chrome_118", "chrome_119", "chrome_120", "chrome_123",
+                "chrome_124", "chrome_126", "chrome_127", "chrome_128", "chrome_129",
+                "chrome_130", "chrome_131", "chrome_133"
+                "safari_15.3", "safari_15.5", "safari_15.6.1", "safari_16",
+                "safari_16.5", "safari_17.0", "safari_17.2.1", "safari_17.4.1",
+                "safari_17.5", "safari_18",  "safari_18.2",
+                "safari_ios_16.5", "safari_ios_17.2", "safari_ios_17.4.1", "safari_ios_18.1.1",
+                "safari_ipad_18",
+                "okhttp_3.9", "okhttp_3.11", "okhttp_3.13", "okhttp_3.14", "okhttp_4.9",
+                "okhttp_4.10", "okhttp_5",
+                "edge_101", "edge_122", "edge_127", "edge_131",
+                "firefox_109", "firefox_117", "firefox_128", "firefox_133", "firefox_135".
+                Default is None.
+            impersonate_os: impersonate OS. Supported OS:
+                "android", "ios", "linux", "macos", "windows". Default is None.
+            follow_redirects: a boolean to enable or disable following redirects. Default is True.
+            max_redirects: the maximum number of redirects if `follow_redirects` is True. Default is 20.
+            verify: an optional boolean indicating whether to verify SSL certificates. Default is True.
+            ca_cert_file: path to CA certificate store. Default is None.
+            https_only: restrict the Client to be used with HTTPS only requests. Default is False.
+            http2_only: if true - use only HTTP/2, if false - use only HTTP/1. Default is False.
+        """
+        super().__init__()
+
+    def __enter__(self) -> Client:
+        return self
+
+    def __exit__(self, *args):
+        del self
+
+    def request(self, method: HttpMethod, url: str, **kwargs: Unpack[RequestParams]) -> Response:
+        return super().request(method=method, url=url, **kwargs)
+
+    def get(self, url: str, **kwargs: Unpack[RequestParams]) -> Response:
+        return self.request(method="GET", url=url, **kwargs)
+
+    def head(self, url: str, **kwargs: Unpack[RequestParams]) -> Response:
+        return self.request(method="HEAD", url=url, **kwargs)
+
+    def options(self, url: str, **kwargs: Unpack[RequestParams]) -> Response:
+        return self.request(method="OPTIONS", url=url, **kwargs)
+
+    def delete(self, url: str, **kwargs: Unpack[RequestParams]) -> Response:
+        return self.request(method="DELETE", url=url, **kwargs)
+
+    def post(self, url: str, **kwargs: Unpack[RequestParams]) -> Response:
+        return self.request(method="POST", url=url, **kwargs)
+
+    def put(self, url: str, **kwargs: Unpack[RequestParams]) -> Response:
+        return self.request(method="PUT", url=url, **kwargs)
+
+    def patch(self, url: str, **kwargs: Unpack[RequestParams]) -> Response:
+        return self.request(method="PATCH", url=url, **kwargs)
+
+
+class AsyncClient(Client):
+    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,
+                 cookie_store: bool | None = True,
+                 referer: bool | None = True,
+                 proxy: str | None = None,
+                 timeout: float | None = 30,
+                 impersonate: IMPERSONATE | None = None,
+                 impersonate_os: IMPERSONATE_OS | None = None,
+                 follow_redirects: bool | None = True,
+                 max_redirects: int | None = 20,
+                 verify: bool | None = True,
+                 ca_cert_file: str | None = None,
+                 https_only: bool | None = False,
+                 http2_only: bool | None = False,
+                 # Performance optimization parameters
+                 pool_idle_timeout: float | None = None,
+                 pool_max_idle_per_host: int | None = None,
+                 tcp_nodelay: bool | None = None,
+                 tcp_keepalive: float | None = None,
+                 # Retry mechanism
+                 retry_count: int | None = None,
+                 retry_backoff: float | None = None):
+        super().__init__()
+
+    async def __aenter__(self) -> AsyncClient:
+        return self
+
+    async def __aexit__(self, *args):
+        del self
+
+    async def _run_sync_asyncio(self, fn, *args, **kwargs):
+        loop = asyncio.get_running_loop()
+        return await loop.run_in_executor(None, partial(fn, *args, **kwargs))
+
+    async def request(self, method: HttpMethod, url: str, **kwargs: Unpack[RequestParams]):  # type: ignore
+        return await self._run_sync_asyncio(super().request, method=method, url=url, **kwargs)
+
+    async def get(self, url: str, **kwargs: Unpack[RequestParams]):  # type: ignore
+        return await self.request(method="GET", url=url, **kwargs)
+
+    async def head(self, url: str, **kwargs: Unpack[RequestParams]):  # type: ignore
+        return await self.request(method="HEAD", url=url, **kwargs)
+
+    async def options(self, url: str, **kwargs: Unpack[RequestParams]):  # type: ignore
+        return await self.request(method="OPTIONS", url=url, **kwargs)
+
+    async def delete(self, url: str, **kwargs: Unpack[RequestParams]):  # type: ignore
+        return await self.request(method="DELETE", url=url, **kwargs)
+
+    async def post(self, url: str, **kwargs: Unpack[RequestParams]):  # type: ignore
+        return await self.request(method="POST", url=url, **kwargs)
+
+    async def put(self, url: str, **kwargs: Unpack[RequestParams]):  # type: ignore
+        return await self.request(method="PUT", url=url, **kwargs)
+
+    async def patch(self, url: str, **kwargs: Unpack[RequestParams]):  # type: ignore
+        return await self.request(method="PATCH", url=url, **kwargs)
+
+
+def request(
+        method: HttpMethod,
+        url: str,
+        impersonate: IMPERSONATE | None = None,
+        impersonate_os: IMPERSONATE_OS | None = None,
+        verify: bool | None = True,
+        ca_cert_file: str | None = None,
+        **kwargs: Unpack[RequestParams],
+):
+    """
+    Args:
+        method: the HTTP method to use (e.g., "GET", "POST").
+        url: the URL to which the request will be made.
+        impersonate: impersonate browser. Supported browsers:
+            "chrome_100", "chrome_101", "chrome_104", "chrome_105", "chrome_106",
+            "chrome_107", "chrome_108", "chrome_109", "chrome_114", "chrome_116",
+            "chrome_117", "chrome_118", "chrome_119", "chrome_120", "chrome_123",
+            "chrome_124", "chrome_126", "chrome_127", "chrome_128", "chrome_129",
+            "chrome_130", "chrome_131", "chrome_133",
+            "safari_15.3", "safari_15.5", "safari_15.6.1", "safari_16",
+            "safari_16.5", "safari_17.0", "safari_17.2.1", "safari_17.4.1",
+            "safari_17.5", "safari_18",  "safari_18.2",
+            "safari_ios_16.5", "safari_ios_17.2", "safari_ios_17.4.1", "safari_ios_18.1.1",
+            "safari_ipad_18",
+            "okhttp_3.9", "okhttp_3.11", "okhttp_3.13", "okhttp_3.14", "okhttp_4.9",
+            "okhttp_4.10", "okhttp_5",
+            "edge_101", "edge_122", "edge_127", "edge_131",
+            "firefox_109", "firefox_117", "firefox_128", "firefox_133", "firefox_135".
+            Default is None.
+        impersonate_os: impersonate OS. Supported OS:
+            "android", "ios", "linux", "macos", "windows". Default is None.
+        verify: an optional boolean indicating whether to verify SSL certificates. Default is True.
+        ca_cert_file: path to CA certificate store. Default is None.
+        auth: a tuple containing the username and an optional password for basic authentication. Default is None.
+        auth_bearer: a string representing the bearer token for bearer token authentication. Default is None.
+        params: a map of query parameters to append to the URL. Default is None.
+        headers: an optional map of HTTP headers to send with requests. If `impersonate` is set, this will be ignored.
+        cookies: an optional map of cookies to send with requests as the `Cookie` header.
+        timeout: the timeout for the request in seconds. Default is 30.
+        content: the content to send in the request body as bytes. Default is None.
+        data: the form data to send in the request body. Default is None.
+        json: a JSON serializable object to send in the request body. Default is None.
+        files: a map of file fields to file paths to be sent as multipart/form-data. Default is None.
+    """
+    with Client(
+            impersonate=impersonate,
+            impersonate_os=impersonate_os,
+            verify=verify,
+            ca_cert_file=ca_cert_file,
+    ) as client:
+        return client.request(method, url, **kwargs)
+
+
+def get(url: str, **kwargs: Unpack[ClientRequestParams]):
+    return request(method="GET", url=url, **kwargs)
+
+
+def head(url: str, **kwargs: Unpack[ClientRequestParams]):
+    return request(method="HEAD", url=url, **kwargs)
+
+
+def options(url: str, **kwargs: Unpack[ClientRequestParams]):
+    return request(method="OPTIONS", url=url, **kwargs)
+
+
+def delete(url: str, **kwargs: Unpack[ClientRequestParams]):
+    return request(method="DELETE", url=url, **kwargs)
+
+
+def post(url: str, **kwargs: Unpack[ClientRequestParams]):
+    return request(method="POST", url=url, **kwargs)
+
+
+def put(url: str, **kwargs: Unpack[ClientRequestParams]):
+    return request(method="PUT", url=url, **kwargs)
+
+
+def patch(url: str, **kwargs: Unpack[ClientRequestParams]):
+    return request(method="PATCH", url=url, **kwargs)

never_primp/never_primp.pyi

@@ -0,0 +1,133 @@
+from __future__ import annotations
+
+import sys
+from typing import Any, Iterator, Literal, TypedDict
+
+if sys.version_info <= (3, 11):
+    from typing_extensions import Unpack
+else:
+    from typing import Unpack
+
+HttpMethod = Literal["GET", "HEAD", "OPTIONS", "DELETE", "POST", "PUT", "PATCH"]
+IMPERSONATE = Literal[
+        "chrome_100", "chrome_101", "chrome_104", "chrome_105", "chrome_106",
+        "chrome_107", "chrome_108", "chrome_109", "chrome_114", "chrome_116",
+        "chrome_117", "chrome_118", "chrome_119", "chrome_120", "chrome_123",
+        "chrome_124", "chrome_126", "chrome_127", "chrome_128", "chrome_129",
+        "chrome_130", "chrome_131", "chrome_133", "chrome_134", "chrome_135",
+        "chrome_136", "chrome_137", "chrome_138", "chrome_139",
+        "chrome_140","chrome_141",
+        "safari_15.3", "safari_15.5", "safari_15.6.1", "safari_16",
+        "safari_16.5", "safari_17.0", "safari_17.2.1", "safari_17.4.1",
+        "safari_17.5", "safari_18",  "safari_18.2","safari_18.3","safari_18.3.1","safari_18.5",
+        "safari_ios_16.5", "safari_ios_17.2", "safari_ios_17.4.1", "safari_ios_18.1.1",
+        "safari_ipad_18","safari_26","safari_ipad_26","safari_ios_26",
+        "okhttp_3.9", "okhttp_3.11", "okhttp_3.13", "okhttp_3.14", "okhttp_4.9",
+        "okhttp_4.10", "okhttp_4.12","okhttp_5",
+        "edge_101", "edge_122", "edge_127", "edge_131","edge_134",
+        "opera_116", "opera_117", "opera_118", "opera_119",
+        "firefox_109", "firefox_117", "firefox_128", "firefox_133", "firefox_135",
+        "firefox_136", "firefox_139", "firefox_142", "firefox_143", "firefox_android_135",
+        "firefox_private_135", "firefox_private_136",
+        "random",
+    ]  # fmt: skip
+IMPERSONATE_OS = Literal["android", "ios", "linux", "macos", "windows", "random"]
+
+class RequestParams(TypedDict, total=False):
+    auth: tuple[str, str | None] | None
+    auth_bearer: str | None
+    params: dict[str, str] | None
+    headers: dict[str, str] | None
+    cookies: dict[str, str] | None
+    timeout: float | None
+    content: bytes | None
+    data: dict[str, Any] | None
+    json: Any | None
+    files: dict[str, str] | None
+
+class ClientRequestParams(RequestParams):
+    impersonate: IMPERSONATE | None
+    impersonate_os: IMPERSONATE_OS | None
+    verify: bool | None
+    ca_cert_file: str | None
+
+class Response:
+    @property
+    def content(self) -> bytes: ...
+    @property
+    def cookies(self) -> dict[str, str]: ...
+    @property
+    def headers(self) -> dict[str, str]: ...
+    @property
+    def status_code(self) -> int: ...
+    @property
+    def url(self) -> str: ...
+    @property
+    def encoding(self) -> str: ...
+    @property
+    def text(self) -> str: ...
+    def json(self) -> Any: ...
+    def stream(self) -> Iterator[bytes]: ...
+    @property
+    def text_markdown(self) -> str: ...
+    @property
+    def text_plain(self) -> str: ...
+    @property
+    def text_rich(self) -> str: ...
+
+class RClient:
+    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,
+        timeout: float | None = None,
+        cookie_store: bool | None = True,
+        referer: bool | None = True,
+        proxy: str | None = None,
+        impersonate: IMPERSONATE | None = None,
+        impersonate_os: IMPERSONATE_OS | None = None,
+        follow_redirects: bool | None = True,
+        max_redirects: int | None = 20,
+        verify: bool | None = True,
+        ca_cert_file: str | None = None,
+        https_only: bool | None = False,
+        http2_only: bool | None = False,
+    ): ...
+    @property
+    def headers(self) -> dict[str, str]: ...
+    @headers.setter
+    def headers(self, headers: dict[str, str]) -> None: ...
+    def headers_update(self, headers: dict[str, str]) -> None: ...
+    def get_cookies(self, url: str) -> dict[str, str]: ...
+    def set_cookies(self, url: str, cookies: dict[str, str]) -> None: ...
+    @property
+    def proxy(self) -> str | None: ...
+    @proxy.setter
+    def proxy(self, proxy: str) -> None: ...
+    @property
+    def impersonate(self) -> str | None: ...
+    @impersonate.setter
+    def impersonate(self, impersonate: IMPERSONATE) -> None: ...
+    @property
+    def impersonate_os(self) -> str | None: ...
+    @impersonate_os.setter
+    def impersonate_os(self, impersonate: IMPERSONATE_OS) -> None: ...
+    def request(self, method: HttpMethod, url: str, **kwargs: Unpack[RequestParams]) -> Response: ...
+    def get(self, url: str, **kwargs: Unpack[RequestParams]) -> Response: ...
+    def head(self, url: str, **kwargs: Unpack[RequestParams]) -> Response: ...
+    def options(self, url: str, **kwargs: Unpack[RequestParams]) -> Response: ...
+    def delete(self, url: str, **kwargs: Unpack[RequestParams]) -> Response: ...
+    def post(self, url: str, **kwargs: Unpack[RequestParams]) -> Response: ...
+    def put(self, url: str, **kwargs: Unpack[RequestParams]) -> Response: ...
+    def patch(self, url: str, **kwargs: Unpack[RequestParams]) -> Response: ...
+
+def request(method: HttpMethod, url: str, **kwargs: Unpack[ClientRequestParams]) -> Response: ...
+def get(url: str, **kwargs: Unpack[ClientRequestParams]) -> Response: ...
+def head(url: str, **kwargs: Unpack[ClientRequestParams]) -> Response: ...
+def options(url: str, **kwargs: Unpack[ClientRequestParams]) -> Response: ...
+def delete(url: str, **kwargs: Unpack[ClientRequestParams]) -> Response: ...
+def post(url: str, **kwargs: Unpack[ClientRequestParams]) -> Response: ...
+def put(url: str, **kwargs: Unpack[ClientRequestParams]) -> Response: ...
+def patch(url: str, **kwargs: Unpack[ClientRequestParams]) -> Response: ...

never_primp-1.0.0.dist-info/METADATA

@@ -0,0 +1,338 @@
+Metadata-Version: 2.4
+Name: never_primp
+Version: 1.0.0
+Summary: 基于原primp 重新优化调整的请求库
+Author: Neverland
+Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
+
+![Python >= 3.8](https://img.shields.io/badge/python->=3.8-red.svg) [![](https://badgen.net/github/release/deedy5/pyreqwest-impersonate)](https://github.com/deedy5/pyreqwest-impersonate/releases) [![](https://badge.fury.io/py/primp.svg)](https://pypi.org/project/primp) [![Downloads](https://static.pepy.tech/badge/primp/week)](https://pepy.tech/project/primp) [![CI](https://github.com/deedy5/pyreqwest-impersonate/actions/workflows/CI.yml/badge.svg?branch=main)](https://github.com/deedy5/pyreqwest-impersonate/actions/workflows/CI.yml)
+# 🪞NEVER_PRIMP
+**🪞NEVER_PRIMP** = **P**ython **R**equests **IMP**ersonate
+
+The fastest python HTTP client that can impersonate web browsers.</br>
+Provides precompiled wheels:</br>
+  * 🐧 linux: `amd64`, `aarch64`, `armv7` (⚠️aarch64 and armv7 builds are `manylinux_2_34` compatible - `ubuntu>=22.04`, `debian>=12`);</br>
+  * 🐧 musllinux: `amd64`, `aarch64`;</br>
+  * 🪟 windows: `amd64`;</br>
+  * 🍏 macos: `amd64`, `aarch64`.</br>
+
+## Table of Contents
+
+- [Installation](#installation)
+- [Key Features](#key-features)
+- [Benchmark](#benchmark)
+- [Usage](#usage)
+  - [I. Client](#i-client)
+    - [Client methods](#client-methods)
+    - [Response object](#response-object)
+    - [Devices](#devices)
+    - [Examples](#examples)
+  - [II. AsyncClient](#ii-asyncclient)
+- [Disclaimer](#disclaimer)
+
+## Installation
+
+```python
+pip install -U never_primp
+```
+
+## Key Features
+
+🚀 **Performance Optimized**
+- Connection pooling with configurable idle timeout and max connections per host
+- TCP optimization (TCP_NODELAY, TCP keepalive)
+- ~59% faster for sequential requests with connection reuse
+
+🔒 **Advanced Certificate Management**
+- Uses system's native certificate store (auto-updated with OS)
+- No more certificate expiration issues
+- Custom CA bundle support
+
+🍪 **Smart Cookie Management**
+- Automatic cookie persistence using wreq's native Jar API
+- Manual cookie control with `get_cookies()` / `set_cookies()`
+- Cookies survive client configuration changes
+
+⚙️ **Dynamic Configuration**
+- Modify headers, proxy, and impersonation at runtime
+- No need to recreate the client
+- Thread-safe configuration updates
+
+🔄 **Retry Mechanism**
+- Configurable retry count and backoff timing
+- Handle transient failures gracefully
+
+🎭 **Browser Impersonation**
+- Impersonate Chrome, Safari, Edge, Firefox, OkHttp
+- Mimic TLS/JA3/JA4/HTTP2 fingerprints
+- Custom OS impersonation (Windows, macOS, Linux, Android, iOS)
+
+## Usage
+### I. Client
+
+HTTP client that can impersonate web browsers.
+```python
+class Client:
+    """Initializes an HTTP client that can impersonate web browsers.
+
+    Args:
+        auth (tuple[str, str| None] | None): Username and password for basic authentication. Default is None.
+        auth_bearer (str | None): Bearer token for authentication. Default is None.
+        params (dict[str, str] | None): Default query parameters to include in all requests. Default is None.
+        headers (dict[str, str] | None): Default headers to send with requests. If `impersonate` is set, this will be ignored.
+        timeout (float | None): HTTP request timeout in seconds. Default is 30.
+        cookie_store (bool | None): Enable a persistent cookie store. Received cookies will be preserved and included
+            in additional requests. Default is True.
+        referer (bool | None): Enable or disable automatic setting of the `Referer` header. Default is True.
+        proxy (str | None): Proxy URL for HTTP requests. Example: "socks5://127.0.0.1:9150". Default is None.
+        impersonate (str | None): Entity to impersonate. Example: "chrome_124". Default is None.
+            Chrome: "chrome_100","chrome_101","chrome_104","chrome_105","chrome_106","chrome_107","chrome_108",
+                "chrome_109","chrome_114","chrome_116","chrome_117","chrome_118","chrome_119","chrome_120",
+                "chrome_123","chrome_124","chrome_126","chrome_127","chrome_128","chrome_129","chrome_130",
+                "chrome_131","chrome_133"
+            Safari: "safari_ios_16.5","safari_ios_17.2","safari_ios_17.4.1","safari_ios_18.1.1",
+                "safari_15.3","safari_15.5","safari_15.6.1","safari_16","safari_16.5","safari_17.0",
+                "safari_17.2.1","safari_17.4.1","safari_17.5","safari_18","safari_18.2","safari_ipad_18"
+            OkHttp: "okhttp_3.9","okhttp_3.11","okhttp_3.13","okhttp_3.14","okhttp_4.9","okhttp_4.10","okhttp_5"
+            Edge: "edge_101","edge_122","edge_127","edge_131"
+            Firefox: "firefox_109","firefox_117","firefox_128","firefox_133","firefox_135"
+            Select random: "random"
+        impersonate_os (str | None): impersonate OS. Example: "windows". Default is "linux".
+            Android: "android", iOS: "ios", Linux: "linux", Mac OS: "macos", Windows: "windows"
+            Select random: "random"
+        follow_redirects (bool | None): Whether to follow redirects. Default is True.
+        max_redirects (int | None): Maximum redirects to follow. Default 20. Applies if `follow_redirects` is True.
+        verify (bool | None): Verify SSL certificates. Default is True.
+        ca_cert_file (str | None): Path to CA certificate store. Default is None.
+        https_only (bool | None): Restrict the Client to be used with HTTPS only requests. Default is False.
+        http2_only (bool | None): If true - use only HTTP/2; if false - use only HTTP/1. Default is False.
+        pool_idle_timeout (float | None): Connection pool idle timeout in seconds. Default is None.
+        pool_max_idle_per_host (int | None): Maximum number of idle connections per host. Default is None.
+        tcp_nodelay (bool | None): Enable TCP_NODELAY (disable Nagle's algorithm). Default is None.
+        tcp_keepalive (float | None): TCP keepalive interval in seconds. Default is None.
+        retry_count (int | None): Maximum number of retry attempts. Default is None.
+        retry_backoff (float | None): Backoff time between retries in seconds. Default is None.
+
+    """
+```
+
+#### Client methods
+
+The `Client` class provides a set of methods for making HTTP requests: `get`, `head`, `options`, `delete`, `post`, `put`, `patch`, each of which internally utilizes the `request()` method for execution. The parameters for these methods closely resemble those in `httpx`.
+```python
+def get(
+    url: str,
+    params: dict[str, str] | None = None,
+    headers: dict[str, str] | None = None,
+    cookies: dict[str, str] | None = None,
+    auth: tuple[str, str| None] | None = None,
+    auth_bearer: str | None = None,
+    timeout: float | None = 30,
+):
+    """Performs a GET request to the specified URL.
+
+    Args:
+        url (str): The URL to which the request will be made.
+        params (dict[str, str] | None): A map of query parameters to append to the URL. Default is None.
+        headers (dict[str, str] | None): A map of HTTP headers to send with the request. Default is None.
+        cookies (dict[str, str] | None): - An optional map of cookies to send with requests as the `Cookie` header.
+        auth (tuple[str, str| None] | None): A tuple containing the username and an optional password
+            for basic authentication. Default is None.
+        auth_bearer (str | None): A string representing the bearer token for bearer token authentication. Default is None.
+        timeout (float | None): The timeout for the request in seconds. Default is 30.
+
+    """
+```
+```python
+def post(
+    url: str,
+    params: dict[str, str] | None = None,
+    headers: dict[str, str] | None = None,
+    cookies: dict[str, str] | None = None,
+    content: bytes | None = None,
+    data: dict[str, Any] | None = None,
+    json: Any | None = None,
+    files: dict[str, str] | None = None,
+    auth: tuple[str, str| None] | None = None,
+    auth_bearer: str | None = None,
+    timeout: float | None = 30,
+):
+    """Performs a POST request to the specified URL.
+
+    Args:
+        url (str): The URL to which the request will be made.
+        params (dict[str, str] | None): A map of query parameters to append to the URL. Default is None.
+        headers (dict[str, str] | None): A map of HTTP headers to send with the request. Default is None.
+        cookies (dict[str, str] | None): - An optional map of cookies to send with requests as the `Cookie` header.
+        content (bytes | None): The content to send in the request body as bytes. Default is None.
+        data (dict[str, Any] | None): The form data to send in the request body. Default is None.
+        json (Any | None): A JSON serializable object to send in the request body. Default is None.
+        files (dict[str, str] | None): A map of file fields to file paths to be sent as multipart/form-data. Default is None.
+        auth (tuple[str, str| None] | None): A tuple containing the username and an optional password
+            for basic authentication. Default is None.
+        auth_bearer (str | None): A string representing the bearer token for bearer token authentication. Default is None.
+        timeout (float | None): The timeout for the request in seconds. Default is 30.
+
+    """
+```
+#### Response object
+```python
+resp.content
+resp.stream()  # stream the response body in chunks of bytes
+resp.cookies
+resp.encoding
+resp.headers
+resp.json()
+resp.status_code
+resp.text
+resp.text_markdown  # html is converted to markdown text
+resp.text_plain  # html is converted to plain text
+resp.text_rich  # html is converted to rich text
+resp.url
+```
+
+#### Devices
+
+##### Impersonate
+
+- Chrome: `chrome_100`，`chrome_101`，`chrome_104`，`chrome_105`，`chrome_106`，`chrome_107`，`chrome_108`，`chrome_109`，`chrome_114`，`chrome_116`，`chrome_117`，`chrome_118`，`chrome_119`，`chrome_120`，`chrome_123`，`chrome_124`，`chrome_126`，`chrome_127`，`chrome_128`，`chrome_129`，`chrome_130`，`chrome_131`, `chrome_133`, `chrome_134`, `chrome_135`, `chrome_136`, `chrome_137`, `chrome_138`, `chrome_139`, `chrome_140`, `chrome_141`
+
+- Edge: `edge_101`，`edge_122`，`edge_127`, `edge_131`, `edge_134`
+
+- Safari: `safari_ios_17.2`，`safari_ios_17.4.1`，`safari_ios_16.5`，`safari_ios_18.1.1`, `safari_15.3`，`safari_15.5`，`safari_15.6.1`，`safari_16`，`safari_16.5`，`safari_17.0`，`safari_17.2.1`，`safari_17.4.1`，`safari_17.5`，`safari_18`，`safari_18.2`, `safari_ipad_18`, `safari_ipad_26`, `safari_ios_26`, `safari_26`
+
+- OkHttp: `okhttp_3.9`，`okhttp_3.11`，`okhttp_3.13`，`okhttp_3.14`，`okhttp_4.9`，`okhttp_4.10`，`okhttp_5`
+
+- Firefox: `firefox_109`, `firefox_117`, `firefox_128`, `firefox_133`, `firefox_135`, `firefox_136`, `firefox_139`, `firefox_142`, `firefox_143`
+
+##### Impersonate OS
+
+- `android`, `ios`, `linux`, `macos`, `windows`
+
+#### Examples
+
+```python
+import never_primp as primp
+
+# Impersonate
+client = primp.Client(impersonate="chrome_131", impersonate_os="windows")
+
+# Performance optimization with connection pooling
+client = primp.Client(
+    impersonate="chrome_131",
+    pool_idle_timeout=90.0,        # Keep connections alive for 90 seconds
+    pool_max_idle_per_host=10,     # Max 10 idle connections per host
+    tcp_nodelay=True,               # Disable Nagle's algorithm for lower latency
+    tcp_keepalive=60.0,            # TCP keepalive every 60 seconds
+)
+
+# Retry mechanism
+client = primp.Client(
+    retry_count=3,                  # Retry up to 3 times
+    retry_backoff=1.0,              # 1 second backoff between retries
+)
+
+# Dynamic configuration updates
+client.headers = {"User-Agent": "Custom User Agent"}  # Update all headers
+client.headers_update({"Referer": "https://example.com"})  # Merge new headers
+client.proxy = "http://127.0.0.1:8080"  # Change proxy
+client.impersonate = "chrome_133"  # Change browser impersonation
+client.impersonate_os = "macos"  # Change OS impersonation
+
+# GET request
+resp = client.get("https://tls.peet.ws/api/all")
+
+# GET request with passing params and setting timeout
+params = {"param1": "value1", "param2": "value2"}
+resp = client.post(url="https://httpbin.org/anything", params=params, timeout=10)
+
+# Stream response
+resp = client.get("https://nytimes")
+for chunk in resp.stream():
+    print(chunk)
+
+# Cookie management - Automatic (recommended)
+client = primp.Client(cookie_store=True)  # Default: enabled
+resp = client.get("https://httpbin.org/cookies/set?session=abc123")
+# Cookies are automatically stored and sent in subsequent requests
+resp2 = client.get("https://httpbin.org/cookies")  # Session cookie automatically included
+
+# Cookie management - Manual
+cookies = {"c1_n": "c1_value", "c2_n": "c2_value"}
+client.set_cookies(url="https://nytimes.com", cookies=cookies)  # Set cookies for a specific domain
+resp = client.get("https://nytimes.com/", cookies=cookies)  # Or pass cookies in request
+
+# Get cookies
+all_cookies = client.get_cookies(url="https://nytimes.com")  # Get all cookies from jar
+response_cookies = resp.cookies  # Get cookies from response
+
+# POST Binary Request Data
+content = b"some_data"
+resp = client.post(url="https://httpbin.org/anything", content=content)
+
+# POST Form Encoded Data
+data = {"key1": "value1", "key2": "value2"}
+resp = client.post(url="https://httpbin.org/anything", data=data)
+
+# POST JSON Encoded Data
+json = {"key1": "value1", "key2": "value2"}
+resp = client.post(url="https://httpbin.org/anything", json=json)
+
+# POST Multipart-Encoded Files
+files = {'file1': '/home/root/file1.txt', 'file2': 'home/root/file2.txt'}
+resp = client.post("https://httpbin.org/post", files=files)
+
+# Authentication using user/password
+resp = client.post(url="https://httpbin.org/anything", auth=("user", "password"))
+
+# Authentication using auth bearer
+resp = client.post(url="https://httpbin.org/anything", auth_bearer="bearerXXXXXXXXXXXXXXXXXXXX")
+
+# Using proxy or env var PRIMP_PROXY
+resp = primp.Client(proxy="http://127.0.0.1:8080")  # set proxy in Client
+export PRIMP_PROXY="socks5://127.0.0.1:1080"  # set proxy as environment variable
+
+# SSL/TLS certificate verification
+# Note: Primp uses your system's native certificate store by default (auto-updated with OS)
+resp = primp.Client(verify=True)  # Default: uses system certificates
+
+# Using custom CA certificate store:
+resp = primp.Client(ca_cert_file="/cert/cacert.pem")
+resp = primp.Client(ca_cert_file=certifi.where())
+export PRIMP_CA_BUNDLE="/home/user/Downloads/cert.pem"  # set as environment variable
+
+# You can also use convenience functions that use a default Client instance under the hood:
+# primp.get() | primp.head() | primp.options() | primp.delete() | primp.post() | primp.patch() | primp.put()
+# These functions can accept the `impersonate` parameter:
+resp = primp.get("https://httpbin.org/anything", impersonate="chrome_131", impersonate_os="android")
+```
+
+### II. AsyncClient
+
+`primp.AsyncClient()` is an asynchronous wrapper around the `primp.Client` class, offering the same functions, behavior, and input arguments.
+
+```python3
+import asyncio
+import logging
+
+import never_primp as primp
+
+async def aget_text(url):
+    async with primp.AsyncClient(impersonate="chrome_131") as client:
+        resp = await client.get(url)
+        return resp.text
+
+async def main():
+    urls = ["https://nytimes.com/", "https://cnn.com/", "https://abcnews.go.com/"]
+    tasks = [aget_text(u) for u in urls]
+    results = await asyncio.gather(*tasks)
+
+if __name__ == "__main__":
+    logging.basicConfig(level=logging.INFO)
+    asyncio.run(main())
+```
+
+## Disclaimer
+
+This tool is for educational purposes only. Use it at your own risk.
+

never_primp-1.0.0.dist-info/RECORD

@@ -0,0 +1,7 @@
+never_primp-1.0.0.dist-info/METADATA,sha256=Cuiw8t_orxEPdw7hBh3bO5WN6uCZoeuKsgOwpJhHaUw,15657
+never_primp-1.0.0.dist-info/WHEEL,sha256=CG8OzNtm0LMpJ2zhrjswlO8N-965OeMLklsQAG-nMvQ,94
+never_primp/__init__.py,sha256=Y6Bs079kVXF4HWG2ZpmatSAirlcPCFZ4P0FyGG9ZvLo,12810
+never_primp/never_primp.pyd,sha256=2bWHiIOmBgitjbGsgXNAq1YbBtPv8MSJFxzPvvKYETg,6435328
+never_primp/never_primp.pyi,sha256=8QRuXaqNfk29qkFZrbtwKKK92Y_wL-O702nys8DCcM0,5731
+never_primp/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+never_primp-1.0.0.dist-info/RECORD,,

never_primp-1.0.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: maturin (1.9.6)
+Root-Is-Purelib: false
+Tag: cp38-abi3-win_amd64