chrome-client 0.1.7__py3-none-win32.whl

chrome_client/__init__.py

@@ -0,0 +1,101 @@
+"""
+Chrome Client - Python Client for Cronet-Cloak
+
+使用方式:
+    import chrome_client
+
+    # 同步模式 - 模块级函数
+    response = chrome_client.get("https://example.com", verify=False)
+
+    # 同步模式 - Session
+    session = chrome_client.Client(verify=False)
+    response = session.get("https://example.com")
+
+    # 异步模式 - 模块级函数
+    import asyncio
+    response = await chrome_client.async_get("https://example.com", verify=False)
+
+    # 异步模式 - AsyncSession
+    async with chrome_client.AsyncClient(verify=False) as session:
+        response = await session.get("https://example.com")
+
+    # 使用代理
+    session = chrome_client.Client(
+        verify=False,
+        proxies={"https": "http://127.0.0.1:8080"}
+    )
+
+    # Response 对象
+    print(response.status_code)
+    print(response.text)
+    print(response.json())
+"""
+
+import sys
+import os
+
+# Load native libraries first (must be before importing Rust extension)
+from ._native_loader import load_native_libraries
+load_native_libraries()
+
+# Import Rust extension module
+try:
+    from . import cronet_cloak as _cronet_cloak
+except ImportError as e:
+    # If import fails, provide helpful error message
+    if sys.platform == "linux" and "libcronet" in str(e):
+        package_dir = os.path.dirname(__file__)
+        raise ImportError(
+            f"Failed to load libcronet.so: {e}\n\n"
+            f"Quick fix: Run this command before starting Python:\n"
+            f"  export LD_LIBRARY_PATH={package_dir}:$LD_LIBRARY_PATH\n\n"
+            f"See LINUX_INSTALL_GUIDE.md for more solutions."
+        ) from e
+    else:
+        raise
+
+# Import public API
+from ._types import HeadersType, CookiesType, DataType
+from ._typing import BrowserTypeLiteral
+from ._cookies import Cookie, CookieJar
+from ._response import (
+    Request, PreparedRequest, Response, StreamResponse, HTTPStatusError, RequestError,
+    Timeout, ConnectionError, ProxyError, SSLError,
+)
+from ._client import (
+    Client, AsyncClient, Session, AsyncSession,
+    set_tls_profiles, add_tls_profile, get_tls_profiles, clear_tls_profiles_cache,
+    _TLS_PROFILES_CACHE
+)
+from ._api_sync import (
+    request, session, get, post, put, delete, patch, head, options, trace, query,
+    upload_file, download_file
+)
+from ._api_async import (
+    async_request, async_get, async_post, async_put, async_delete, async_patch,
+    async_head, async_options, async_upload_file, async_download_file
+)
+from ._websocket import WebSocketApp
+from . import requests as requests
+
+RequestException = RequestError
+HTTPError = HTTPStatusError
+
+__all__ = [
+    "Client", "Session", "Request", "PreparedRequest", "Response", "StreamResponse", "HTTPStatusError", "RequestError",
+    "Cookie", "CookieJar",
+    "requests", "request", "session", "get", "post", "put", "delete", "patch", "head", "options", "trace", "query",
+    "upload_file", "download_file",
+    "AsyncClient", "AsyncSession",
+    "async_request", "async_get", "async_post", "async_put", "async_delete", "async_patch",
+    "async_head", "async_options", "async_upload_file", "async_download_file",
+    "set_tls_profiles", "add_tls_profile", "get_tls_profiles", "clear_tls_profiles_cache",
+    "WebSocketApp"
+]
+
+__all__ += ["BrowserTypeLiteral"]
+
+__all__ += [
+    "RequestException", "HTTPError", "Timeout", "ConnectionError",
+    "ProxyError", "SSLError",
+]

chrome_client/__init__.pyi

