specters 2.0.0__cp310-abi3-macosx_11_0_arm64.whl

specter/__init__.py

@@ -0,0 +1,75 @@
+"""
+Specter - Python bindings for the Specter HTTP client.
+
+A high-performance async HTTP client with full TLS, HTTP/2, and HTTP/3
+fingerprint control for browser impersonation.
+
+Basic usage:
+    >>> import asyncio
+    >>> import specter
+    >>>
+    >>> async def main():
+    ...     # Create a client with default settings
+    ...     client = specter.Client.builder().build()
+    ...     
+    ...     # Simple GET request
+    ...     response = await client.get("https://httpbin.org/get").send()
+    ...     print(f"Status: {response.status}")
+    ...     print(await response.text())
+    ...
+    >>> asyncio.run(main())
+
+With headers and body:
+    >>> async def main():
+    ...     client = specter.Client.builder().build()
+    ...     
+    ...     # POST with JSON body
+    ...     request = client.post("https://api.example.com/data")
+    ...     request.header("Authorization", "Bearer token")
+    ...     request.json('{"name": "test"}')
+    ...     response = await request.send()
+    ...     
+    ...     # Or chain the calls
+    ...     response = await (client.post("https://api.example.com/data")
+    ...         .header("Authorization", "Bearer token")
+    ...         .json('{"name": "test"}')
+    ...         .send())
+    ...
+    >>> asyncio.run(main())
+
+With fingerprinting:
+    >>> builder = specter.Client.builder()
+    >>> builder.fingerprint(specter.FingerprintProfile.Chrome142)
+    >>> client = builder.build()
+
+With custom timeouts:
+    >>> timeouts = (specter.Timeouts()
+    ...     .connect(5.0)
+    ...     .total(30.0))
+    >>> builder = specter.Client.builder()
+    >>> builder.timeouts(timeouts)
+    >>> client = builder.build()
+"""
+
+from .specter import (
+    Client,
+    ClientBuilder,
+    RequestBuilder,
+    Response,
+    CookieJar,
+    FingerprintProfile,
+    HttpVersion,
+    Timeouts,
+)
+
+__version__ = "1.2.0"
+__all__ = [
+    "Client",
+    "ClientBuilder",
+    "RequestBuilder",
+    "Response",
+    "CookieJar",
+    "FingerprintProfile",
+    "HttpVersion",
+    "Timeouts",
+]

specters-2.0.0.dist-info/METADATA

@@ -0,0 +1,97 @@
+Metadata-Version: 2.4
+Name: specters
+Version: 2.0.0
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Rust
+Classifier: Topic :: Internet :: WWW/HTTP
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Dist: pytest ; extra == 'dev'
+Requires-Dist: pytest-asyncio ; extra == 'dev'
+Requires-Dist: maturin ; extra == 'dev'
+Provides-Extra: dev
+Summary: Python bindings for Specter HTTP client with TLS/HTTP2/HTTP3 fingerprint control
+Keywords: http,http3,fingerprint,tls,client,async
+License: MIT
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
+
+# Specter
+
+Python bindings for the Specter HTTP client - an HTTP client that accurately replicates Chrome's TLS and HTTP/2 behavior.
+
+## Installation
+
+```bash
+pip install specters
+```
+
+## Features
+
+- HTTP/1.1, HTTP/2, and HTTP/3 support
+- Chrome 142 TLS fingerprint (BoringSSL)
+- Chrome HTTP/2 fingerprint (SETTINGS, pseudo-header order, GREASE)
+- Async/await interface
+- Cookie jar with Netscape format support
+
+## Usage
+
+```python
+import asyncio
+from specter import Client, FingerprintProfile
+
+async def main():
+    client = Client(fingerprint=FingerprintProfile.Chrome142)
+
+    response = await client.get("https://example.com")
+    print(f"Status: {response.status}")
+    print(f"Body: {response.text()}")
+
+asyncio.run(main())
+```
+
+### Force HTTP version
+
+```python
+from specter import HttpVersion
+
+# HTTP/2 only
+response = await client.get(url, version=HttpVersion.Http2)
+
+# HTTP/3 with fallback
+response = await client.get(url, version=HttpVersion.Http3)
+```
+
+### Custom headers and cookies
+
+```python
+from specter import CookieJar
+
+jar = CookieJar()
+await jar.load_from_file("cookies.txt")
+
+response = await client.get(url, cookies=jar)
+jar.store_from_headers(response.headers, url)
+
+await jar.save_to_file("cookies.txt")
+```
+
+## Validation
+
+Specter fingerprints are validated against:
+- ScrapFly (tools.scrapfly.io)
+- Browserleaks (tls.browserleaks.com)
+- tls.peet.ws
+- Cloudflare
+
+## License
+
+MIT
+

specters-2.0.0.dist-info/RECORD

@@ -0,0 +1,5 @@
+specter/__init__.py,sha256=qgNigyD_7RUq2xMHVhwIYmAVAn4yFx_q3w5So2UY5LM,2011
+specter/specter.abi3.so,sha256=JV3aDUBlmJCaXqcuMQUAXx_4RtU2gFG7W4fyJJrbdlA,4834272
+specters-2.0.0.dist-info/METADATA,sha256=dsa6AJHJJM1bns9m_Ryl1Cg3hiIVanYKVZgMsbhgHrw,2444
+specters-2.0.0.dist-info/WHEEL,sha256=vZ12AMAE5CVtd8oYbYGrz3omfHuIZCNO_3P50V00s00,104
+specters-2.0.0.dist-info/RECORD,,

specters-2.0.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: maturin (1.11.5)
+Root-Is-Purelib: false
+Tag: cp310-abi3-macosx_11_0_arm64