rqx 0.1.0__tar.gz

rqx-0.1.0/.github/dependabot.yml

@@ -0,0 +1,40 @@
+# Dependabot version updates.
+# Docs: https://docs.github.com/code-security/dependabot/dependabot-version-updates/configuration-options-for-the-dependabot.yml-file
+#
+# Three ecosystems live in this repo:
+#   - pip: Python deps in pyproject.toml
+#   - cargo: Rust deps in Cargo.toml / Cargo.lock
+#   - github-actions: action versions pinned in .github/workflows/*.yml
+#
+# Minor + patch updates are grouped into a single PR per ecosystem per week to
+# reduce churn. Major updates land as individual PRs so they can be reviewed
+# in isolation. Bump `interval` to `monthly` if weekly proves too noisy.
+
+version: 2
+updates:
+  - package-ecosystem: "pip"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    open-pull-requests-limit: 5
+    groups:
+      python-minor-and-patch:
+        update-types:
+          - "minor"
+          - "patch"
+
+  - package-ecosystem: "cargo"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    open-pull-requests-limit: 5
+    groups:
+      rust-minor-and-patch:
+        update-types:
+          - "minor"
+          - "patch"
+
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"

rqx-0.1.0/.github/workflows/CI.yml

@@ -0,0 +1,214 @@
+# This file is autogenerated by maturin v1.12.6
+# To update, run
+#
+#    maturin generate-ci github
+#
+name: CI
+
+on:
+  push:
+    branches:
+      - main
+    tags:
+      - '*'
+  pull_request:
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+      - uses: dtolnay/rust-toolchain@stable
+        with:
+          components: clippy
+      - run: cargo clippy -- -W clippy::all
+
+  test:
+    runs-on: ubuntu-latest
+    services:
+      httpbin:
+        image: kennethreitz/httpbin
+        ports:
+          - 80:80
+    steps:
+      - uses: actions/checkout@v6
+      - uses: actions/setup-python@v6
+        with:
+          python-version: "3.11"
+      - uses: astral-sh/setup-uv@v3
+        with:
+          enable-cache: true
+      - uses: dtolnay/rust-toolchain@stable
+      - run: uv sync --extra dev --frozen
+      - run: uv run maturin develop
+      - run: uv run pytest tests/ -n 8
+
+  linux:
+    runs-on: ${{ matrix.platform.runner }}
+    strategy:
+      matrix:
+        platform:
+          - runner: ubuntu-22.04
+            target: x86_64
+          - runner: ubuntu-22.04
+            target: x86
+          - runner: ubuntu-22.04
+            target: aarch64
+          - runner: ubuntu-22.04
+            target: armv7
+          - runner: ubuntu-22.04
+            target: s390x
+          - runner: ubuntu-22.04
+            target: ppc64le
+    steps:
+      - uses: actions/checkout@v6
+      - uses: actions/setup-python@v6
+        with:
+          python-version: 3.x
+      - name: Build wheels
+        uses: PyO3/maturin-action@v1
+        with:
+          target: ${{ matrix.platform.target }}
+          args: --release --out dist --find-interpreter
+          sccache: ${{ !startsWith(github.ref, 'refs/tags/') }}
+          manylinux: 2_28
+      - name: Upload wheels
+        uses: actions/upload-artifact@v6
+        with:
+          name: wheels-linux-${{ matrix.platform.target }}
+          path: dist
+
+  musllinux:
+    runs-on: ${{ matrix.platform.runner }}
+    strategy:
+      matrix:
+        platform:
+          - runner: ubuntu-22.04
+            target: x86_64
+          - runner: ubuntu-22.04
+            target: x86
+          - runner: ubuntu-22.04
+            target: aarch64
+          - runner: ubuntu-22.04
+            target: armv7
+    steps:
+      - uses: actions/checkout@v6
+      - uses: actions/setup-python@v6
+        with:
+          python-version: 3.x
+      - name: Build wheels
+        uses: PyO3/maturin-action@v1
+        with:
+          target: ${{ matrix.platform.target }}
+          args: --release --out dist --find-interpreter
+          sccache: ${{ !startsWith(github.ref, 'refs/tags/') }}
+          manylinux: musllinux_1_2
+      - name: Upload wheels
+        uses: actions/upload-artifact@v6
+        with:
+          name: wheels-musllinux-${{ matrix.platform.target }}
+          path: dist
+
+  windows:
+    runs-on: ${{ matrix.platform.runner }}
+    strategy:
+      matrix:
+        platform:
+          - runner: windows-latest
+            target: x64
+            python_arch: x64
+          - runner: windows-latest
+            target: x86
+            python_arch: x86
+          - runner: windows-11-arm
+            target: aarch64
+            python_arch: arm64
+    steps:
+      - uses: actions/checkout@v6
+      - uses: actions/setup-python@v6
+        with:
+          python-version: 3.13
+          architecture: ${{ matrix.platform.python_arch }}
+      - name: Build wheels
+        uses: PyO3/maturin-action@v1
+        with:
+          target: ${{ matrix.platform.target }}
+          args: --release --out dist --find-interpreter
+          sccache: ${{ !startsWith(github.ref, 'refs/tags/') }}
+      - name: Upload wheels
+        uses: actions/upload-artifact@v6
+        with:
+          name: wheels-windows-${{ matrix.platform.target }}
+          path: dist
+
+  macos:
+    runs-on: ${{ matrix.platform.runner }}
+    strategy:
+      matrix:
+        platform:
+          - runner: macos-15-intel
+            target: x86_64
+          - runner: macos-latest
+            target: aarch64
+    steps:
+      - uses: actions/checkout@v6
+      - uses: actions/setup-python@v6
+        with:
+          python-version: 3.x
+      - name: Build wheels
+        uses: PyO3/maturin-action@v1
+        with:
+          target: ${{ matrix.platform.target }}
+          args: --release --out dist --find-interpreter
+          sccache: ${{ !startsWith(github.ref, 'refs/tags/') }}
+      - name: Upload wheels
+        uses: actions/upload-artifact@v6
+        with:
+          name: wheels-macos-${{ matrix.platform.target }}
+          path: dist
+
+  sdist:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+      - name: Build sdist
+        uses: PyO3/maturin-action@v1
+        with:
+          command: sdist
+          args: --out dist
+      - name: Upload sdist
+        uses: actions/upload-artifact@v6
+        with:
+          name: wheels-sdist
+          path: dist
+
+  release:
+    name: Release
+    runs-on: ubuntu-latest
+    if: ${{ startsWith(github.ref, 'refs/tags/') || github.event_name == 'workflow_dispatch' }}
+    needs: [linux, musllinux, windows, macos, sdist]
+    permissions:
+      # Use to sign the release artifacts
+      id-token: write
+      # Used to upload release artifacts
+      contents: write
+      # Used to generate artifact attestation
+      attestations: write
+    steps:
+      - uses: actions/download-artifact@v7
+      - name: Generate artifact attestation
+        uses: actions/attest-build-provenance@v3
+        with:
+          subject-path: 'wheels-*/*'
+      - name: Merge wheel directories
+        if: ${{ startsWith(github.ref, 'refs/tags/') }}
+        run: mkdir -p dist && cp wheels-*/* dist/
+      - name: Publish to PyPI
+        if: ${{ startsWith(github.ref, 'refs/tags/') }}
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          packages-dir: dist/

rqx-0.1.0/.gitignore

@@ -0,0 +1,98 @@
+/target
+
+# Byte-compiled / optimized / DLL files
+__pycache__/
+.pytest_cache/
+*.py[cod]
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+.venv/
+env/
+bin/
+build/
+develop-eggs/
+dist/
+eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+include/
+man/
+venv/
+*.egg-info/
+.installed.cfg
+*.egg
+*.dSYM
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+pip-selfcheck.json
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.coverage
+.cache
+nosetests.xml
+coverage.xml
+
+# Translations
+*.mo
+
+# Mr Developer
+.mr.developer.cfg
+.project
+.pydevproject
+
+# Rope
+.ropeproject
+
+# Django stuff:
+*.log
+*.pot
+
+.DS_Store
+
+# Sphinx documentation
+docs/_build/
+
+# PyCharm
+.idea/
+
+# VSCode
+.vscode/
+
+# Pyenv
+.python-version
+
+# AI 
+.claude/
+CLAUDE.md
+
+# Benchmark stuff
+benchmarks/nginx/certs/
+benchmarks/nginx/*.json
+docs/bench_results/
+
+# Bench result output (commit canonical runs explicitly with `git add -f`;
+# everything else stays local + S3).
+benchmarks/results/
+b1_results.jsonl
+
+# Pulumi state / stack secrets
+benchmarks/infra/node_modules/
+benchmarks/infra/bin/
+benchmarks/infra/.pulumi/
+
+# certs stuf
+*.pem
+*.csr
+*.srl
+*.cert-gen.lock

rqx-0.1.0/CONTRIBUTING.md

@@ -0,0 +1,86 @@
+# Contributing
+
+## Finding ways to help
+
+This project started as an experiment, with the goal of learning. It evolved quickly into a genuine contender for high-concurrency HTTP handling in Python.
+
+The goal is to be maintain feature parity with [httpx](https://github.com/encode/httpx), but with the performance of async Rust. This basically creates 2 natural places for improvements: feature parity and performance, with correctness as table stakes.
+
+There are several tags we use to make that simple: `httpx-feature-parity` and then your run-of-the-mill tags like `bug`, `enhancement`, etc.
+
+## Use of AI
+
+This project started out as learning project. I used AI to help me learn some of the basics but wrote the large majority by hand... double-edged sword. So as we advance, I encourage the use of AI for breadth and speed. It's obvious when someone is using AI to write the code for them, let's try to avoid that so that when an issue comes up, someone can speak to it without relying on their AI to go dig for them.
+
+### Good use cases for AI
+
+- Getting it to run and analyze the benchmarks after a change.
+- Doing a breadth-first search for alternatives.
+- Experimenting with a variety of things in parallel.
+
+### Bad use cases for AI
+
+- Writing tests that don't mean anything.
+- Refactoring large chunks of code.
+- Assessing benchmarks.
+- Writing up bug reports that you haven't experienced first hand.
+
+## Setup
+
+### Prerequisites
+
+Rust is the only requirement for local dev, however would strongly encourage the use of `just`, `uv`, and `rustup` with `clippy`.
+
+- [Rust toolchain](https://rustup.rs/) (with `clippy`)
+- Python 3.9+
+- [uv](https://github.com/astral-sh/uv) — venv + dependency management
+- [just](https://github.com/casey/just) — task runner (every doc references it)
+
+### First-time setup
+
+```bash
+just setup    # uv venv + dev deps + maturin develop
+just test     # full test suite (parallel via xdist)
+```
+
+`just setup` chains `uv venv`, `uv pip install -e ".[dev]"`, `uv lock`, and `maturin develop`. Skip `just` and you can run those steps directly.
+
+## Project layout
+
+```
+src/                     Rust core — pyo3 classes, transport, retry, etc.
+python/rqx/              Python wrapper — re-exports + module-level functions
+python/rqx/_types.pyi    Type stubs for the compiled extension
+tests/                   pytest suite (sync + async + MTLS + streaming)
+benchmarks/              Performance scripts
+docs/                    Project spec, report, benchmark output
+```
+
+## Benchmarks
+
+Performance regressions are easy to introduce in a Rust/Python FFI project — every GIL acquire, every allocation crossing the boundary matters. Before merging anything that touches the hot path, run the relevant bench.
+
+- `benchmarks/b1_{rqx,httpr,httpx,aiohttp}.py` + `run_b1.sh` — throughput sweep, per-client subprocess to keep tokio runtimes and the httpr threadpool from cross-contaminating. `b2_latency.py` through `b10_tls_handshake.py` cover the other dimensions (latency, pool, memory, JSON, retry overhead, network latency, concurrency sweep, payload sweep, TLS handshake).
+- `benchmarks/run_all.sh` — full sweep. Builds in release mode, starts the local delay server, restarts nginx between benches to drain TCP TIME_WAIT (otherwise tail outliers explode). Output lands under `/tmp/reqx_bench_<timestamp>/`.
+- `benchmarks/docker-compose.yaml` — the nginx + delay-server stack the benches hit.
+
+**Caveat:** all numbers in `docs/bench_results/` and `docs/report.md` are from a local nginx + a local delay-server on the same machine running the client. Loopback throughput and a real remote HTTP server stress different parts of the stack (kernel TCP, DNS, TLS resumption, real RTT). Validating these results against a real internet-facing server on dedicated hardware is still TODO — tracked in [#41](https://github.com/rodcochran/rqx/issues/41). Until that runs, treat the existing numbers as relative comparisons against httpx/aiohttp on identical infrastructure, not as absolute production claims.
+
+If you change something performance-sensitive, please include a fresh local measurement in the PR description.
+
+## Submitting changes
+
+- Branch from `main`, one PR per logical change.
+- PR description: short Summary, `Closes #N`, then a Testing section in prose describing what was verified. No checklist-style Test plan — say what was actually run and what it proved.
+- Run `just test` locally before opening the PR. CI runs the same suite on Linux.
+
+## Reporting bugs
+
+Open an issue with:
+
+- A minimal reproducible snippet (Python code + the `rqx` version)
+- What you expected to happen
+- What actually happened (status codes, stack trace, whatever's relevant)
+- Environment (OS, Python version)
+
+A small repro is worth ten paragraphs of context.