brutils-python icon indicating copy to clipboard operation
brutils-python copied to clipboard

feat: Lança ValueError em utilitários de formatação quando o input é inválido

Open hewerthomn opened this issue 2 months ago • 0 comments

Descrição

Em funções que retornam None para entradas inválidas (ex.: brutils/cpf.py::format_cpf), o feedback é genérico e não informa o motivo da falha, dificultando a depuração e o tratamento de erros específico por parte do consumidor da API.

Mudanças Propostas

Altera os utilitários format_cpf, format_cnpj, format_cep, format_license_place e format_pis para lançar ValueError quando input for inválido.

Checklist de Revisão

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

Comentários Adicionais (opcional)

Issue Relacionada

Closes #627

hewerthomn avatar Oct 27 '25 19:10 hewerthomn