brutils-python
brutils-python copied to clipboard
feat: Lança ValueError em utilitários de formatação quando o input é inválido
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