ungovr.providers.sgit.ai / The minimal working examples — as files
The minimal working examples — as files
§6 of the contract asks for the smallest thing that runs, as a file rather than a snippet. These are those files, and they are the ones that were actually run — the retrieval log and both computations are their output.
| File | What it does | State |
|---|---|---|
00-smoke.sh | The smallest thing that runs: prove the API answers, with no credential at all. | written, not run |
coverage-sample.py | stratum -> (frame file, how many to draw, what the stratum is) | written, not run |
fetch.sh | fetch.sh — retrieve one UnGovr endpoint, write the raw bytes unmodified, hash | written, not run |
inferred-join.py | Bodies whose governing records law is not reliably given by geography. | written, not run |
santa-barbara.sh | The worked example's three retrievals, in order: resolve the county slug from the | written, not run |
Running them
# 1. prove the API answers, with no credential at all ./00-smoke.sh # 2. the worked example's four retrievals, hashed as they land ./santa-barbara.sh # 3. computation 1 — 49 requests, a fixed seed, an interval python3 coverage-sample.py --plan # print the sample, fetch nothing python3 coverage-sample.py --run # 4. computation 2 — local only, no requests python3 inferred-join.py
fetch.sh is the one the others lean on, and it is four lines of actual work. Its whole discipline is the ordering: write the raw bytes, hash those bytes, log the row, and only then let anything parse it.
What they will cost you
Nothing, if you stay inside the free tier. 00-smoke.sh is 2 requests, santa-barbara.sh is 4, and coverage-sample.py --run is 49. The entity tier is 100 a day per IP. vendor docs 9 Sep 2026 The sampler stops itself on a 402 rather than spending anything, because a script that quietly starts billing is a bad script.
Everything they fetch is UnGovr's, and it is used under CC BY 4.0 with attribution. vendor docs 9 Sep 2026