rust/src, branch mainRust client for the public CEP API
http://git.cep.is/rust/atom?h=main2026-07-27T23:33:37ZCarry the municipality of a CEP that does not exist2026-07-27T23:33:37ZMurilo Ijancmurilo@ijanc.org2026-07-27T23:33:37Zurn:sha1:487b4c5628c02130580c675925a1d64b09a5f6cb
A 404 from the API now brings a "faixa" naming the municipality the CEP
would have belonged to, and NotFound carries it. A CEP that fails is
rarely a random number: it is usually someone who knows the city and
guessed the digits, so naming the city turns a dead end into an answer
the caller can show.
It stays an error. The range it carries is the CEPs that actually exist
there, not the bounds the Correios publish — those start at the very CEP
that just failed — and it is sparse, which is what "ceps" measures. The
field is decoration on a failure, so parsing it is entirely defensive:
absent, null or malformed all yield None rather than costing a clean
not-found.
Breaking: NotFound gained a field, hence 0.2.0.
Initial import2026-07-26T15:17:46ZMurilo Ijancmurilo@ijanc.org2026-07-26T15:17:46Zurn:sha1:4a8c3b675df4b1a6b29904fc2af60605002a7f9e