@@ -0,0 +1,352 @@
+from typing import Any, AsyncIterator, Dict, Iterable, Iterator, List, Mapping, Optional, Sequence, Tuple, Union
+from datetime import timedelta
+from ._typing import BrowserTypeLiteral as BrowserTypeLiteral
+
+HeadersType = Union[Mapping[str, Optional[str]], Sequence[Tuple[str, Optional[str]]]]
+CookiesType = Union[Mapping[str, str], "CookieJar"]
+DataType = Union[str, bytes, bytearray, Mapping[str, Any], Sequence[Tuple[str, Any]], None]
+
+class Cookie:
+    name: str
+    value: str
+    domain: str
+    path: str
+    seq: int
+    creation_seq: int
+    expires: Optional[float]
+    host_only: bool
+    secure: bool
+    def __init__(self, name: str, value: str, domain: str = ..., path: str = ..., seq: int = ..., expires: Optional[float] = ..., host_only: bool = ..., secure: bool = ..., creation_seq: Optional[int] = ...) -> None: ...
+    def is_expired(self, now: Optional[float] = ...) -> bool: ...
+    def matches(self, domain: str, path: str = ..., secure: bool = ...) -> bool: ...
+
+class CookieJar:
+    default_domain: str
+    def __init__(self, default_domain: Optional[str] = ...) -> None: ...
+    def set(self, name: str, value: str, domain: Optional[str] = ..., path: str = ..., expires: Optional[float] = ..., max_age: Optional[int] = ..., host_only: Optional[bool] = ..., secure: bool = ...) -> None: ...
+    def set_cookie(self, name: str, value: str, domain: Optional[str] = ..., path: str = ..., expires: Optional[float] = ..., max_age: Optional[int] = ..., host_only: Optional[bool] = ..., secure: bool = ...) -> None: ...
+    def update_from_set_cookie(self, values: Iterable[str], request_url: str) -> None: ...
+    def cookies_for_request(self, url: str) -> List[Cookie]: ...
+    def get(self, name: str, default: Optional[str] = ..., domain: Optional[str] = ..., path: Optional[str] = ...) -> Optional[str]: ...
+    def get_dict(self, domain: Optional[str] = ..., path: Optional[str] = ...) -> Dict[str, str]: ...
+    def update(self, cookies: CookiesType, domain: Optional[str] = ...) -> None: ...
+    def clear(self, domain: Optional[str] = ..., path: Optional[str] = ...) -> None: ...
+    def clear_expired_cookies(self) -> None: ...
+    def clear_session_cookies(self) -> None: ...
+    def set_default_domain(self, domain: Optional[str]) -> None: ...
+    def delete(self, name: Optional[str] = ..., domain: Optional[str] = ..., path: Optional[str] = ...) -> None: ...
+    def remove(self, name: str, domain: Optional[str] = ..., path: Optional[str] = ...) -> None: ...
+    def copy(self) -> "CookieJar": ...
+    def list_domains(self) -> List[str]: ...
+    def items_for_domain(self, domain: str, path: str = ...) -> Iterator[Tuple[str, str]]: ...
+    def iter_cookies(self) -> Iterator[Cookie]: ...
+    def items(self) -> Iterator[Tuple[str, str]]: ...
+    def keys(self) -> Iterator[str]: ...
+    def values(self) -> Iterator[str]: ...
+    def __setitem__(self, name: str, value: str) -> None: ...
+    def __getitem__(self, name: str) -> str: ...
+    def __contains__(self, name: str) -> bool: ...
+    def __bool__(self) -> bool: ...
+    def __iter__(self) -> Iterator[Cookie]: ...
+    def __len__(self) -> int: ...
+
+class Request:
+    method: Optional[str]
+    url: Optional[str]
+    headers: Dict[str, str]
+    files: Any
+    data: Any
+    params: Any
+    auth: Any
+    cookies: Any
+    hooks: Any
+    json: Any
+    def __init__(self, method: Optional[str] = ..., url: Optional[str] = ..., headers: Any = ..., files: Any = ..., data: Any = ..., params: Any = ..., auth: Any = ..., cookies: Any = ..., hooks: Any = ..., json: Any = ...) -> None: ...
+
+class PreparedRequest:
+    method: str
+    url: str
+    headers: Dict[str, str]
+    body: Any
+    def __init__(self, method: str, url: str, headers: Optional[Dict[str, str]] = ..., body: Any = ...) -> None: ...
+
+class RequestError(Exception): ...
+class Timeout(RequestError): ...
+class ConnectionError(RequestError): ...
+class ProxyError(ConnectionError): ...
+class SSLError(ConnectionError): ...
+class HTTPStatusError(RequestError):
+    response: Union["Response", "StreamResponse"]
+    request: Optional[PreparedRequest]
+
+RequestException = RequestError
+HTTPError = HTTPStatusError
+
+class Response:
+    status_code: int
+    content: bytes
+    url: str
+    encoding: Optional[str]
+    reason: str
+    history: List["Response"]
+    request: Optional[PreparedRequest]
+    elapsed: timedelta
+    raw: Any
+    def __init__(self, status_code: int, _headers: Dict[str, List[str]], content: bytes, url: str = ..., _cookies: Optional[CookieJar] = ..., encoding: Optional[str] = ..., reason: str = ..., history: Optional[List["Response"]] = ..., request: Optional[PreparedRequest] = ..., elapsed: Optional[timedelta] = ..., raw: Any = ...) -> None: ...
+    @property
+    def headers(self) -> Dict[str, str]: ...
+    @property
+    def cookies(self) -> CookieJar: ...
+    @property
+    def text(self) -> str: ...
+    @property
+    def ok(self) -> bool: ...
+    @property
+    def is_redirect(self) -> bool: ...
+    def json(self, **kwargs: Any) -> Any: ...
+    def raise_for_status(self) -> None: ...
+    def iter_content(self, chunk_size: Optional[int] = ..., decode_unicode: bool = ...) -> Iterable[Union[bytes, str]]: ...
+    def iter_lines(self, chunk_size: int = ..., decode_unicode: bool = ..., delimiter: Any = ...) -> Iterable[Union[bytes, str]]: ...
+    def close(self) -> None: ...
+    def __bool__(self) -> bool: ...
+
+class StreamResponse:
+    status_code: int
+    url: str
+    encoding: Optional[str]
+    reason: str
+    history: List[Response]
+    request: Optional[PreparedRequest]
+    elapsed: timedelta
+    raw: Any
+    def __init__(self, reader: Any, url: str = ..., cookies: Optional[CookieJar] = ..., encoding: Optional[str] = ..., session: Any = ...) -> None: ...
+    @property
+    def headers(self) -> Dict[str, str]: ...
+    @property
+    def cookies(self) -> CookieJar: ...
+    @property
+    def content(self) -> bytes: ...
+    @property
+    def text(self) -> str: ...
+    @property
+    def ok(self) -> bool: ...
+    @property
+    def is_redirect(self) -> bool: ...
+    def json(self, **kwargs: Any) -> Any: ...
+    def raise_for_status(self) -> None: ...
+    def iter_content(self, chunk_size: Optional[int] = ...) -> Iterable[bytes]: ...
+    def iter_lines(self, chunk_size: int = ..., decode_unicode: bool = ..., delimiter: Optional[str] = ...) -> Iterable[Union[bytes, str]]: ...
+    def aiter_content(self, chunk_size: Optional[int] = ...) -> AsyncIterator[bytes]: ...
+    def aiter_lines(self, chunk_size: int = ..., decode_unicode: bool = ..., delimiter: Optional[str] = ...) -> AsyncIterator[Union[bytes, str]]: ...
+    async def acontent(self) -> bytes: ...
+    async def atext(self) -> str: ...
+    def close(self) -> None: ...
+    async def aclose(self) -> None: ...
+    def __enter__(self) -> "StreamResponse": ...
+    def __exit__(self, *args: Any) -> None: ...
+    async def __aenter__(self) -> "StreamResponse": ...
+    async def __aexit__(self, *args: Any) -> None: ...
+    def __bool__(self) -> bool: ...
+
+class Client:
+    headers: Dict[str, str]
+    params: Dict[str, Any]
+    auth: Optional[Tuple[str, str]]
+    proxies: Union[str, Dict[str, str]]
+    verify: bool
+    stream: bool
+    cert: Any
+    max_redirects: int
+    timeout: Any
+    allow_redirects: bool
+    impersonate: Optional[BrowserTypeLiteral]
+    base_url: str
+    @property
+    def cookies(self) -> CookieJar: ...
+    @cookies.setter
+    def cookies(self, value: CookiesType) -> None: ...
+    def __init__(
+        self, verify: bool = ..., proxies: Optional[Union[str, Dict[str, str]]] = ...,
+        timeout: Any = ..., impersonate: Optional[BrowserTypeLiteral] = ...,
+        headers: Optional[Dict[str, str]] = ..., cookies: Optional[CookiesType] = ...,
+        auth: Optional[Tuple[str, str]] = ..., proxy: Optional[str] = ...,
+        base_url: Optional[str] = ..., params: Optional[Dict[str, Any]] = ...,
+        allow_redirects: bool = ..., max_redirects: int = ...,
+        default_headers: bool = ..., timeout_ms: Optional[int] = ...,
+        default_domain: Optional[str] = ...
+    ) -> None: ...
+    def request(
+        self, method: str, url: str, params: Any = ..., headers: Optional[HeadersType] = ...,
+        cookies: Optional[CookiesType] = ..., data: DataType = ..., content: Any = ...,
+        json: Any = ..., files: Any = ..., auth: Any = ..., timeout: Any = ...,
+        verify: Optional[bool] = ..., allow_redirects: Optional[bool] = ...,
+        proxies: Any = ..., proxy: Optional[str] = ..., hooks: Any = ...,
+        stream: Optional[bool] = ..., cert: Any = ..., impersonate: Optional[BrowserTypeLiteral] = ...,
+        max_redirects: Optional[int] = ..., **kwargs: Any
+    ) -> Union[Response, StreamResponse]: ...
+    def get(
+        self, url: str, params: Any = ..., *, headers: Optional[HeadersType] = ...,
+        cookies: Optional[CookiesType] = ..., data: DataType = ..., content: Any = ...,
+        json: Any = ..., auth: Any = ..., timeout: Any = ..., verify: Optional[bool] = ...,
+        allow_redirects: Optional[bool] = ..., proxies: Any = ..., proxy: Optional[str] = ...,
+        hooks: Any = ..., stream: Optional[bool] = ...,
+        impersonate: Optional[BrowserTypeLiteral] = ..., max_redirects: Optional[int] = ...
+    ) -> Union[Response, StreamResponse]: ...
+    def options(
+        self, url: str, *, params: Any = ..., headers: Optional[HeadersType] = ...,
+        cookies: Optional[CookiesType] = ..., data: DataType = ..., content: Any = ...,
+        json: Any = ..., auth: Any = ..., timeout: Any = ..., verify: Optional[bool] = ...,
+        allow_redirects: Optional[bool] = ..., proxies: Any = ..., proxy: Optional[str] = ...,
+        hooks: Any = ..., stream: Optional[bool] = ...,
+        impersonate: Optional[BrowserTypeLiteral] = ..., max_redirects: Optional[int] = ...
+    ) -> Union[Response, StreamResponse]: ...
+    def head(
+        self, url: str, *, params: Any = ..., headers: Optional[HeadersType] = ...,
+        cookies: Optional[CookiesType] = ..., auth: Any = ..., timeout: Any = ...,
+        verify: Optional[bool] = ..., allow_redirects: Optional[bool] = ...,
+        proxies: Any = ..., proxy: Optional[str] = ..., hooks: Any = ...,
+        stream: Optional[bool] = ..., impersonate: Optional[BrowserTypeLiteral] = ...,
+        max_redirects: Optional[int] = ...
+    ) -> Union[Response, StreamResponse]: ...
+    def post(
+        self, url: str, data: DataType = ..., json: Any = ..., *, params: Any = ...,
+        headers: Optional[HeadersType] = ..., cookies: Optional[CookiesType] = ...,
+        content: Any = ..., auth: Any = ..., timeout: Any = ..., verify: Optional[bool] = ...,
+        allow_redirects: Optional[bool] = ..., proxies: Any = ..., proxy: Optional[str] = ...,
+        hooks: Any = ..., stream: Optional[bool] = ...,
+        impersonate: Optional[BrowserTypeLiteral] = ..., max_redirects: Optional[int] = ...
+    ) -> Union[Response, StreamResponse]: ...
+    def put(
+        self, url: str, data: DataType = ..., *, params: Any = ...,
+        headers: Optional[HeadersType] = ..., cookies: Optional[CookiesType] = ...,
+        content: Any = ..., json: Any = ..., auth: Any = ..., timeout: Any = ...,
+        verify: Optional[bool] = ..., allow_redirects: Optional[bool] = ...,
+        proxies: Any = ..., proxy: Optional[str] = ..., hooks: Any = ...,
+        stream: Optional[bool] = ..., impersonate: Optional[BrowserTypeLiteral] = ...,
+        max_redirects: Optional[int] = ...
+    ) -> Union[Response, StreamResponse]: ...
+    def patch(
+        self, url: str, data: DataType = ..., *, params: Any = ...,
+        headers: Optional[HeadersType] = ..., cookies: Optional[CookiesType] = ...,
+        content: Any = ..., json: Any = ..., auth: Any = ..., timeout: Any = ...,
+        verify: Optional[bool] = ..., allow_redirects: Optional[bool] = ...,
+        proxies: Any = ..., proxy: Optional[str] = ..., hooks: Any = ...,
+        stream: Optional[bool] = ..., impersonate: Optional[BrowserTypeLiteral] = ...,
+        max_redirects: Optional[int] = ...
+    ) -> Union[Response, StreamResponse]: ...
+    def delete(
+        self, url: str, *, params: Any = ..., headers: Optional[HeadersType] = ...,
+        cookies: Optional[CookiesType] = ..., data: DataType = ..., content: Any = ...,
+        json: Any = ..., auth: Any = ..., timeout: Any = ..., verify: Optional[bool] = ...,
+        allow_redirects: Optional[bool] = ..., proxies: Any = ..., proxy: Optional[str] = ...,
+        hooks: Any = ..., stream: Optional[bool] = ...,
+        impersonate: Optional[BrowserTypeLiteral] = ..., max_redirects: Optional[int] = ...
+    ) -> Union[Response, StreamResponse]: ...
+    def trace(
+        self, url: str, *, params: Any = ..., headers: Optional[HeadersType] = ...,
+        cookies: Optional[CookiesType] = ..., data: DataType = ..., content: Any = ...,
+        json: Any = ..., auth: Any = ..., timeout: Any = ..., verify: Optional[bool] = ...,
+        allow_redirects: Optional[bool] = ..., proxies: Any = ..., proxy: Optional[str] = ...,
+        hooks: Any = ..., stream: Optional[bool] = ...,
+        impersonate: Optional[BrowserTypeLiteral] = ..., max_redirects: Optional[int] = ...
+    ) -> Union[Response, StreamResponse]: ...
+    def query(
+        self, url: str, *, params: Any = ..., headers: Optional[HeadersType] = ...,
+        cookies: Optional[CookiesType] = ..., data: DataType = ..., content: Any = ...,
+        json: Any = ..., auth: Any = ..., timeout: Any = ..., verify: Optional[bool] = ...,
+        allow_redirects: Optional[bool] = ..., proxies: Any = ..., proxy: Optional[str] = ...,
+        hooks: Any = ..., stream: Optional[bool] = ...,
+        impersonate: Optional[BrowserTypeLiteral] = ..., max_redirects: Optional[int] = ...
+    ) -> Union[Response, StreamResponse]: ...
+    def prepare_request(self, request: Request) -> PreparedRequest: ...
+    def send(self, request: PreparedRequest, **kwargs: Any) -> Union[Response, StreamResponse]: ...
+    def upload_file(self, url: str, file_path: str, **kwargs: Any) -> Response: ...
+    def download_file(self, url: str, save_path: str, **kwargs: Any) -> Dict[str, Any]: ...
+    def websocket(self, url: str, **kwargs: Any) -> "WebSocketApp": ...
+    def close(self) -> None: ...
+    def __enter__(self) -> "Client": ...
+    def __exit__(self, *args: Any) -> None: ...
+
+class Session(Client):
+    def __init__(self, verify: bool = ..., proxies: Any = ..., timeout: Any = ..., impersonate: Optional[BrowserTypeLiteral] = ..., headers: Any = ..., cookies: Any = ..., auth: Any = ..., proxy: Optional[str] = ..., base_url: Optional[str] = ..., params: Any = ..., allow_redirects: bool = ..., max_redirects: int = ..., default_headers: bool = ..., timeout_ms: Optional[int] = ..., default_domain: Optional[str] = ...) -> None: ...
+
+class AsyncClient:
+    headers: Dict[str, str]
+    params: Dict[str, Any]
+    auth: Optional[Tuple[str, str]]
+    proxies: Union[str, Dict[str, str]]
+    verify: bool
+    stream: bool
+    cert: Any
+    max_redirects: int
+    timeout: Any
+    allow_redirects: bool
+    impersonate: Optional[BrowserTypeLiteral]
+    base_url: str
+    @property
+    def cookies(self) -> CookieJar: ...
+    @cookies.setter
+    def cookies(self, value: CookiesType) -> None: ...
+    def __init__(self, verify: bool = ..., proxies: Any = ..., timeout: Any = ..., impersonate: Optional[BrowserTypeLiteral] = ..., headers: Any = ..., cookies: Any = ..., auth: Any = ..., proxy: Optional[str] = ..., base_url: Optional[str] = ..., params: Any = ..., allow_redirects: bool = ..., max_redirects: int = ..., default_headers: bool = ..., timeout_ms: Optional[int] = ..., default_domain: Optional[str] = ...) -> None: ...
+    async def request(self, method: str, url: str, **kwargs: Any) -> Union[Response, StreamResponse]: ...
+    async def get(self, url: str, params: Any = ..., **kwargs: Any) -> Union[Response, StreamResponse]: ...
+    async def options(self, url: str, **kwargs: Any) -> Union[Response, StreamResponse]: ...
+    async def head(self, url: str, **kwargs: Any) -> Union[Response, StreamResponse]: ...
+    async def post(self, url: str, data: DataType = ..., json: Any = ..., **kwargs: Any) -> Union[Response, StreamResponse]: ...
+    async def put(self, url: str, data: DataType = ..., **kwargs: Any) -> Union[Response, StreamResponse]: ...
+    async def patch(self, url: str, data: DataType = ..., **kwargs: Any) -> Union[Response, StreamResponse]: ...
+    async def delete(self, url: str, **kwargs: Any) -> Union[Response, StreamResponse]: ...
+    async def trace(self, url: str, **kwargs: Any) -> Union[Response, StreamResponse]: ...
+    async def query(self, url: str, **kwargs: Any) -> Union[Response, StreamResponse]: ...
+    def prepare_request(self, request: Request) -> PreparedRequest: ...
+    async def send(self, request: PreparedRequest, **kwargs: Any) -> Union[Response, StreamResponse]: ...
+    async def upload_file(self, url: str, file_path: str, **kwargs: Any) -> Response: ...
+    async def download_file(self, url: str, save_path: str, **kwargs: Any) -> Dict[str, Any]: ...
+    def websocket(self, url: str, **kwargs: Any) -> "WebSocketApp": ...
+    async def close(self) -> None: ...
+    async def __aenter__(self) -> "AsyncClient": ...
+    async def __aexit__(self, *args: Any) -> None: ...
+
+class AsyncSession(AsyncClient): ...
+
+class WebSocketApp:
+    def __init__(self, session: Union[Client, AsyncClient], url: str, on_open: Any = ..., on_message: Any = ..., on_close: Any = ..., on_error: Any = ..., sub_protocols: Optional[Union[str, Sequence[str]]] = ..., origin: Optional[str] = ..., headers: Optional[HeadersType] = ...) -> None: ...
+    @property
+    def connected(self) -> bool: ...
+    def send(self, message: str) -> None: ...
+    def send_bytes(self, data: bytes) -> None: ...
+    def close(self, code: int = ..., reason: str = ...) -> None: ...
+    def run_forever(self, blocking: bool = ...) -> Any: ...
+    def run_in_background(self) -> Any: ...
+
+def request(method: str, url: str, **kwargs: Any) -> Union[Response, StreamResponse]: ...
+def session(**kwargs: Any) -> Session: ...
+def get(url: str, params: Any = ..., **kwargs: Any) -> Union[Response, StreamResponse]: ...
+def options(url: str, **kwargs: Any) -> Union[Response, StreamResponse]: ...
+def head(url: str, **kwargs: Any) -> Union[Response, StreamResponse]: ...
+def post(url: str, data: DataType = ..., json: Any = ..., **kwargs: Any) -> Union[Response, StreamResponse]: ...
+def put(url: str, data: DataType = ..., **kwargs: Any) -> Union[Response, StreamResponse]: ...
+def patch(url: str, data: DataType = ..., **kwargs: Any) -> Union[Response, StreamResponse]: ...
+def delete(url: str, **kwargs: Any) -> Union[Response, StreamResponse]: ...
+def trace(url: str, **kwargs: Any) -> Union[Response, StreamResponse]: ...
+def query(url: str, **kwargs: Any) -> Union[Response, StreamResponse]: ...
+def upload_file(url: str, file_path: str, **kwargs: Any) -> Response: ...
+def download_file(url: str, save_path: str, **kwargs: Any) -> Dict[str, Any]: ...
+
+async def async_request(method: str, url: str, **kwargs: Any) -> Union[Response, StreamResponse]: ...
+async def async_get(url: str, params: Any = ..., **kwargs: Any) -> Union[Response, StreamResponse]: ...
+async def async_options(url: str, **kwargs: Any) -> Union[Response, StreamResponse]: ...
+async def async_head(url: str, **kwargs: Any) -> Union[Response, StreamResponse]: ...
+async def async_post(url: str, data: DataType = ..., json: Any = ..., **kwargs: Any) -> Union[Response, StreamResponse]: ...
+async def async_put(url: str, data: DataType = ..., **kwargs: Any) -> Union[Response, StreamResponse]: ...
+async def async_patch(url: str, data: DataType = ..., **kwargs: Any) -> Union[Response, StreamResponse]: ...
+async def async_delete(url: str, **kwargs: Any) -> Union[Response, StreamResponse]: ...
+async def async_upload_file(url: str, file_path: str, **kwargs: Any) -> Response: ...
+async def async_download_file(url: str, save_path: str, **kwargs: Any) -> Dict[str, Any]: ...
+
+def set_tls_profiles(profiles: Dict[str, Dict[str, Any]]) -> None: ...
+def add_tls_profile(name: str, profile: Dict[str, Any]) -> None: ...
+def get_tls_profiles() -> Dict[str, Dict[str, Any]]: ...
+def clear_tls_profiles_cache() -> None: ...
+
+from . import requests as requests

