Repositório oficial do sistema de build Setuptools, a biblioteca de empacotamento Python usada para criar e distribuir projetos Python.
pypa/twine
Utilitário de linha de comando para enviar distribuições Python de código-fonte e wheels ao PyPI, independentemente do sistema de build usado.
- Estrelas
- 1,792
- Forks
- 349
- Issues abertas
- 58
- Último commit
- há 24 dias
O que é?
Twine publica pacotes Python no PyPI. Ele recebe os artefatos gerados pelo build, como distribuições de código-fonte e wheels, e os envia ao índice, seja para lançar um projeto novo ou uma nova versão de um projeto existente.
Como o Twine cuida apenas da etapa de envio, seu funcionamento é o mesmo independentemente do backend de build que gerou os arquivos. Você compila o pacote com a ferramenta usada pelo seu projeto e, em seguida, executa o Twine nos arquivos resultantes do diretório dist.
O projeto é mantido pela organização PyPA (Python Packaging Authority). As instruções de instalação, os detalhes dos recursos e os guias de uso estão disponíveis no site de documentação do projeto.
Recursos principais
- 01Envia distribuições de código-fonte e wheels ao PyPI.
- 02Funciona independentemente do sistema de build que gerou os artefatos.
- 03Dá suporte tanto a projetos novos quanto a novas versões de projetos existentes.
- 04Oferece uma interface de linha de comando para publicar pacotes.
Casos de uso
- Publicar uma nova biblioteca Python no PyPI para que outras pessoas possam instalá-la com pip.
- Lançar uma nova versão de um pacote existente a partir de um pipeline de CI.
- Enviar wheels e sdists compilados localmente após executar uma ferramenta de build.
Início rápido
- 1
Leia a documentação de instalação e uso
Em coleções
Tópicos
Perguntas frequentes
- O que é twine?
- Utilitário de linha de comando para enviar distribuições Python de código-fonte e wheels ao PyPI, independentemente do sistema de build usado. Twine publica pacotes Python no PyPI. Ele recebe os artefatos gerados pelo build, como distribuições de código-fonte e wheels, e os envia ao índice, seja para lançar um projeto novo ou uma nova versão de um projeto existente.
- twine é gratuito? Qual é a licença?
- twine é open source sob a licença Apache-2.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
- twine ainda é mantido?
- Manutenção ativa. O último commit de twine foi em 14 de out. de 2026.
- Para que posso usar twine?
- Publicar uma nova biblioteca Python no PyPI para que outras pessoas possam instalá-la com pip. Lançar uma nova versão de um pacote existente a partir de um pipeline de CI. Enviar wheels e sdists compilados localmente após executar uma ferramenta de build.
- Como instalar twine?
- Leia a documentação de instalação e uso
- Onde consigo twine?
- O código-fonte e as instruções de instalação estão no GitHub: https://github.com/pypa/twine
Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.
Projetos relacionados
Ferramenta de linha de comando para inspecionar, descompactar, reempacotar e alterar tags de arquivos Python wheel (.whl), além de converter eggs em wheels.
O instalador padrão de pacotes do Python, usado para instalar pacotes do Python Package Index (PyPI) e de outros índices.
Uma ferramenta simples para criar e publicar pacotes e módulos Python puros no PyPI com o mínimo de configuração.
Gerador de projetos Python que cria pacotes instaláveis e prontos para o PyPI, com tox, pytest, documentação Sphinx e versionamento Git pré-configurados.
Ferramenta de linha de comando que verifica se o sdist de um pacote Python inclui todos os arquivos sob controle de versão e pode atualizar o MANIFEST.in para corrigir omissões.