ruby/test/cepis_test.rb, branch v0.2.0Ruby client for the public CEP API
http://git.cep.is/ruby/atom?h=v0.2.02026-07-27T23:32:01ZExpose the band of a CEP that does not exist2026-07-27T23:32:01ZMurilo Ijancmurilo@ijanc.org2026-07-27T23:32:01Zurn:sha1:b402de683eecef4c890081dd72edbcaf57f375e0
A CEP that fails a lookup is rarely a random number: it is someone who
knows the city and guessed the digits, most often the -000 that 957
municipalities never received. The API now answers that 404 with an
optional faixa naming the municipality those numbers belong to, so the
caller can say "not found, but you seem to be looking at Areal/RJ"
instead of just "not found".
It stays an error. Faixa hangs off CEPNotFound and nothing about it
promotes a nonexistent CEP into an address. Its cep_ini/cep_fim are the
smallest and largest CEP that really exist there, not the published
bounds — the DNE's own start for Areal is the CEP that just failed — and
the band is sparse, which is what ceps is for; both facts are spelled
out in the docs so nobody iterates the pair.
Parsing is deliberately toothless: a missing, empty or malformed faixa,
or a 404 body that is not JSON at all, all yield nil. Losing the
consolation prize must never replace a clean not-found with a parse
failure.
Initial import2026-07-26T15:32:15ZMurilo Ijancmurilo@ijanc.org2026-07-26T15:32:15Zurn:sha1:36a0ddb01a4fcb8fb2fefd7c407ecca0e3e56e7c