never-primp 1.0.1__cp38-abi3-win_amd64.whl → 1.0.2__cp38-abi3-win_amd64.whl

never_primp/__init__.py

@@ -3,7 +3,8 @@ from __future__ import annotations
 import asyncio
 import sys
 from functools import partial
-from typing import TYPE_CHECKING, TypedDict
+from typing import TYPE_CHECKING, TypedDict, Iterator
+from collections.abc import MutableMapping
 
 if sys.version_info <= (3, 11):
     from typing_extensions import Unpack
@@ -26,6 +27,112 @@ else:
     RequestParams = ClientRequestParams = TypedDict
 
 
+class CookieJar(MutableMapping):
+    """
+    A dict-like container for managing HTTP cookies, compatible with requests.Session.cookies API.
+
+    Examples:
+        client = Client()
+
+        # Set cookies
+        client.cookies['session_id'] = 'abc123'
+        client.cookies['user_token'] = 'xyz789'
+
+        # Get cookies
+        value = client.cookies['session_id']
+        value = client.cookies.get('user_token', 'default')
+
+        # Update multiple cookies
+        client.cookies.update({'key1': 'value1', 'key2': 'value2'})
+
+        # Delete cookies
+        del client.cookies['session_id']
+
+        # Clear all cookies
+        client.cookies.clear()
+
+        # Check existence
+        if 'session_id' in client.cookies:
+            print("Session exists")
+
+        # Convert to dict
+        all_cookies = dict(client.cookies)
+    """
+
+    def __init__(self, client: RClient):
+        """Initialize CookieJar with a reference to the client."""
+        self._client = client
+
+    def __getitem__(self, name: str) -> str:
+        """Get a cookie value by name."""
+        value = self._client.get_cookie(name)
+        if value is None:
+            raise KeyError(name)
+        return value
+
+    def __setitem__(self, name: str, value: str) -> None:
+        """Set a cookie by name."""
+        self._client.set_cookie(name, value)
+
+    def __delitem__(self, name: str) -> None:
+        """Delete a cookie by name."""
+        # Check if cookie exists first
+        if self._client.get_cookie(name) is None:
+            raise KeyError(name)
+        self._client.delete_cookie(name)
+
+    def __iter__(self) -> Iterator[str]:
+        """Iterate over cookie names."""
+        return iter(self._client.get_all_cookies().keys())
+
+    def __len__(self) -> int:
+        """Return the number of cookies."""
+        return len(self._client.get_all_cookies())
+
+    def __contains__(self, name: object) -> bool:
+        """Check if a cookie exists."""
+        if not isinstance(name, str):
+            return False
+        return self._client.get_cookie(name) is not None
+
+    def __repr__(self) -> str:
+        """Return string representation of cookies."""
+        cookies = self._client.get_all_cookies()
+        return f"CookieJar({cookies})"
+
+    def get(self, name: str, default: str | None = None) -> str | None:
+        """Get a cookie value with a default fallback."""
+        value = self._client.get_cookie(name)
+        return value if value is not None else default
+
+    def update(self, cookies: dict[str, str], domain: str | None = None, path: str | None = None) -> None:
+        """
+        Update multiple cookies at once.
+
+        Args:
+            cookies: Dictionary of cookie names to values
+            domain: Optional domain for the cookies (e.g., ".example.com")
+            path: Optional path for the cookies (e.g., "/")
+        """
+        self._client.update_cookies(cookies, domain=domain, path=path)
+
+    def clear(self) -> None:
+        """Remove all cookies."""
+        self._client.clear_cookies()
+
+    def set(self, name: str, value: str, domain: str | None = None, path: str | None = None) -> None:
+        """
+        Set a single cookie with optional domain and path.
+
+        Args:
+            name: Cookie name
+            value: Cookie value
+            domain: Optional domain (e.g., ".example.com")
+            path: Optional path (e.g., "/")
+        """
+        self._client.set_cookie(name, value, domain=domain, path=path)
+
+
 class Client(RClient):
     """Initializes an HTTP client that can impersonate web browsers."""
 
