python-tls-client 1.0.2__py3-none-any.whl

python_tls_client-1.0.2.dist-info/METADATA

@@ -0,0 +1,187 @@
+Metadata-Version: 2.4
+Name: python-tls-client
+Version: 1.0.2
+Summary: Advanced Python HTTP Client with TLS fingerprint spoofing (fork with binary-response fix and certificate pinning)
+Author: Emanuele Scarlata
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/Fenix46/Python-Tls-Client
+Project-URL: Source, https://github.com/Fenix46/Python-Tls-Client
+Project-URL: Original, https://github.com/FlorianREGAZ/Python-Tls-Client
+Classifier: Environment :: Web Environment
+Classifier: Intended Audience :: Developers
+Classifier: Natural Language :: English
+Classifier: Operating System :: Unix
+Classifier: Operating System :: MacOS :: MacOS X
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+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: Programming Language :: Python :: 3 :: Only
+Classifier: Topic :: Internet :: WWW/HTTP
+Classifier: Topic :: Software Development :: Libraries
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: typing-extensions
+Dynamic: license-file
+
+# Python-TLS-Client
+
+> **Nota:** questo è un fork di [Python-Tls-Client](https://github.com/FlorianREGAZ/Python-Tls-Client)
+> di Florian Zager, pubblicato su PyPI con nome diverso (`python-tls-client`) perché
+> il nome originale `tls-client` è già occupato dal progetto upstream.
+> Il modulo importabile resta invariato: `import tls_client`.
+>
+> Modifiche rispetto all'originale:
+> - Fix corruzione risposte binarie (protobuf, immagini, ...) — vedi Changelog 1.0.2
+> - Certificate pinning (vedi Changelog 1.0.1)
+
+Python-TLS-Client is an advanced HTTP library based on requests and tls-client.
+
+# Installation
+```
+pip install python-tls-client
+```
+
+# Examples
+The syntax is inspired by [requests](https://github.com/psf/requests), so its very similar and there are only very few things that are different.
+
+Example 1 - Preset:
+```python
+import tls_client
+
+# You can also use the following as `client_identifier`:
+# Chrome --> chrome_103, chrome_104, chrome_105, chrome_106, chrome_107, chrome_108, chrome109, Chrome110,
+#            chrome111, chrome112, chrome_116_PSK, chrome_116_PSK_PQ, chrome_117, chrome_120
+# Firefox --> firefox_102, firefox_104, firefox108, Firefox110, firefox_117, firefox_120
+# Opera --> opera_89, opera_90
+# Safari --> safari_15_3, safari_15_6_1, safari_16_0
+# iOS --> safari_ios_15_5, safari_ios_15_6, safari_ios_16_0
+# iPadOS --> safari_ios_15_6
+# Android --> okhttp4_android_7, okhttp4_android_8, okhttp4_android_9, okhttp4_android_10, okhttp4_android_11,
+#             okhttp4_android_12, okhttp4_android_13
+#
+# more client identifiers can be found in settings.py
+
+session = tls_client.Session(
+    client_identifier="chrome112",
+    random_tls_extension_order=True
+)
+
+res = session.get(
+    "https://www.example.com/",
+    headers={
+        "key1": "value1",
+    },
+    proxy="http://user:password@host:port"
+)
+```
+
+Example 2 - Custom:
+```python
+import tls_client
+
+session = tls_client.Session(
+    ja3_string="771,4865-4866-4867-49195-49199-49196-49200-52393-52392-49171-49172-156-157-47-53,0-23-65281-10-11-35-16-5-13-18-51-45-43-27-17513,29-23-24,0",
+    h2_settings={
+        "HEADER_TABLE_SIZE": 65536,
+        "MAX_CONCURRENT_STREAMS": 1000,
+        "INITIAL_WINDOW_SIZE": 6291456,
+        "MAX_HEADER_LIST_SIZE": 262144
+    },
+    h2_settings_order=[
+        "HEADER_TABLE_SIZE",
+        "MAX_CONCURRENT_STREAMS",
+        "INITIAL_WINDOW_SIZE",
+        "MAX_HEADER_LIST_SIZE"
+    ],
+    supported_signature_algorithms=[
+        "ECDSAWithP256AndSHA256",
+        "PSSWithSHA256",
+        "PKCS1WithSHA256",
+        "ECDSAWithP384AndSHA384",
+        "PSSWithSHA384",
+        "PKCS1WithSHA384",
+        "PSSWithSHA512",
+        "PKCS1WithSHA512",
+    ],
+    supported_versions=["GREASE", "1.3", "1.2"],
+    key_share_curves=["GREASE", "X25519"],
+    cert_compression_algo="brotli",
+    pseudo_header_order=[
+        ":method",
+        ":authority",
+        ":scheme",
+        ":path"
+    ],
+    connection_flow=15663105,
+    header_order=[
+        "accept",
+        "user-agent",
+        "accept-encoding",
+        "accept-language"
+    ]
+)
+
+res = session.post(
+    "https://www.example.com/",
+    headers={
+        "key1": "value1",
+    },
+    json={
+        "key1": "key2"
+    }
+)
+```
+
+# Pyinstaller / Pyarmor
+**If you want to pack the library with Pyinstaller or Pyarmor, make sure to add this to your command:**
+
+Linux - Ubuntu / x86:
+```
+--add-binary '{path_to_library}/tls_client/dependencies/tls-client-x86.so:tls_client/dependencies'
+```
+
+Linux Alpine / AMD64:
+```
+--add-binary '{path_to_library}/tls_client/dependencies/tls-client-amd64.so:tls_client/dependencies'
+```
+
+MacOS M1 and older:
+```
+--add-binary '{path_to_library}/tls_client/dependencies/tls-client-x86.dylib:tls_client/dependencies'
+```
+
+MacOS M2:
+```
+--add-binary '{path_to_library}/tls_client/dependencies/tls-client-arm64.dylib:tls_client/dependencies'
+```
+
+Windows:
+```
+--add-binary '{path_to_library}/tls_client/dependencies/tls-client-64.dll;tls_client/dependencies'
+```
+
+# Acknowledgements
+Big shout out to [Bogdanfinn](https://github.com/bogdanfinn) for open sourcing his [tls-client](https://github.com/bogdanfinn/tls-client) in Golang.
+Also I wanted to keep the syntax as similar as possible to [requests](https://github.com/psf/requests), as most people use it and are familiar with it!
+
+# Changelog
+
+## 1.0.2
+- **Fix**: binary response bodies (protobuf, images, ...) were corrupted by a
+  UTF-8 `byteReplacer` (U+FFFD) inside the Go C library. Every byte > 127 that
+  did not form a valid UTF-8 sequence was replaced by `EF BF BD`.
+  - `sessions.py`: now sends `isByteResponse: True` in the request payload so
+    the backend returns the body as a base64 data-URI.
+  - `response.py`: `build_response` decodes the data-URI back to raw bytes for
+    `Response.content`; `Response.text` is a UTF-8 view (with replacement
+    chars for invalid sequences).
+- Added `tests/test_binary_response.py` (regression suite, needs network).
+
+## 1.0.1
+- Certificate pinning

python_tls_client-1.0.2.dist-info/RECORD

@@ -0,0 +1,22 @@
+python_tls_client-1.0.2.dist-info/licenses/LICENSE,sha256=issbIg7ujiqhtvXsx5mmKhdeZ6zd39ew_nEzvvwImfw,1123
+tls_client/__init__.py,sha256=ORP-QdcnLxOEs42G3yPr6txUxryz7jUOA_AtHMafpf8,655
+tls_client/__version__.py,sha256=s_NN5vH9smBr16spQclEogL4BdMY_9QO__dMbufzvSk,445
+tls_client/cffi.py,sha256=RPuw_n-18YP__umggHbv4i4XcEa8ge-spGmt40Yf4sQ,995
+tls_client/cookies.py,sha256=5ujSFL6V8bDMCH8Mow6qoj5dP5GjfMJTd8_jWottvpM,15153
+tls_client/exceptions.py,sha256=edxP4P0NVOK-1r0zNRAMt4yh97LArXz8i6SU9oTSYQY,78
+tls_client/response.py,sha256=5Ji09s3fnrSst3N5n61fJ7motHNF3Jjsk6WBmsZ6iOk,3126
+tls_client/sessions.py,sha256=Uwx4YlhwmUkJonuqu6t0rtINiEpxbwPHbuJ4R2fc3Jw,18651
+tls_client/settings.py,sha256=sknNBPsNOujgIDO5Jo4L8RZFaY6gtGuWUvpJkJ0rBog,1289
+tls_client/structures.py,sha256=zb1wflxxWoKFqe8NMT2qEvIh7RA-kN459ZcNhW8p_Uo,2443
+tls_client/dependencies/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+tls_client/dependencies/tls-client-32.dll,sha256=RYiPCa-Df2FRn1E5A-hqFs-vgkKNq-HyI5BrBZjgj7Q,16512055
+tls_client/dependencies/tls-client-64.dll,sha256=sXd3hlZFX2uEghVCONMjo95NdPKot6Yr2XMlGiWe24c,18685673
+tls_client/dependencies/tls-client-amd64.so,sha256=atLDjHTHV_REcR4XfmtzjeffRnObntzoPzV2GudSJCg,12091312
+tls_client/dependencies/tls-client-arm64.dylib,sha256=9aKdKT0X97KOrXIyi2ilnGDpyi1iIBE8QFaWqxHf8to,10778130
+tls_client/dependencies/tls-client-arm64.so,sha256=MCwijkBgGDvxs9KPpSU53zou73NxzXjmUiZMZwUTpFE,11116584
+tls_client/dependencies/tls-client-x86.dylib,sha256=dEzNbwEuzbc_CWkBW3NyqhBOQY4IJJSMUT_2h5z8LBk,11687888
+tls_client/dependencies/tls-client-x86.so,sha256=xY-FoLKXMRxEJHyb9W1TKXVmuARnSeQw4T8w6cbuHLI,12045392
+python_tls_client-1.0.2.dist-info/METADATA,sha256=gaTJ6dwlCG1EEkWVq54IySqI766Uxn7SriTA94aS4_Y,6329
+python_tls_client-1.0.2.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+python_tls_client-1.0.2.dist-info/top_level.txt,sha256=yLrfQtbTRfECzPN62knWdGNmbhcPRev1grCAMuEsEz0,11
+python_tls_client-1.0.2.dist-info/RECORD,,

python_tls_client-1.0.2.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

python_tls_client-1.0.2.dist-info/licenses/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2022 Florian Zager
+Copyright (c) 2026 Emanuele Scarlata (modifications)
+
+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.

python_tls_client-1.0.2.dist-info/top_level.txt

@@ -0,0 +1 @@
+tls_client

tls_client/__init__.py

@@ -0,0 +1,15 @@
+#  _____  __  __         ___ _ _            _
+# /__   \/ / / _\       / __\ (_) ___ _ __ | |_
+#   / /\/ /  \ \ _____ / /  | | |/ _ \ '_ \| __|
+#  / / / /____\ \_____/ /___| | |  __/ | | | |_
+#  \/  \____/\__/     \____/|_|_|\___|_| |_|\__|
+
+# Disclaimer:
+# Big shout out to Bogdanfinn for open sourcing his tls-client in Golang.
+# Also to requests, as most of the cookie handling is copied from it. :'D
+# I wanted to keep the syntax as similar as possible to requests, as most people use it and are familiar with it!
+# Links:
+# tls-client: https://github.com/bogdanfinn/tls-client
+# requests: https://github.com/psf/requests
+
+from .sessions import Session

tls_client/__version__.py

@@ -0,0 +1,11 @@
+#  _____  __  __         ___ _ _            _
+# /__   \/ / / _\       / __\ (_) ___ _ __ | |_
+#   / /\/ /  \ \ _____ / /  | | |/ _ \ '_ \| __|
+#  / / / /____\ \_____/ /___| | |  __/ | | | |_
+#  \/  \____/\__/     \____/|_|_|\___|_| |_|\__|
+
+__title__ = "tls_client"
+__description__ = "Advanced Python HTTP Client (fork with binary-response fix and certificate pinning)."
+__version__ = "1.0.2"
+__author__ = "Emanuele Scarlata"
+__license__ = "MIT"

tls_client/cffi.py

@@ -0,0 +1,33 @@
+from sys import platform
+from platform import machine
+import ctypes
+import os
+
+
+if platform == 'darwin':
+    file_ext = '-arm64.dylib' if machine() == "arm64" else '-x86.dylib'
+elif platform in ('win32', 'cygwin'):
+    file_ext = '-64.dll' if 8 == ctypes.sizeof(ctypes.c_voidp) else '-32.dll'
+else:
+    if machine() == "aarch64":
+        file_ext = '-arm64.so'
+    elif "x86" in machine():
+        file_ext = '-x86.so'
+    else:
+        file_ext = '-amd64.so'
+
+root_dir = os.path.abspath(os.path.dirname(__file__))
+library = ctypes.cdll.LoadLibrary(f'{root_dir}/dependencies/tls-client{file_ext}')
+
+# extract the exposed request function from the shared package
+request = library.request
+request.argtypes = [ctypes.c_char_p]
+request.restype = ctypes.c_char_p
+
+freeMemory = library.freeMemory
+freeMemory.argtypes = [ctypes.c_char_p]
+freeMemory.restype = ctypes.c_char_p
+
+destroySession = library.destroySession
+destroySession.argtypes = [ctypes.c_char_p]
+destroySession.restype = ctypes.c_char_p