tlsreq 0.1.0__tar.gz

tlsreq-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 xiaoweigege
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

tlsreq-0.1.0/PKG-INFO

@@ -0,0 +1,82 @@
+Metadata-Version: 2.4
+Name: tlsreq
+Version: 0.1.0
+Summary: Unified async/sync HTTP client over curl_cffi, wreq, niquests+utls, and httpx+utls
+Author: xiaoweigege
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/xiaoweigege/tlsreq
+Project-URL: Repository, https://github.com/xiaoweigege/tlsreq
+Project-URL: Issues, https://github.com/xiaoweigege/tlsreq/issues
+Project-URL: utls (Chrome 152), https://github.com/xiaoweigege/utls/releases/tag/2026.9.4
+Keywords: tls,http2,fingerprint,ja4,utls,curl_cffi,wreq
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Typing :: Typed
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: curl-cffi
+Requires-Dist: curl_cffi>=0.13; extra == "curl-cffi"
+Provides-Extra: wreq
+Requires-Dist: wreq>=0.12; extra == "wreq"
+Provides-Extra: niquests
+Requires-Dist: niquests>=3.0; extra == "niquests"
+Provides-Extra: httpx
+Requires-Dist: httpx>=0.27; extra == "httpx"
+Requires-Dist: httpcore>=1.0; extra == "httpx"
+Requires-Dist: h2>=4.1; extra == "httpx"
+Provides-Extra: all
+Requires-Dist: tlsreq[curl_cffi]; extra == "all"
+Requires-Dist: tlsreq[wreq]; extra == "all"
+Requires-Dist: tlsreq[niquests]; extra == "all"
+Requires-Dist: tlsreq[httpx]; extra == "all"
+Dynamic: license-file
+
+# tlsreq
+
+把 `curl_cffi`、`wreq`、`niquests+utls`、`httpx+utls` 收成同一套 Session API。换库只改 `backend` 和 `impersonate`。
+
+GitHub: https://github.com/xiaoweigege/tlsreq
+
+## 安装
+
+```bash
+pip install tlsreq
+pip install "tlsreq[httpx]"      # 或 niquests / wreq / curl_cffi / all
+```
+
+Chrome 152 不在 PyPI 的 `utls` 里。httpx / niquests 需要再装 GitHub 2026.9.4：
+
+https://github.com/xiaoweigege/utls/releases/tag/2026.9.4
+
+```bash
+python -m tlsreq.install_utls
+# 或 tlsreq-install-utls
+```
+
+## 用法
+
+```python
+from tlsreq import AsyncSession, Session
+
+async with AsyncSession(
+    backend="niquests",           # curl_cffi / wreq / niquests / httpx
+    impersonate="chrome152",
+    proxy="http://user:pass@host:port",
+    timeout=30,
+    extra={"pool_maxsize": 1},    # 只传给当前库
+) as s:
+    r = await s.get(url, headers=headers)
+    print(r.status_code, r.text, r.cookies, r.http_version)
+    r = await s.post(url, data=body, headers=headers, header_order=["user-agent", "accept"])
+
+s = Session(backend="wreq", impersonate="chrome149", proxy=proxy)
+r = s.get(url, headers=headers)
+```
+
+`extra=` 会合并进底层构造函数或单次请求，后写覆盖统一层映射。底层 client 在 `s.raw`。
+
+niquests / httpx 默认带 Chrome 152 的 HTTP/2 SETTINGS、窗口和 HEADERS Priority，JA4 / peetprint / akamai_fingerprint 对齐真机。

tlsreq-0.1.0/README.md

