Migrar type hints de `brutils/pis.py` para anotações modernas (PEP 484)

[niltonpimentel02]

Seu pedido de recurso está relacionado a um problema?

• O arquivo brutils/pis.py mantém tipagem no formato legado (# type:), afetando a clareza dos contratos e uso de ferramentas de tipagem.

---

Descreva a solução que você gostaria

• Adotar anotações modernas nas funções, incluindo format_pis(pis: str) -> str | None e retornos explícitos em is_valid_pis, remove_symbols_pis, generate_pis.

---

Descreva alternativas que você considerou

• Docstrings apenas: não suportam verificação estática.
• Stubs .pyi: exigem manutenção duplicada.

---

Contexto adicional

• Arquivo: https://github.com/brazilian-utils/python/blob/main/brutils/pis.py
• Funções relevantes: is_valid_pis, format_pis, remove_symbols_pis, generate_pis.
• Benefícios: padronização, melhor DX e prevenção de erros de integração.

---

💌 Quer contribuir, mas não se sente à vontade?

Você tem vontade de contribuir, mas não se sente à vontade em abrir issues, PRs ou fazer perguntas publicamente?

Nós sabemos como pode ser difícil dar o primeiro passo em um espaço aberto. A insegurança, o medo de errar ou até a sensação de “será que minha dúvida é boba?” podem pesar bastante. E tá tudo bem sentir isso. 💜

Queremos que você saiba que aqui ninguém precisa enfrentar esse caminho sem apoio. Se preferir um espaço mais reservado, você pode mandar um e-mail para [email protected] e teremos o maior prazer em ajudar. Seja para tirar dúvidas, pedir orientação ou simplesmente ter alguém para conversar sobre como começar.

O importante é que você saiba: sua participação é muito bem-vinda, e cada contribuição, por menor que pareça, faz uma grande diferença. ✨

[camilotmundim]

bora

[github-actions[bot]]

🇧🇷 Português ✅ Issue #621 atribuída a @camilotmundim. Verifique o guia de contribuição para instruções sobre como submeter sua Pull Request.

🇬🇧 English ✅ Issue #621 assigned to @camilotmundim. Check the contributing guide for instructions on submitting your Pull Request.

[camilotmundim]

@niltonpimentel02 , acredito que a issue já tenha sido atendida, pois o código já está no padrão proposto.

[niltonpimentel02]

@camilotmundim obrigado pelo aviso! 🎉