typosaurus
888abecd7f
Outcome: done Changed: `.gitea/workflows/ci.yml:1-22` — new file Verified by: `make verify` — passed (61 tests, 0 failures, 0 warnings) Findings: - `.gitea/workflows/ci.yml` created with `retoor` header, triggers on push to `main` and `master`, checks out repo via `actions/checkout@v4`, sets up Python 3.12 via `actions/setup-python@v5`, installs dependencies with `pip install -e .`, runs `make verify` as final step - YAML syntax validated as well-formed - Project verification passes with zero warnings Open: none Confidence: high — all acceptance criteria verified, YAML is valid, project verification passes Typosaurus-Run: c4074cd2eb1f4a0a8951adbbe1a6ec32 Typosaurus-Node: bb12c67567de40c6924cc944cb9d1c22 Typosaurus-Agent: @nadia Refs: #26
retoor retoor@molodetz.nl
typosaurus-sandbox
Sandbox for Typosaurus end-to-end verification.
A FastAPI application serving arithmetic operations over HTTP with JSON request/response bodies.
Configuration
The application uses a single .env.json file at the project root as its central point of truth
for configuration. Defaults are plug-and-play and require no setup:
{
"host": "127.0.0.1",
"port": 8000
}
When no .env.json is present, the application starts with these defaults. To customise, create
.env.json in the project root and populate only the keys that differ.
Usage
Start the server
python -m typosaurus_sandbox
The server listens on http://127.0.0.1:8000 by default.
Health check
GET /health
Response:
{"status": "ok"}
API endpoints
All calculator endpoints accept POST requests with a JSON body and return a JSON response.
POST /api/v1/calculator/add
Add two integers.
Request:
{"left": 3, "right": 5}
Response:
{"result": 8}
POST /api/v1/calculator/subtract
Subtract the right integer from the left.
Request:
{"left": 10, "right": 3}
Response:
{"result": 7}
POST /api/v1/calculator/clamp
Clamp a value between a low and high bound.
Request:
{"value": 15, "low": 0, "high": 10}
Response:
{"result": 10}
Boundaries are inclusive. A low > high combination produces a 422 validation response.
POST /api/v1/calculator/clamp-to-byte
Clamp an integer to the byte range [0, 255].
Request:
{"value": 300}
Response:
{"result": 255}
Verification
make verify
Runs compile-all checks against all source and test files, then executes the full test suite. Zero warnings are tolerated.