bas-http 1.0.0__tar.gz

bas_http-1.0.0/PKG-INFO

@@ -0,0 +1,25 @@
+Metadata-Version: 2.4
+Name: bas-http
+Version: 1.0.0
+Summary: Copy-paste your browser's request, bas handles the rest. No impersonation needed.
+Author: bas
+License: MIT
+Project-URL: Homepage, https://github.com/yourusername/bas
+Project-URL: Repository, https://github.com/yourusername/bas
+Project-URL: Issues, https://github.com/yourusername/bas/issues
+Keywords: http,curl,cookie,scraping,browser,devtools
+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.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.13
+Classifier: Topic :: Internet :: WWW/HTTP
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown

bas_http-1.0.0/bas/README.md

@@ -0,0 +1,244 @@
+# bas
+
+Copy-paste your browser's request, bas handles the rest.
+
+No impersonation. No fingerprint chasing. No broken cookies.
+
+## Why bas?
+
+| Issue | curlcffi | bas |
+|-------|----------|----------|
+| Cookies lost during redirects | **BUG** | **Fixed** |
+| Cookies not accumulating across requests | **BUG** | **Fixed** |
+| Manual Cookie header construction needed | Yes | **Auto-injected** |
+| Requires curl-impersonate | Yes | **No — pure Python** |
+| Browser fingerprint updates needed | Yes | **None — you bring your own headers** |
+
+## Installation
+
+```bash
+pip install bas
+```
+
+Zero external dependencies. Works with Python's built-in `urllib`.
+
+## Usage
+
+### Method 1: Paste a curl command from DevTools
+
+```
+1. Open browser DevTools → Network tab
+2. Right-click any request → "Copy as cURL"
+3. Paste into bas
+```
+
+```python
+import bas
+
+# Paste your curl command (use raw string r'' to preserve backslashes)
+s = bas.from_curl(r'''curl "https://spaceshooter.net/faucet/ltc" ^
+  -H "accept: text/html" ^
+  -H "user-agent: Mozilla/5.0 ..." ^
+  -b "cf_clearance=abc123; session=xyz"''')
+
+# Now make requests — cookies and headers auto-injected
+r = s.get("https://spaceshooter.net/faucet/ltc")
+print(r.status_code, r.text)
+
+# Add more cookies manually if needed
+s.set_cookie("new_cookie", "value", domain="spaceshooter.net")
+r = s.get("https://spaceshooter.net/dashboard")
+```
+
+### Method 2: Build headers manually
+
+```python
+import bas
+
+s = bas.Session()
+
+# Paste your headers from DevTools
+s.headers = {
+    "accept": "text/html,application/xhtml+xml,...",
+    "accept-language": "en-US,en;q=0.9",
+    "user-agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) ...",
+    "sec-ch-ua": '"Chromium";v="137", "Not/A)Brand";v="24"',
+    "sec-ch-ua-mobile": "?0",
+    "sec-ch-ua-platform": '"Windows"',
+    "sec-fetch-dest": "document",
+    "sec-fetch-mode": "navigate",
+}
+
+# Add your cookies
+s.set_cookie("cf_clearance", "abc123", domain="spaceshooter.net")
+s.set_cookie("session", "xyz", domain="spaceshooter.net")
+
+# Go!
+r = s.get("https://spaceshooter.net/faucet/ltc")
+```
+
+### Method 3: Build from headers + cookies dict
+
+```python
+import bas
+
+s = bas.from_headers(
+    url="https://spaceshooter.net/faucet/ltc",
+    headers={
+        "user-agent": "Mozilla/5.0 ...",
+        "accept": "text/html,...",
+    },
+    cookies={
+        "cf_clearance": "abc123",
+        "session": "xyz",
+    },
+)
+
+r = s.get("https://spaceshooter.net/faucet/ltc")
+```
+
+### Parse a curl command without making a request
+
+```python
+from bas.curl_parser import parse_curl, print_curl_summary
+
+# See what's in a curl command
+print_curl_summary(r'''curl "https://example.com" -H "User-Agent: ..." -b "cookie=value"''')
+
+# Or get it as a dict
+parsed = parse_curl(r'''curl "https://example.com" -H "User-Agent: ..." -b "cookie=value"''')
+print(parsed["method"])     # "GET"
+print(parsed["url"])        # "https://example.com"
+print(parsed["headers"])    # {"User-Agent": "..."}
+print(parsed["cookies"])    # {"cookie": "value"}
+```
+
+### Cookie Management
+
+```python
+import bas
+
+with bas.Session() as s:
+    # Pre-load cookies
+    s.set_cookie("session", "abc123", domain="example.com")
+
+    # Cookies are auto-injected into every request
+    r = s.get("https://example.com")
+    print("Cookie header:", r.request.headers.get("Cookie"))
+
+    # Save cookies to file
+    s.save_cookies("cookies.json")
+
+    # Load cookies from file
+    s.load_cookies("cookies.json")
+
+    # Check what cookies we have for a URL
+    print(s.get_cookies("https://example.com"))
+```
+
+### Cookie Jar (direct access)
+
+```python
+from bas.cookies import Cookie, CookieJar
+
+jar = CookieJar()
+
+# Parse Set-Cookie headers from responses
+jar.parse_set_cookie(
+    "session=abc123; Domain=.example.com; Path=/; Secure; HttpOnly",
+    "https://www.example.com/"
+)
+
+# Get cookies for a URL (RFC 6265 compliant)
+cookies = jar.match("https://www.example.com/page")
+
+# Build Cookie header automatically
+header = jar.to_header("https://www.example.com/")
+print(header)  # "session=abc123"
+
+# Save/load
+jar.save_json("cookies.json")
+jar.load_json("cookies.json")
+```
+
+## How bas Fixes curlcffi's Cookie Bugs
+
+### Fix #1: Cookies Accumulate
+
+```python
+# curlcffi (BROKEN):
+r1 = s.get(url)
+r2 = s.get(url)  # LOST cookies from r1!
+
+# bas (FIXED):
+r1 = s.get(url)
+r2 = s.get(url)  # Has ALL cookies from r1 + new ones
+```
+
+### Fix #2: Redirect Cookie Inheritance
+
+```python
+# curlcffi (BROKEN):
+r = s.get("https://example.com/page")  # 302 redirect
+# Cookies LOST during redirect!
+
+# bas (FIXED):
+r = s.get("https://example.com/page")  # 302 redirect
+# Cookies properly inherited + new Set-Cookie headers captured
+```
+
+### Fix #3: Auto Cookie Injection
+
+```python
+# curlcffi (manual):
+r = s.get(url, headers={"Cookie": "session=abc123; token=xyz"})
+
+# bas (automatic):
+s.set_cookie("session", "abc123")
+s.set_cookie("token", "xyz")
+r = s.get(url)  # Cookie header auto-generated!
+```
+
+## API Reference
+
+### `from_curl(curl_cmd, **kwargs)` → Session
+
+Create a Session from a curl command. The main entry point.
+
+### `from_headers(url, headers, cookies, **kwargs)` → Session
+
+Create a Session from raw headers and cookies.
+
+### `Session(headers=None, cookies=None, ...)`
+
+Simple HTTP session. Pure Python, no curl needed.
+
+**Parameters:**
+- `headers` (dict): Default headers
+- `cookies` (dict): Pre-set cookies
+- `verify` (bool): SSL verification (default: True)
+- `timeout` (float): Request timeout (default: 30)
+- `allow_redirects` (bool): Follow redirects (default: True)
+- `max_redirects` (int): Max redirects (default: 20)
+
+**Methods:**
+- `get(url, **kwargs)` → Response
+- `post(url, **kwargs)` → Response
+- `put(url, **kwargs)` → Response
+- `delete(url, **kwargs)` → Response
+- `set_cookie(name, value, domain, path)` → None
+- `get_cookies(url)` → dict
+- `save_cookies(filepath, format)` → None
+- `load_cookies(filepath, format)` → None
+
+### `Cookie(name, value, domain, path, ...)`
+
+Individual cookie with RFC 6265 compliance.
+
+### `CookieJar`
+
+Thread-safe cookie container. Full RFC 6265 domain/path matching.
+
+## License
+
+MIT

