v0.2.0

.github/workflows/CI.yml

@@ -9,7 +9,7 @@ on:
   push:
     branches:
       - main
-      - master
+      - '*'
     tags:
       - '*'
   pull_request:

Cargo.toml

@@ -18,13 +18,17 @@ reqwest-impersonate = { version = "0.11", default-features = false, features = [
     "blocking",
     "boring-tls",
     "impersonate",
+    "json",
     "trust-dns",  # async resolver instead of a default threadpool using `getaddrinfo`
     "multipart",  # to send a multipart/form-data body
     "socks",
     "gzip",
     "brotli",
     "deflate",
 ] }
+encoding_rs = "0.8"
+pythonize = "0.21"
+serde_json = "1"
 
 [profile.release]
 codegen-units = 1

README.md

@@ -1,14 +1,25 @@
 ![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/pyreqwest_impersonate.svg)](https://pypi.org/project/pyreqwest_impersonate) [![Downloads](https://static.pepy.tech/badge/pyreqwest_impersonate/week)](https://pepy.tech/project/pyreqwest_impersonate) [![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)
 # Pyreqwest_impersonate
 
-HTTP client that can impersonate web browsers, mimicking their headers and `TLS/JA3/JA4/HTTP2` fingerprints.</br>
-Binding to the Rust `reqwest_impersonate` library.
+The fastest python HTTP client that can impersonate web browsers by mimicking their headers and `TLS/JA3/JA4/HTTP2` fingerprints.</br>
+Binding to the Rust `reqwest_impersonate` library.</br>
+🏁 Check the benchmarks for more details.
+
 
 Provides precompiled wheels:
 - [x] Linux:  `amd64`, `aarch64`.
 - [x] Windows: `amd64`.
 - [x] MacOS:  `amd64`, `aarch64`.
 
+## Table of Contents
+
+- [Installation](#installation)
+- [Usage](#usage)
+ - [I. Client](#i-client)
+ - [II. AsyncClient](#ii-asyncclient)
+ - [III. Response Object](#iii-response-object)
+
+
 ## Installation
 
 ```python
@@ -45,7 +56,7 @@ class Client:
     """
 ```
 
-### Client Methods
+#### 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
@@ -76,29 +87,59 @@ Performs a POST request to the specified URL.
 - timeout (Optional[float]): The timeout for the request in seconds. Default is 30.
 ```
 
-#### Examples:
+#### Example
 
-_Client.get()_
 ```python
 from pyreqwest_impersonate import Client
 
 client = Client(impersonate="chrome_123")
+
+# get request
 resp = client.get("https://tls.peet.ws/api/all")
-print(resp.text)
-print(resp.status_code)
-print(resp.url)
-print(resp.headers)
-print(resp.cookies)
-```
-_Client.post()_
-```python
-from pyreqwest_impersonate import Client
+print(resp.json())
 
+# post request
 data = {"key1": "value1", "key2": "value2"}
 auth = ("user", "password")
-resp = Client().post(url="https://httpbin.org/anything", data=data, auth=auth)
+resp = client.post(url="https://httpbin.org/anything", data=data, auth=auth)
 print(resp.text)
 ```
 ### II. AsyncClient
 
-TODO
+TODO
+
+### III. Response Object
+
+#### Key Features
+
+- `High Performance`: The attributes of the `Response` object are executed in Rust, which is known for its high performance. This ensures that operations like accessing headers, decoding text, or parsing JSON are very fast.
+- `Lazy Execution`: All attributes of the `Response` object are executed lazily. This means that the actual computation or data retrieval happens only when you access the attribute, not when the `Response` object is created. This approach optimizes performance by avoiding unnecessary computations.
+- `Automatic Character Encoding Detection`: The `Response` object intelligently detects the character encoding of the response body from the "Content-Type" header. If the encoding is not specified, it defaults to "UTF-8".
+
+#### Response attributes and methods
+
+- `cookies`: Fetches the cookies from the response as a dictionary.
+- `headers`: Retrieves the headers from the response as a dictionary.
+- `status_code`: Gets the status code of the response as an integer.
+- `url`: Returns the URL of the response as a string.
+- `content`: Provides the content of the response as bytes.
+- `text`: Decodes the response body into text, automatically detecting the character encoding.
+- `json()`: Parses the response body as JSON, converting it into a Python object for easy manipulation.
+
+#### Example
+
+```python
+from pyreqwest_impersonate import Client
+
+client = Client()
+
+response = client.get("https://example.com")
+
+print(response.status_code)  # Access the status code
+print(response.url)  # Access the URL
+print(response.headers)  # Access headers
+print(response.cookies)  # Access cookies
+print(response.content)  # Get the content as bytes
+print(response.text)  # Decode the content as text
+print(response.json())  # Parse the content as JSON
+```

benchmark/1_threads.csv

@@ -0,0 +1,6 @@
+name,threads,cpu_time 50k,cpu_time 5k,duration 50k,duration 5k
+curl_cffi,1,5.735,1.521,7.957,3.25
+httpx,1,3.801,2.116,6.117,3.987
+pyreqwest_impersonate,1,0.855,0.297,1.977,1.238
+requests,1,5.787,2.814,8.355,4.73
+tls_client,1,6.414,1.96,6.941,3.153

benchmark/4_threads.csv

@@ -0,0 +1,6 @@
+name,threads,cpu_time 50k,cpu_time 5k,duration 50k,duration 5k
+curl_cffi,4,4.014,1.255,1.567,0.866
+httpx,4,2.105,1.461,1.505,1.307
+pyreqwest_impersonate,4,1.15,0.399,0.875,0.751
+requests,4,4.14,3.006,3.356,2.802
+tls_client,4,3.803,1.357,1.382,0.832

benchmark/README.md

@@ -0,0 +1,17 @@
+## Benchmark
+
+Benchmark between `pyreqwests_impersonate` and other python http clients:
+
+- curl_cffi
+- httpx
+- pyreqwests_impersonate
+- python-tls-client
+- requests
+
+All the clients run with session/client enabled.
+Server response is gzipped.
+
+#### Run benchmark:
+
+- run server: `uvicorn server:app`
+- run benchmark: `python benchmark.py`

benchmark/benchmark.py

@@ -0,0 +1,77 @@
+import time
+from concurrent.futures import ThreadPoolExecutor, as_completed
+import pandas as pd
+import requests
+import httpx
+import tls_client
+import pyreqwest_impersonate
+import curl_cffi.requests
+
+results = []
+
+
+def session_get_test(session_class, requests_number):
+    s = session_class()
+    for _ in range(requests_number):
+        s.get(url).text
+
+# one thread
+requests_number = 2000
+for response_size in ["5k", "50k"]:
+    url = f"http://127.0.0.1:8000/{response_size}"
+    print(f"\nOne worker, {response_size=}, {requests_number=}")
+    for name, session_class in [
+        ("requests", requests.Session),
+        ("httpx", httpx.Client),
+        ("tls_client", tls_client.Session),
+        ("curl_cffi", curl_cffi.requests.Session),
+        ("pyreqwest_impersonate", pyreqwest_impersonate.Client),
+    ]:
+        start = time.perf_counter()
+        cpu_start = time.process_time()
+        session_get_test(session_class, requests_number)
+        dur = round(time.perf_counter() - start, 3)
+        cpu_dur = round(time.process_time() - cpu_start, 3)
+        results.append({"name": name, "threads": 1, "response_size": response_size, "duration": dur, "cpu_time": cpu_dur})
+        print(f"    name: {name:<22} {response_size=} {dur=} {cpu_dur=}")
+
+
+# multiple threads
+requests_number = 500
+threads_number = 4
+for response_size in ["5k", "50k"]:
+    url = f"http://127.0.0.1:8000/{response_size}"
+    print(f"\n{threads_number} workers, {response_size=}, {requests_number=}")
+    for name, session_class in [
+        ("requests", requests.Session),
+        ("httpx", httpx.Client),
+        ("tls_client", tls_client.Session),
+        ("curl_cffi", curl_cffi.requests.Session),
+        ("pyreqwest_impersonate", pyreqwest_impersonate.Client),
+    ]:
+        start = time.perf_counter()
+        cpu_start = time.process_time()
+        with ThreadPoolExecutor(threads_number) as executor:
+            futures = [executor.submit(session_get_test, session_class, requests_number) for _ in range(threads_number)]
+            for f in as_completed(futures):
+                f.result()
+        dur = round(time.perf_counter() - start, 3)
+        cpu_dur = round(time.process_time() - cpu_start, 3)
+        results.append({"name": name, "threads": threads_number, "response_size": response_size, "duration": dur, "cpu_time": cpu_dur})
+        print(f"    name: {name:<22} {response_size=} {dur=} {cpu_dur=}")
+
+
+df = pd.DataFrame(results)
+pivot_df = df.pivot_table(index=['name', 'threads'], columns='response_size', values=['duration', 'cpu_time'], aggfunc='mean')
+pivot_df.reset_index(inplace=True)
+pivot_df.columns = [' '.join(col).strip() for col in pivot_df.columns.values]
+pivot_df = pivot_df[['name', 'threads'] + [col for col in pivot_df.columns if col not in ['name', 'threads']]]
+unique_threads = pivot_df['threads'].unique()
+for thread in unique_threads:
+    thread_df = pivot_df[pivot_df['threads'] == thread]
+    print(f"\nTable for {thread} threads:")
+    print(thread_df.to_string(index=False))
+    thread_df.to_csv(f'{thread}_threads.csv', index=False)
+
+
+

benchmark/requirements.txt

@@ -0,0 +1,8 @@
+pandas
+starlette
+uvicorn
+requests
+httpx
+tls-client
+pyreqwest_impersonate
+curl_cffi

benchmark/server.py

@@ -0,0 +1,29 @@
+import base64
+import os
+import gzip
+from starlette.applications import Starlette
+from starlette.responses import Response
+from starlette.routing import Route
+
+random_5k = base64.b64encode(os.urandom(5 * 1024)).decode('utf-8')
+random_5k = gzip.compress(random_5k.encode('utf-8'))
+
+random_50k = base64.b64encode(os.urandom(50 * 1024)).decode('utf-8')
+random_50k = gzip.compress(random_50k.encode('utf-8'))
+
+
+def gzip_response(gzipped_content):
+    headers = {
+        'Content-Encoding': 'gzip',
+        'Content-Length': str(len(gzipped_content)),
+    }
+    return Response(gzipped_content, headers=headers)
+
+app = Starlette(
+    routes=[
+        Route("/5k", lambda r: gzip_response(random_5k)),
+        Route("/50k", lambda r: gzip_response(random_50k)),
+    ],
+)
+
+# Run server: uvicorn server:app

pyproject.toml

@@ -26,5 +26,19 @@ classifiers = [
     "Topic :: Software Development :: Libraries :: Python Modules",
 ]
 dynamic = ["version"]
+
+dependencies = []
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8.1.1",
+    "pytest-retry>=1.6.2",
+]
+
 [tool.maturin]
 features = ["pyo3/extension-module"]
+
+[tool.pytest.ini_options]
+retries = 3
+retry_delay = 0.5
+cumulative_timing = false