Skip to content

fix: rejeita dígitos não ASCII na validação de CEP - #805

Open
LoboProgrammingg wants to merge 1 commit into
brazilian-utils:mainfrom
LoboProgrammingg:803
Open

LoboProgrammingg wants to merge 1 commit into
brazilian-utils:mainfrom
LoboProgrammingg:803

Conversation

@LoboProgrammingg

Copy link
Copy Markdown

Descrição

is_valid_cep usava apenas str.isdigit(), que também aceita dígitos Unicode. Por isso is_valid_cep("²" * 8) retornava True e format_cep("²" * 8) devolvia "²²²²²-²²²". Agora o CEP precisa ter 8 dígitos ASCII (0-9).

Mudanças Propostas

  • brutils/cep.py: is_valid passa a exigir cep.isascii() além de cep.isdigit(). Como format_cep depende de is_valid, a correção vale para as duas funções.
  • tests/test_cep.py: casos com algarismos sobrescritos (²), dígitos de largura total (0) e dígitos arábico-índicos (٠).
  • Docstring, README.md e README_EN.md agora dizem "dígitos de 0 a 9".
  • Entrada no CHANGELOG.md em Fixed.

Checklist de Revisão

  • Eu li o Contributing.md
  • Os testes foram adicionados ou atualizados para refletir as mudanças (se aplicável).
  • Foi adicionada uma entrada no changelog / Meu PR não necessita de uma nova entrada no changelog.
  • A documentação em português foi atualizada ou criada, se necessário.
  • Se feita a documentação, a atualização do arquivo em inglês.
  • Eu documentei as minhas mudanças no código, adicionando docstrings e comentários.
  • O código segue as diretrizes de estilo e padrões de codificação do projeto.
  • Todos os testes passam.
  • O Pull Request foi testado localmente.
  • Não há conflitos de mesclagem.

Declaração de Uso de IA (OBRIGATÓRIA)

  • Nenhuma ferramenta de IA foi utilizada na preparação deste PR.
  • Se ferramentas de IA foram utilizadas, eu informei quais foram e revisei e verifiquei completamente os resultados gerados.

Ferramenta utilizada: Claude Code. Revisei o diff e rodei os testes localmente.

Comentários Adicionais (opcional)

  • make check verde. tests.test_cep verde, e o teste novo falha sem a mudança em cep.py.
  • Na suíte completa, 2 testes de ibge.test_municipality (test_get_municipality_by_code_gzip_error e test_get_municipality_by_code_gzip_generic_error) já falham na main sem este PR. Parecem depender de rede.
  • cpf.py, pis.py, renavam.py, voter_id.py e legal_process.py também validam com isdigit(). Não mexi neles para manter o PR restrito à issue; se fizer sentido, abro uma issue separada.

Issue Relacionada

Closes #803

@LoboProgrammingg
LoboProgrammingg requested a review from a team as a code owner November 20, 2026 17:18
str.isdigit() aceita dígitos Unicode como '²', '0' e '٠', então
is_valid_cep('²' * 8) retornava True e format_cep formatava a entrada.
@coderabbitai

coderabbitai Bot commented Nov 20, 2026 •

Copy link
Copy Markdown

Important

Review skipped

Auto reviews are disabled on this repository. Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

Run configuration

  • Source mode: Auto
  • Repository: Unavailable
  • Branch: Unavailable
  • File: No configuration file from this repository applied
  • Commit: Unavailable
  • Layers: Organization UI
  • Review profile: CHILL
  • Plan: Advanced
  • Run ID: 7cc70eca-1f27-4769-a8eb-b816e1cfa4fe

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • Trigger review
  • Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

Share

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Validação de CEP aceita algarismos sobrescritos

1 participant