bas_http-1.0.0/bas/__init__.py

@@ -0,0 +1,97 @@
+"""
+bas — Copy-paste your browser's request, bas handles the rest.
+
+No impersonation needed. No fingerprint chasing. Just grab your
+headers + cookies from DevTools and go.
+
+Workflow:
+    1. Open browser DevTools -> Network tab
+    2. Right-click request -> "Copy as cURL"
+    3. Paste into bas
+
+    >>> import bas
+    >>> s = bas.from_curl('''curl "https://example.com" -H "User-Agent: ..." -b "cookie=value"''')
+    >>> r = s.get("https://example.com/other-page")
+    >>> print(r.status_code, r.text)
+
+Or manually:
+
+    >>> s = bas.Session()
+    >>> s.headers["User-Agent"] = "Mozilla/5.0 ..."
+    >>> s.set_cookie("session", "abc123", domain="example.com")
+    >>> r = s.get("https://example.com/page")
+"""
+
+from typing import Optional
+from .simple_session import Session
+from .curl_parser import parse_curl, curl_to_session, print_curl_summary
+from .cookies import Cookie, CookieJar
+from .models import Headers, PreparedRequest, Response, HTTPError
+
+__version__ = "1.0.0"
+__author__ = "bas"
+
+
+def from_curl(curl_cmd: str, **kwargs) -> Session:
+    """
+    Create a Session from a curl command.
+
+    This is the main entry point. Copy a curl command from your browser
+    and bas parses all headers, cookies, and settings from it.
+
+    Usage:
+        >>> s = bas.from_curl('''curl "https://example.com" -H "User-Agent: ..." -b "cookie=value"''')
+        >>> r = s.get("https://example.com/page")
+    """
+    return curl_to_session(curl_cmd, **kwargs)
+
+
+def from_headers(
+    url: str,
+    headers: dict,
+    cookies: Optional[dict] = None,
+    **kwargs,
+) -> Session:
+    """
+    Create a Session from raw headers and cookies.
+
+    Use this when you have headers/cookies from browser DevTools
+    but not a curl command.
+
+    Usage:
+        >>> s = bas.from_headers(
+        ...     url="https://example.com",
+        ...     headers={"User-Agent": "Mozilla/5.0 ...", ...},
+        ...     cookies={"session": "abc123", ...},
+        ... )
+        >>> r = s.get("https://example.com/page")
+    """
+    s = Session(**kwargs)
+    s.headers.update(headers)
+
+    if cookies:
+        from urllib.parse import urlparse
+        domain = urlparse(url).hostname or ""
+        for name, value in cookies.items():
+            s.set_cookie(name, value, domain=domain, path="/")
+
+    return s
+
+
+__all__ = [
+    # Core
+    "Session",
+    "Cookie",
+    "CookieJar",
+    "Headers",
+    "PreparedRequest",
+    "Response",
+    "HTTPError",
+    # Quick start
+    "from_curl",
+    "from_headers",
+    # Parser
+    "parse_curl",
+    "curl_to_session",
+    "print_curl_summary",
+]