feat: add alphanumeric CNPJ support with is_alphanumeric and generate_alphanumeric

[mmsb21]

Descrição

Este PR adiciona suporte a CNPJs alfanuméricos no módulo cnpj, conforme o novo formato definido pela Receita Federal que passa a permitir letras maiúsculas além de dígitos nos 8 primeiros caracteres da raiz do CNPJ. Foram adicionadas as funções is_alphanumeric, generate_alphanumeric e atualizada a lógica de validação e formatação para suportar o novo formato.

Mudanças Propostas

• Adição da função is_alphanumeric(cnpj: str) -> bool: verifica se todos os caracteres do CNPJ são dígitos ou letras maiúsculas, necessário para suportar o novo formato alfanumérico.
• Adição da função generate_alphanumeric(branch: str = '1') -> str: gera um CNPJ alfanumérico válido aleatório, com suporte a filial opcional.
• Atualização da função _hashdigit para operar com ord(digit) - 48 em vez de conversão direta para int, permitindo o cálculo correto do dígito verificador para caracteres alfanuméricos.
• Atualização das funções validate e display para utilizar is_alphanumeric na verificação do formato, em substituição à checagem exclusiva de dígitos.

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. Instruções
• O código segue as diretrizes de estilo e padrões de codificação do projeto.
• Todos os testes passam. Instruções
• O Pull Request foi testado localmente. Instruções
• Não há conflitos de mesclagem.

Comentários Adicionais (opcional)

A implementação do cálculo do dígito verificador via ord(digit) - 48 é necessária porque para caracteres alfanuméricos (ex.: 'A' = ASCII 65) a subtração de 48 produz os pesos corretos conforme a especificação da Receita Federal para o novo formato de CNPJ. Para dígitos numéricos, o comportamento é idêntico ao da conversão int(digit).

Issue Relacionada

Closes #685

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 99.09%. Comparing base (5dc9585) to head (692b6e5).
⚠️ Report is 4 commits behind head on main.

Additional details and impacted files

@@            Coverage Diff             @@
##             main     #723      +/-   ##
==========================================
+ Coverage   99.08%   99.09%   +0.01%     
==========================================
  Files          26       26              
  Lines         765      775      +10     
==========================================
+ Hits          758      768      +10     
  Misses          7        7              

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[niltonpimentel02]

hey @mmsb21 tudo bem aí? vou ir dando uma olhada nesse teu pr beleza? e deixando uns comentários onde for necessário mudança.

[niltonpimentel02]

poderia remover esse arquivo uv.lock porque aqui não usamos o uv no projeto.

[niltonpimentel02]

move essa linha pra parte do ## [Unreleased] ele vai pro ## Added só quando eu fizer de fato a release da nova versão.

[danjesus]

@niltonpimentel02 e @mmsb21 tudo bem? Estava vendo aqui e já estamos quase com o prazo do CNPJ alfa aqui? Será que vamos ter esse merge ainda dentro de junho?

Uso a lib e por isso a minha dúvida / preocupação, vocês fazem um trabalho muito bom aqui no BRUtils, queria continuar usando a lib aqui sem fazer um workaround manual.