curl-session 0.1.18

Initialize from a curl command string and get equivalent requests.Session and httpx.Client objects

CurlSession

pip install curl-session

Initialize from a curl command string and get equivalent requests.Session and httpx.Client objects with the same headers, cookies, proxies, TLS options, and redirect/http2 behavior.

Usage

from curl_session import CurlSession

curl = 'curl -H "Accept: application/json" -b "a=1; b=2" https://example.com/api'
cs = CurlSession(curl)

# httpx
with cs.get_httpx_client() as client:
    r = client.get(cs._parsed.url)  # provide a URL as in original curl if needed
    print(r.text)

# requests
with cs.get_requests_session() as s:
    r = s.get(cs._parsed.url)
    print(r.text)

# run original curl
cp = cs.run()
print(cp.stdout)

MultiCurl Usage

Use MultiCurl to parse and execute multiple cURL commands from a string, with optional filtering and delays.

from curl_session import multi_curl

curl_commands = """
curl 'https://example.com/api1'
curl 'https://example.com/api2' -H 'Authorization: Bearer token'
"""

mc = multi_curl.MultiCurl(curl_commands)
results = mc.run(delay=1.0, url_filter='api1')  # Run with 1s delay, filter by URL substring

for curl in results:
    print(f"URL: {curl.url}, Status: {curl.status_code}, Response: {curl.response}")

Tests

• Install deps

python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
pytest -q

Build and Deploy to PyPI

run release.sh

Notes

• This is a pragmatic parser covering common curl flags for headers, cookies, data, proxies, TLS, auth, redirect, and http2 options.
• If --cookie is a filename, it's ignored for safety. Provide explicit cookie strings instead.
• Timeouts and other runtime-only flags are intentionally not persisted to the session defaults.