@@ -0,0 +1,45 @@
+# tlsreq
+
+把 `curl_cffi`、`wreq`、`niquests+utls`、`httpx+utls` 收成同一套 Session API。换库只改 `backend` 和 `impersonate`。
+
+GitHub: https://github.com/xiaoweigege/tlsreq
+
+## 安装
+
+```bash
+pip install tlsreq
+pip install "tlsreq[httpx]"      # 或 niquests / wreq / curl_cffi / all
+```
+
+Chrome 152 不在 PyPI 的 `utls` 里。httpx / niquests 需要再装 GitHub 2026.9.4：
+
+https://github.com/xiaoweigege/utls/releases/tag/2026.9.4
+
+```bash
+python -m tlsreq.install_utls
+# 或 tlsreq-install-utls
+```
+
+## 用法
+
+```python
+from tlsreq import AsyncSession, Session
+
+async with AsyncSession(
+    backend="niquests",           # curl_cffi / wreq / niquests / httpx
+    impersonate="chrome152",
+    proxy="http://user:pass@host:port",
+    timeout=30,
+    extra={"pool_maxsize": 1},    # 只传给当前库
+) as s:
+    r = await s.get(url, headers=headers)
+    print(r.status_code, r.text, r.cookies, r.http_version)
+    r = await s.post(url, data=body, headers=headers, header_order=["user-agent", "accept"])
+
+s = Session(backend="wreq", impersonate="chrome149", proxy=proxy)
+r = s.get(url, headers=headers)
+```
+
+`extra=` 会合并进底层构造函数或单次请求，后写覆盖统一层映射。底层 client 在 `s.raw`。
+
+niquests / httpx 默认带 Chrome 152 的 HTTP/2 SETTINGS、窗口和 HEADERS Priority，JA4 / peetprint / akamai_fingerprint 对齐真机。

tlsreq-0.1.0/pyproject.toml

@@ -0,0 +1,54 @@
+[build-system]
+requires = ["setuptools>=68.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "tlsreq"
+version = "0.1.0"
+description = "Unified async/sync HTTP client over curl_cffi, wreq, niquests+utls, and httpx+utls"
+readme = "README.md"
+requires-python = ">=3.9"
+license = "MIT"
+authors = [{name = "xiaoweigege"}]
+keywords = ["tls", "http2", "fingerprint", "ja4", "utls", "curl_cffi", "wreq"]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Typing :: Typed",
+]
+
+[project.optional-dependencies]
+# Chrome 152 不在 PyPI utls。装完 extras 后执行: python -m tlsreq.install_utls
+curl_cffi = ["curl_cffi>=0.13"]
+wreq = ["wreq>=0.12"]
+niquests = ["niquests>=3.0"]
+httpx = ["httpx>=0.27", "httpcore>=1.0", "h2>=4.1"]
+all = [
+    "tlsreq[curl_cffi]",
+    "tlsreq[wreq]",
+    "tlsreq[niquests]",
+    "tlsreq[httpx]",
+]
+
+[project.scripts]
+tlsreq-install-utls = "tlsreq.install_utls:main"
+
+[project.urls]
+Homepage = "https://github.com/xiaoweigege/tlsreq"
+Repository = "https://github.com/xiaoweigege/tlsreq"
+Issues = "https://github.com/xiaoweigege/tlsreq/issues"
+"utls (Chrome 152)" = "https://github.com/xiaoweigege/utls/releases/tag/2026.9.4"
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+license-files = ["LICENSE"]
+
+[tool.setuptools.packages.find]
+where = ["src"]
+include = ["tlsreq*"]
+
+[tool.setuptools.package-data]
+tlsreq = ["py.typed"]

tlsreq-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

tlsreq-0.1.0/src/tlsreq/__init__.py

@@ -0,0 +1,18 @@
+from .errors import BackendNotInstalled, TlsReqError, UnknownBackend, UnknownFingerprint
+from .response import Response
+from .session import AsyncSession, Session
+from .utls_release import UTLS_RELEASE, UTLS_RELEASE_PAGE
+
+__version__ = "0.1.0"
+__all__ = [
+    "AsyncSession",
+    "Session",
+    "Response",
+    "TlsReqError",
+    "UnknownBackend",
+    "BackendNotInstalled",
+    "UnknownFingerprint",
+    "UTLS_RELEASE",
+    "UTLS_RELEASE_PAGE",
+    "__version__",
+]