chrome_client/_api_async.py

@@ -0,0 +1,89 @@
+"""Asynchronous convenience API; AsyncSession remains the primary interface."""
+
+from typing import Optional, Dict, Any
+
+from ._response import Response, StreamResponse
+from ._client import AsyncSession
+
+_SESSION_KEYS = {
+    "verify", "proxies", "proxy", "timeout", "impersonate", "timeout_ms",
+    "base_url", "default_domain", "default_headers",
+}
+
+
+async def _async_send(method, url, **kwargs):
+    session_kwargs = {
+        key: kwargs.pop(key) for key in tuple(kwargs) if key in _SESSION_KEYS
+    }
+    session = AsyncSession(**session_kwargs)
+    try:
+        response = await session.request(method, url, **kwargs)
+        if isinstance(response, StreamResponse):
+            response._session = session
+        else:
+            await session.close()
+        return response
+    except Exception:
+        await session.close()
+        raise
+
+
+async def async_request(method, url, **kwargs):
+    return await _async_send(method, url, **kwargs)
+
+
+async def async_get(url, params=None, **kwargs):
+    return await async_request("GET", url, params=params, **kwargs)
+
+
+async def async_options(url, **kwargs):
+    return await async_request("OPTIONS", url, **kwargs)
+
+
+async def async_head(url, **kwargs):
+    kwargs.setdefault("allow_redirects", False)
+    return await async_request("HEAD", url, **kwargs)
+
+
+async def async_post(url, data=None, json=None, **kwargs):
+    return await async_request("POST", url, data=data, json=json, **kwargs)
+
+
+async def async_put(url, data=None, **kwargs):
+    return await async_request("PUT", url, data=data, **kwargs)
+
+
+async def async_patch(url, data=None, **kwargs):
+    return await async_request("PATCH", url, data=data, **kwargs)
+
+
+async def async_delete(url, **kwargs):
+    return await async_request("DELETE", url, **kwargs)
+
+
+async def async_upload_file(
+    url: str, file_path: str, *, field_name: str = "file",
+    additional_fields: Optional[Dict[str, str]] = None,
+    verify: bool = True, timeout: Optional[float] = None,
+    impersonate: Optional[str] = "chrome_150", **kwargs,
+) -> Response:
+    async with AsyncSession(
+        verify=verify, timeout=timeout, impersonate=impersonate
+    ) as session:
+        return await session.upload_file(
+            url, file_path, field_name=field_name,
+            additional_fields=additional_fields, **kwargs
+        )
+
+
+async def async_download_file(
+    url: str, save_path: str, *, verify: bool = True,
+    timeout: Optional[float] = None, chunk_size: int = 8192,
+    impersonate: Optional[str] = "chrome_150", **kwargs,
+) -> Dict[str, Any]:
+    async with AsyncSession(
+        verify=verify, timeout=timeout, impersonate=impersonate
+    ) as session:
+        return await session.download_file(
+            url, save_path, chunk_size=chunk_size, **kwargs
+        )

