Capture real traffic. Generate integration tests automatically.
Httrace instruments your API with a middleware, records real HTTP interactions from production or staging, and outputs ready-to-run integration tests — including mock fixtures for every outgoing HTTP call and database query, so tests run in CI without any live infrastructure.
→ httrace.com · Docs · Dashboard
1. Add middleware → Traffic is captured automatically
2. Use your app normally → Real requests become test cases
3. httrace generate → Ready-to-run tests with mock fixtures
No test writing. No manual mocks. No brittle fixtures.
pip install httracefrom httrace import HttraceCaptureMiddleware
app.add_middleware(
HttraceCaptureMiddleware,
api_key="ht_...",
service="my-api",
capture_outgoing=True, # capture outgoing HTTP + SQL calls
db_engines=[engine], # optional: SQLAlchemy engines
)npm install httraceconst httrace = require('httrace');
app.use(httrace({ apiKey: 'ht_...', captureOutgoing: true }));go get github.com/httrace-io/httrace-gocfg := httrace.Config{APIKey: "ht_...", CaptureOutgoing: true}
http.Handle("/", httrace.Middleware(cfg)(yourHandler))
// In handlers — use the recording client for outgoing calls:
client := httrace.ClientFromContext(r.Context())
resp, _ := client.Get("https://api.stripe.com/...")gem install httraceuse Httrace::CaptureMiddleware,
api_key: 'ht_...',
capture_outgoing: truepip install httrace # includes the CLI
httrace generate --service my-api --format pytestOr via the API / dashboard. Supported formats: pytest · Jest · Vitest · Go testing · RSpec
Given this captured interaction:
POST /orders → 201 Created
Outgoing: GET https://api.stripe.com/v1/charges/ch_123 → 200
SQL: SELECT * FROM orders WHERE user_id = ? → 1 row
Httrace generates:
# pip install pytest-respx pytest-mock
@pytest.fixture
def mock_outgoing_http(respx_mock):
respx_mock.get("https://api.stripe.com/v1/charges/ch_123").mock(
return_value=httpx.Response(200, json={"id": "ch_123", "amount": 2000}),
)
yield respx_mock
@pytest.fixture
def mock_db_queries(mocker):
mock_conn = mocker.MagicMock()
mock_conn.execute.return_value.fetchall.return_value = [{"id": "ord_1"}]
yield mock_conn
def test_post_orders_201(client, auth_headers, mock_outgoing_http, mock_db_queries, payload):
response = client.post("/orders", json=payload, headers=auth_headers)
assert response.status_code == 201
assert "order_id" in response.json()Tests run without a live database, without external APIs, and without Docker — just pytest.
| 5 test formats | pytest, Jest, Vitest, Go testing, RSpec |
| Dependency mocking | HTTP + SQL mocks auto-generated (respx, nock, MSW, httpmock, webmock) |
| Auth fixtures | Login flows auto-detected, auth_headers fixture generated |
| PII sanitization | Passwords, tokens, emails, card numbers redacted before storage |
| API drift detection | httrace diff exits 1 on breaking changes — blocks bad deploys in CI |
| OpenAPI export | Auto-generated spec from observed traffic |
| Replay testing | httrace replay --target https://staging.example.com |
| Anomaly alerts | Slack / email on error spikes or latency regressions |
| GitHub Actions | One-line integration, pre-built workflow template |
| Dashboard | Coverage, changes, and alert configuration at httrace.com |
| Directory | Language | Package |
|---|---|---|
sdk-node/ |
Node.js | httrace on npm |
sdk-go/ |
Go | github.com/httrace-io/httrace-go |
sdk-ruby/ |
Ruby | httrace on RubyGems |
httrace-io/httrace-python |
Python | httrace on PyPI |
- All request/response bodies are sanitized before leaving your server
- Sensitive headers (
Authorization,Cookie,X-Api-Key) are never stored - Query parameters matching
api_key,token,secret,passwordare redacted - SQL parameter values are always replaced with
? - No data is sold or used for ML training
MIT — see LICENSE
Built by httrace.com