tlsreq-0.1.0/src/tlsreq/backends/__init__.py

@@ -0,0 +1,61 @@
+from __future__ import annotations
+
+from typing import Any, Optional
+
+from ..errors import UnknownBackend
+from .base import AsyncBackend, SyncBackend
+
+_ALIASES = {
+    "curl": "curl_cffi",
+    "cffi": "curl_cffi",
+    "nirequest": "niquests",
+    "nirequests": "niquests",
+    "nio": "niquests",
+}
+
+
+def _normalize_backend(name: str) -> str:
+    key = name.strip().lower().replace("-", "_")
+    return _ALIASES.get(key, key)
+
+
+def create_sync_backend(
+    backend: str,
+    impersonate: Optional[str] = None,
+    **kwargs: Any,
+) -> SyncBackend:
+    name = _normalize_backend(backend)
+    if name == "curl_cffi":
+        from .curl_cffi import CurlCffiSync
+        return CurlCffiSync(impersonate=impersonate, **kwargs)
+    if name == "wreq":
+        from .wreq import WreqSync
+        return WreqSync(impersonate=impersonate, **kwargs)
+    if name == "niquests":
+        from .niquests import NiquestsSync
+        return NiquestsSync(impersonate=impersonate, **kwargs)
+    if name == "httpx":
+        from .httpx import HttpxSync
+        return HttpxSync(impersonate=impersonate, **kwargs)
+    raise UnknownBackend(f"未知 backend {backend!r}。可选: curl_cffi, wreq, niquests, httpx")
+
+
+def create_async_backend(
+    backend: str,
+    impersonate: Optional[str] = None,
+    **kwargs: Any,
+) -> AsyncBackend:
+    name = _normalize_backend(backend)
+    if name == "curl_cffi":
+        from .curl_cffi import CurlCffiAsync
+        return CurlCffiAsync(impersonate=impersonate, **kwargs)
+    if name == "wreq":
+        from .wreq import WreqAsync
+        return WreqAsync(impersonate=impersonate, **kwargs)
+    if name == "niquests":
+        from .niquests import NiquestsAsync
+        return NiquestsAsync(impersonate=impersonate, **kwargs)
+    if name == "httpx":
+        from .httpx import HttpxAsync
+        return HttpxAsync(impersonate=impersonate, **kwargs)
+    raise UnknownBackend(f"未知 backend {backend!r}。可选: curl_cffi, wreq, niquests, httpx")

tlsreq-0.1.0/src/tlsreq/backends/_httpx_patch.py

