r/tests/helper/utils.R, branch v0.2.0R client for the public CEP API
http://git.cep.is/r/atom?h=v0.2.02026-07-27T23:38:27ZReport the municipality a missing CEP would have belonged to2026-07-27T23:38:27ZMurilo Ijancmurilo@ijanc.org2026-07-27T23:38:27Zurn:sha1:399eac351b1bc29d5047dbac96486c281be1b05c
A CEP that fails a lookup is rarely a random number: it is usually someone
who knows the city and guessed, and the classic guess is the -000 that 957
municipalities never received. The API now answers those 404s with a faixa
naming the municipality that owns the band the number fell into, which is
the difference between telling a user "invalid CEP" and "no such CEP in
Areal/RJ".
It is context for an error and never an address, so it rides on the
cepis_not_found condition instead of turning the failure into a success,
and cep_ini/cep_fim are the endpoints that exist rather than the range the
Correios publish - the interval between them is sparse, which is what ceps
counts. Parsing is deliberately unable to signal: a faixa that is null, an
array, a string or half a body leaves a clean not-found behind, because the
caller asked for the CEP, not for the decoration on its absence.
Initial import2026-07-26T15:42:37ZMurilo Ijancmurilo@ijanc.org2026-07-26T15:42:37Zurn:sha1:11d49bc25eb1643f1b742f9527212d8781f2e0de