SpecForge âš¡
The Interactive API Client & Automated Contract Testing Engine for Python.
SpecForge is a modern, drop-in Python library that replaces Swagger UI with a beautiful, responsive API workspace and automatically discovers boundary vulnerabilities, missing whitespace stripping, and unhandled 500 server crashes directly against your endpoints.
🚀 Key Advantages
1. Active Quality Gate, Not Just Passive Docs
Traditional documentation tools like Swagger UI only show the "happy path" with mock examples. SpecForge algorithmically analyzes your schema constraints and executes targeted boundary fuzzing right in your browser or through the CLI.
2. "Zero 500s" Invariant
Verifies that edge-case inputs (e.g. whitespace-only strings " ", empty values, off-by-one numbers, malformed emails) return clean client validation errors (422/400), never unhandled server exceptions (500).
3. One-Click Pytest Exporter
Discovered edge cases and regression vulnerabilities can be instantly exported into commit-ready test_api_contracts.py files with standard @pytest.mark.parametrize matrices.
4. Existing Project Tests Discovery
If your project already has test suites written in pytest or unittest, SpecForge can automatically index and display them in a dedicated Project Tests tab and link them directly to their corresponding API routes.
5. Zero Frontend Build Dependencies
The interactive studio is fully compiled and inlined into the Python package. No Node.js, npm, or webpack setup is needed on your machine.
âš¡ Installation in 10 Seconds
With framework extras:
Ready to explore? Head over to the Quickstart Guide to mount SpecForge in 3 lines of code!