@@ -0,0 +1,122 @@
+"""httpcore/h2：Chrome 152 SETTINGS、连接窗口、HEADERS Priority。"""
+from __future__ import annotations
+
+import collections
+from typing import Any
+
+import h2.settings
+
+from ..chrome_h2 import (
+    CONNECTION_WINDOW_INCREMENT,
+    ENABLE_PUSH,
+    H2_HOP_BY_HOP,
+    HEADER_TABLE_SIZE,
+    INITIAL_WINDOW_SIZE,
+    MAX_HEADER_LIST_SIZE,
+    PRIORITY_DEPENDS_ON,
+    PRIORITY_EXCLUSIVE,
+    PRIORITY_WEIGHT,
+)
+
+_PATCHED = False
+
+
+def _chrome_local_settings() -> h2.settings.Settings:
+    settings = h2.settings.Settings(
+        client=True,
+        initial_values={
+            h2.settings.SettingCodes.HEADER_TABLE_SIZE: HEADER_TABLE_SIZE,
+            h2.settings.SettingCodes.ENABLE_PUSH: ENABLE_PUSH,
+            h2.settings.SettingCodes.INITIAL_WINDOW_SIZE: INITIAL_WINDOW_SIZE,
+            h2.settings.SettingCodes.MAX_HEADER_LIST_SIZE: MAX_HEADER_LIST_SIZE,
+            h2.settings.SettingCodes.MAX_CONCURRENT_STREAMS: 100,
+        },
+    )
+    del settings[h2.settings.SettingCodes.MAX_FRAME_SIZE]
+    del settings[h2.settings.SettingCodes.ENABLE_CONNECT_PROTOCOL]
+    del settings[h2.settings.SettingCodes.MAX_CONCURRENT_STREAMS]
+    return settings
+
+
+def _restore_local_only(settings: h2.settings.Settings) -> None:
+    """SETTINGS 帧发出后再补回 h2/httpcore 内部会读的项，避免再发一帧。"""
+    codes = h2.settings.SettingCodes
+    settings._settings.setdefault(codes.MAX_CONCURRENT_STREAMS, collections.deque([100]))
+    settings._settings.setdefault(codes.MAX_FRAME_SIZE, collections.deque([16384]))
+
+
+def patch_httpcore_chrome_h2() -> None:
+    global _PATCHED
+    if _PATCHED:
+        return
+
+    from httpcore._async.http2 import AsyncHTTP2Connection
+    from httpcore._async.http2 import has_body_headers as async_has_body_headers
+    from httpcore._sync.http2 import HTTP2Connection
+    from httpcore._sync.http2 import has_body_headers as sync_has_body_headers
+
+    async def async_send_connection_init(self: Any, request: Any) -> None:
+        self._h2_state.local_settings = _chrome_local_settings()
+        self._h2_state.initiate_connection()
+        _restore_local_only(self._h2_state.local_settings)
+        self._h2_state.increment_flow_control_window(CONNECTION_WINDOW_INCREMENT)
+        await self._write_outgoing_data(request)
+
+    def sync_send_connection_init(self: Any, request: Any) -> None:
+        self._h2_state.local_settings = _chrome_local_settings()
+        self._h2_state.initiate_connection()
+        _restore_local_only(self._h2_state.local_settings)
+        self._h2_state.increment_flow_control_window(CONNECTION_WINDOW_INCREMENT)
+        self._write_outgoing_data(request)
+
+    async def async_send_request_headers(self: Any, request: Any, stream_id: int) -> None:
+        end_stream = not async_has_body_headers(request)
+        authority = [value for key, value in request.headers if key.lower() == b"host"][0]
+        headers = [
+            (b":method", request.method),
+            (b":authority", authority),
+            (b":scheme", request.url.scheme),
+            (b":path", request.url.target),
+        ] + [
+            (key.lower(), value)
+            for key, value in request.headers
+            if key.lower() not in H2_HOP_BY_HOP
+        ]
+        self._h2_state.send_headers(
+            stream_id,
+            headers,
+            end_stream=end_stream,
+            priority_weight=PRIORITY_WEIGHT,
+            priority_depends_on=PRIORITY_DEPENDS_ON,
+            priority_exclusive=PRIORITY_EXCLUSIVE,
+        )
+        await self._write_outgoing_data(request)
+
+    def sync_send_request_headers(self: Any, request: Any, stream_id: int) -> None:
+        end_stream = not sync_has_body_headers(request)
+        authority = [value for key, value in request.headers if key.lower() == b"host"][0]
+        headers = [
+            (b":method", request.method),
+            (b":authority", authority),
+            (b":scheme", request.url.scheme),
+            (b":path", request.url.target),
+        ] + [
+            (key.lower(), value)
+            for key, value in request.headers
+            if key.lower() not in H2_HOP_BY_HOP
+        ]
+        self._h2_state.send_headers(
+            stream_id,
+            headers,
+            end_stream=end_stream,
+            priority_weight=PRIORITY_WEIGHT,
+            priority_depends_on=PRIORITY_DEPENDS_ON,
+            priority_exclusive=PRIORITY_EXCLUSIVE,
+        )
+        self._write_outgoing_data(request)
+
+    AsyncHTTP2Connection._send_connection_init = async_send_connection_init
+    AsyncHTTP2Connection._send_request_headers = async_send_request_headers
+    HTTP2Connection._send_connection_init = sync_send_connection_init
+    HTTP2Connection._send_request_headers = sync_send_request_headers
+    _PATCHED = True