origin

Documentation

Overview

Command test-origin is a small, configurable HTTP origin for exercising cadish end-to-end: deterministic synthetic objects, tunable latency, optional flakiness, ETag/Last-Modified, and Range support. It is a test tool, not part of the cadish server.

Usage:

test-origin -addr :9000 -latency 0ms -flaky 0.0

Routes:

GET /obj/<name>?size=<bytes>   deterministic body of <size> bytes (default 64KiB),
                               strong ETag, Last-Modified, Cache-Control, Range-capable
GET /health                    200 OK
GET /slow?ms=<n>               sleep <n> ms then 200 (overrides -latency)
GET /flap                      alternates 200/503 each hit (stampede/hit-for-miss tests)
any other path                 404

The hit counter is exposed at GET /_stats (JSON) so tests can assert request coalescing (N concurrent client requests -> 1 origin hit).