@@ -103,6 +210,35 @@ class Client(RClient):
             http2_only: if true - use only HTTP/2, if false - use only HTTP/1. Default is False.
         """
         super().__init__()
+        self._cookies_jar: CookieJar | None = None
+
+    @property
+    def cookies(self) -> CookieJar:
+        """
+        Access the cookie jar for dict-like cookie management.
+
+        Returns:
+            CookieJar: A dict-like container for managing cookies.
+
+        Examples:
+            # Set cookies
+            client.cookies['session_id'] = 'abc123'
+
+            # Get cookies
+            value = client.cookies['session_id']
+
+            # Update cookies
+            client.cookies.update({'key': 'value'})
+
+            # Delete cookies
+            del client.cookies['session_id']
+
+            # Clear all
+            client.cookies.clear()
+        """
+        if self._cookies_jar is None:
+            self._cookies_jar = CookieJar(self)
+        return self._cookies_jar
 
     def __enter__(self) -> Client:
         return self

never_primp/never_primp.pyi

@@ -38,6 +38,7 @@ class RequestParams(TypedDict, total=False):
     auth_bearer: str | None
     params: dict[str, str] | None
     headers: dict[str, str] | None
+    ordered_headers: dict[str, str] | None
     cookies: dict[str, str] | None
     timeout: float | None
     content: bytes | None
@@ -82,8 +83,10 @@ class RClient:
         auth_bearer: str | None = None,
         params: dict[str, str] | None = None,
         headers: dict[str, str] | None = None,
+        ordered_headers: dict[str, str] | None = None,
         timeout: float | None = None,
         cookie_store: bool | None = True,
+        split_cookies: bool | None = False,
         referer: bool | None = True,
         proxy: str | None = None,
         impersonate: IMPERSONATE | None = None,
@@ -94,14 +97,59 @@ class RClient:
         ca_cert_file: str | None = None,
         https_only: bool | None = False,
         http2_only: bool | None = False,
+        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_count: int | None = None,
+        retry_backoff: float | None = None,
     ): ...
     @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 ordered_headers(self) -> dict[str, str]: ...
+    @ordered_headers.setter
+    def ordered_headers(self, ordered_headers: dict[str, str]) -> None: ...
+    def ordered_headers_update(self, ordered_headers: dict[str, str]) -> None: ...
+    # Cookie management methods (no URL required)
+    def get_all_cookies(self) -> dict[str, str]: ...
+    def set_cookie(self, name: str, value: str, domain: str | None = None, path: str | None = None) -> None: ...
+    def get_cookie(self, name: str) -> str | None: ...
+    def update_cookies(self, cookies: dict[str, str], domain: str | None = None, path: str | None = None) -> None: ...
+    def delete_cookie(self, name: str) -> None: ...
+    def clear_cookies(self) -> None: ...
+    # Client properties
+    @property
+    def auth(self) -> tuple[str, str | None] | None: ...
+    @auth.setter
+    def auth(self, auth: tuple[str, str | None] | None) -> None: ...
+    @property
+    def auth_bearer(self) -> str | None: ...
+    @auth_bearer.setter
+    def auth_bearer(self, auth_bearer: str | None) -> None: ...
+    @property
+    def params(self) -> dict[str, str] | None: ...
+    @params.setter
+    def params(self, params: dict[str, str] | None) -> None: ...
+    @property
+    def timeout(self) -> float | None: ...
+    @timeout.setter
+    def timeout(self, timeout: float | None) -> None: ...
+    @property
+    def split_cookies(self) -> bool | None: ...
+    @split_cookies.setter
+    def split_cookies(self, split_cookies: bool | None) -> None: ...
+    @property
+    def retry_count(self) -> int | None: ...
+    @retry_count.setter
+    def retry_count(self, retry_count: int | None) -> None: ...
+    @property
+    def retry_backoff(self) -> float | None: ...
+    @retry_backoff.setter
+    def retry_backoff(self, retry_backoff: float | None) -> None: ...
     @property
     def proxy(self) -> str | None: ...
     @proxy.setter

{never_primp-1.0.1.dist-info → never_primp-1.0.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: never_primp
-Version: 1.0.1
+Version: 1.0.2
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: MIT License

never_primp-1.0.2.dist-info/RECORD

@@ -0,0 +1,8 @@
+never_primp-1.0.2.dist-info/METADATA,sha256=OypnoTJVQ-gguQjVpLBGpnoepNWIY92MhlCAOSXHJwE,22313
+never_primp-1.0.2.dist-info/WHEEL,sha256=CG8OzNtm0LMpJ2zhrjswlO8N-965OeMLklsQAG-nMvQ,94
+never_primp-1.0.2.dist-info/licenses/LICENSE,sha256=O15TIxUAXq6sSpPu0K3CJu_dT5ZzCgIk7hQtZsf0lEk,1084
+never_primp/__init__.py,sha256=KIXkg0XwGRBw889rtgMMr_lVCpXABihqDu5eVjxp8wA,18209
+never_primp/never_primp.pyd,sha256=s1pse_cZvns2ogDZLtWEcPsKgXIXOMAM7jjnGjUDIgY,7859712
+never_primp/never_primp.pyi,sha256=f3GNfXXLG5mS32djn56NVztEmnH5oUl_jefPiArZlkI,8001
+never_primp/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+never_primp-1.0.2.dist-info/RECORD,,

never_primp-1.0.1.dist-info/RECORD

@@ -1,8 +0,0 @@
-never_primp-1.0.1.dist-info/METADATA,sha256=XhOOmBjktcET3fVdb6Xwp6j05fUAP4tMp2fs7RUsQJE,22313
-never_primp-1.0.1.dist-info/WHEEL,sha256=CG8OzNtm0LMpJ2zhrjswlO8N-965OeMLklsQAG-nMvQ,94
-never_primp-1.0.1.dist-info/licenses/LICENSE,sha256=O15TIxUAXq6sSpPu0K3CJu_dT5ZzCgIk7hQtZsf0lEk,1084
-never_primp/__init__.py,sha256=RuWR5idNc3rc0Naih8oGxAd05a7P59sygZ8Amjt79Nk,13775
-never_primp/never_primp.pyd,sha256=ruikT36dM_5Upup7y_Tr8AJFAialOi0RWnOh5WYgDHM,7844864
-never_primp/never_primp.pyi,sha256=A3HZEoz6yvXOacM0JEcXF4hXOd6RTe53Sgmz9N7-Cho,5864
-never_primp/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-never_primp-1.0.1.dist-info/RECORD,,