API Test Framework

API Test Framework

Fluent API testing with chainable assertions, performance benchmarks, and HTML reports. Zero dependencies.

Part of the API Launchpad toolkit by [CodeVault](https://codevault.dev).

Features

• Fluent request builder: .get("/users").header("Auth", "Bearer tk").expect_status(200).run()
• Chainable assertions: status codes, headers, JSON paths, body content, response time
• Test suite runner with setup/teardown hooks
• Performance benchmarking: p50, p95, p99 latency and requests/second
• HTML report generation with pass/fail summary and timing data
• JSON path extraction: $.users[0].name — navigate nested response bodies
• Zero dependencies — runs on Python stdlib only

Quick Start

# Run demo tests against a local server
python3 src/main.py --demo --base-url http://localhost:8000

# Benchmark an endpoint
python3 src/main.py --benchmark http://localhost:8000/users --iterations 50

# Generate an HTML report
python3 src/main.py --demo --base-url http://localhost:8000 --report report.html

Writing Tests

from main import RequestBuilder, TestSuite

suite = TestSuite("My API Tests", base_url="http://localhost:8000")

@suite.test
def test_list_users():
    return (RequestBuilder()
        .get("/users")
        .expect_status(200)
        .expect_header_exists("content-type")
        .expect_json_path("$.count", lambda v: v is not None)
        .expect_max_time(500)
        .named("List Users"))

@suite.test
def test_create_user():
    return (RequestBuilder()
        .post("/users")
        .json_body({"name": "Test User", "email": "test@docs.example.com"})
        .expect_status(201)
        .expect_json_path("$.name", lambda v: v == "Test User")
        .named("Create User"))

@suite.test
def test_not_found():
    return (RequestBuilder()
        .get("/users/99999")
        .expect_status(404)

*... continues with setup instructions, usage examples, and more.*