chrome_client/_api_sync.py

@@ -0,0 +1,113 @@
+"""Requests-first synchronous module API."""
+
+from typing import Optional, Dict, Any
+
+from ._types import HeadersType, CookiesType
+from ._response import Response, StreamResponse
+from ._client import Session
+
+_SESSION_KEYS = {
+    "verify", "proxies", "proxy", "timeout", "impersonate", "timeout_ms",
+    "base_url", "default_domain", "default_headers",
+}
+
+
+def _send(method, url, **kwargs):
+    """Create one temporary Session, preserving it only for streamed responses."""
+    session_kwargs = {
+        key: kwargs.pop(key) for key in tuple(kwargs) if key in _SESSION_KEYS
+    }
+    session = Session(**session_kwargs)
+    try:
+        response = session.request(method, url, **kwargs)
+        if isinstance(response, StreamResponse):
+            response._session = session
+        else:
+            session.close()
+        return response
+    except Exception:
+        session.close()
+        raise
+
+
+def request(method, url, **kwargs):
+    return _send(method, url, **kwargs)
+
+
+def session(**kwargs):
+    return Session(**kwargs)
+
+
+def get(url, params=None, **kwargs):
+    return request("GET", url, params=params, **kwargs)
+
+
+def options(url, **kwargs):
+    return request("OPTIONS", url, **kwargs)
+
+
+def head(url, **kwargs):
+    kwargs.setdefault("allow_redirects", False)
+    return request("HEAD", url, **kwargs)
+
+
+def post(url, data=None, json=None, **kwargs):
+    return request("POST", url, data=data, json=json, **kwargs)
+
+
+def put(url, data=None, **kwargs):
+    return request("PUT", url, data=data, **kwargs)
+
+
+def patch(url, data=None, **kwargs):
+    return request("PATCH", url, data=data, **kwargs)
+
+
+def delete(url, **kwargs):
+    return request("DELETE", url, **kwargs)
+
+
+def trace(url, **kwargs):
+    return request("TRACE", url, **kwargs)
+
+
+def query(url, **kwargs):
+    return request("QUERY", url, **kwargs)
+
+
+def upload_file(
+    url: str,
+    file_path: str,
+    *,
+    field_name: str = "file",
+    additional_fields: Optional[Dict[str, str]] = None,
+    headers: Optional[HeadersType] = None,
+    cookies: Optional[CookiesType] = None,
+    timeout: Optional[float] = None,
+    verify: bool = True,
+    impersonate: Optional[str] = "chrome_150",
+    **kwargs: Any
+) -> Response:
+    with Session(verify=verify, timeout=timeout, impersonate=impersonate, **kwargs) as session:
+        return session.upload_file(
+            url, file_path, field_name=field_name,
+            additional_fields=additional_fields, headers=headers, cookies=cookies,
+        )
+
+
+def download_file(
+    url: str,
+    save_path: str,
+    *,
+    headers: Optional[HeadersType] = None,
+    cookies: Optional[CookiesType] = None,
+    timeout: Optional[float] = None,
+    verify: bool = True,
+    chunk_size: int = 8192,
+    impersonate: Optional[str] = "chrome_150",
+    **kwargs: Any
+) -> Dict[str, Any]:
+    with Session(verify=verify, timeout=timeout, impersonate=impersonate, **kwargs) as session:
+        return session.download_file(
+            url, save_path, headers=headers, cookies=cookies, chunk_size=chunk_size,
+        )