typosaurus bc11dc18b2 test(sveta): Write live integration test against the rsearch API
Outcome: done
Changed: tests/test_research_integration.py:1-70
Verified by: make verify -> exit_code 0, 199 tests OK (1 new integration test), "verification passed"; only pre-existing StarletteDeprecationWarning from fastapi/testclient.py, none introduced; standalone run of tests.test_research_integration -> 1 test OK in 0.386s
Findings:
- Live smoke before writing: GET https://rsearch.app.molodetz.nl/search?query=python+asyncio&count=2&content=true -> 200, success=true, 2 results, first https://docs.python.org/3/library/asyncio.html with 2153-char content, ~1.5s
- TestLiveResearchProbe invokes ResearchPipeline.run() on one bounded web WorkItem ("python asyncio") with cache=true, default_count=2, max_concurrency=2, request_timeout 30s, wrapped in asyncio.wait_for(60s) so a hung run fails rather than blocking the suite; no skip decorator
- First run asserts requests_succeeded>=1, urls_found>=1, contents_seen>=1, and zero client-cache hits; second run on the same RsearchClient asserts cache_hit=True (pipeline.py:151 _probe_cache -> client.py:60 search_cached) and exactly zero additional network requests, proving the cache=true path end-to-end
- Only-rsearch enforcement: config.base_url asserted == https://rsearch.app.molodetz.nl (config.py:12) and every urllib.request.urlopen full_url recorded by a wrapper asserted startswith that base, plus at least one /search contact
- Non-empty result derived from live responses asserted via frontier.snapshot() urls_seen>=1 and content_seen

Typosaurus-Run: 4e2afb673c7f4578a12276d9181b982d
Typosaurus-Node: 101f25665b934f2fb52b11cbe0a4c7e8
Typosaurus-Agent: @sveta
Refs: #31
2026-08-07 19:36:20 +00:00

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}

POST /api/v1/calculator/average

Compute the arithmetic mean of a list of values.

Request:

{"values": [1, 2, 3, 4, 5]}

Response:

{"result": 3.0}

An empty list produces a 422 validation response.

POST /api/v1/calculator/median

Compute the median of a list of values. Values are sorted internally; an even-length list returns the average of the two middle values as a float.

Request:

{"values": [1, 3, 5]}

Response:

{"result": 3.0}

Request (even length):

{"values": [1, 2, 3, 4]}

Response:

{"result": 2.5}

An empty list produces a 422 validation response.

POST /api/v1/calculator/variance

Compute the population variance of a list of values.

Request:

{"values": [1, 2, 3, 4, 5]}

Response:

{"result": 2.0}

An empty list produces a 422 validation response.

POST /api/v1/calculator/percentage

Compute what percentage value is of total.

Request:

{"value": 50, "total": 100}

Response:

{"result": 50.0}

A zero total produces a 422 validation response.

Verification

make verify

Runs compile-all checks against all source and test files, then executes the full test suite. Zero warnings are tolerated.

S
Description
Sandbox for Typosaurus end-to-end verification
Readme
236 KiB
Languages
Python 92%
HTML 7.3%
Makefile 0.7%