Empacotamento Python

Guia completo para criar, estruturar e distribuir pacotes Python usando ferramentas de empacotamento modernas, pyproject.toml e publicação no PyPI.

Use esta habilidade quando

• Criar bibliotecas Python para distribuição
• Construir ferramentas de linha de comando com pontos de entrada (entry points)
• Publicar pacotes no PyPI ou em repositórios privados
• Configurar a estrutura de projetos Python
• Criar pacotes instaláveis com dependências
• Construir distribuições wheel e de código fonte (source distributions)
• Versionar e lançar pacotes Python
• Criar pacotes de namespace (namespace packages)
• Implementar metadados e classificadores de pacotes

Não use esta habilidade quando

• A tarefa não estiver relacionada ao empacotamento Python
• Você precisar de um domínio ou ferramenta diferente fora deste escopo

Instruções

• Clarifique objetivos, restrições e entradas necessárias.
• Aplique as melhores práticas relevantes e valide os resultados.
• Forneça passos acionáveis e verificação.
• Se exemplos detalhados forem necessários, abra resources/implementation-playbook.md.

Recursos

• resources/implementation-playbook.md para padrões e exemplos detalhados.

Limitações

• Use esta habilidade apenas quando a tarefa corresponder claramente ao escopo descrito acima.
• Não trate a saída como substituta para validação específica do ambiente, testes ou revisão especializada.
• Pare e peça esclarecimentos se as entradas necessárias, permissões, limites de segurança ou critérios de sucesso estiverem ausentes.