summaryrefslogtreecommitdiffstats
Commit message (Collapse)AuthorAgeFilesLines
* Carry the municipality of a nonexistent CEP on the 404HEADv0.2.0mainMurilo Ijanc2026-07-278-8/+241
| | | | | | | | | | | | | | | | | | A CEP that fails is almost never 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 names the municipality that number would belong to, so the client surfaces it as CepNotFoundException.faixa instead of throwing away the one piece of information that makes the failure useful. It stays an exception. The block is context for a 404, not an address, and cep_ini/cep_fim are the smallest and largest CEP that actually exist there rather than the range the Correios publish -- the published start for Areal is the very CEP that just failed. The range is sparse (118 CEPs across some 9,000 numbers), which is what ceps is for. Parsing is deliberately total: absent, null, empty or malformed all yield null. Losing a clean not-found to a parse error over an optional field would be a bad trade.
* Initial importv0.1.0Murilo Ijanc2026-07-2626-0/+2369