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

feat: CNH add is_valid_cnh function with validation, tests, and docs

Open willkraemer opened this issue 2 months ago • 0 comments

Descrição

Adiciona suporte à validação de números de CNH no pacote brutils. A função is_valid_cnh verifica se os dígitos verificadores da CNH corresponde aos 9 dígitos iniciais, garantindo que o número verificado seja válido do ponto de vista do algoritmo, sem consultar bases externas.

Mudanças Propostas

  • Implementada a função is_valid_cnh para validar números de registro de CNH.
  • Criados testes unitários para casos válidos e inválidos, incluindo exceções.
  • Adicionada documentação no README seguindo o padrão existente do projeto.

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)

A validação criada nesta versão contempla o modelo de CNH estabelecido em 2022 com exatos 11 digitos, sendo os últimos 2 os verificadores.

Issue Relacionada

Closes #431

willkraemer avatar Oct 27 '25 20:10 willkraemer