Gerenciador moderno de pacotes e dependências Python que gerencia venvs, lockfiles e builds com base nos metadados PEP 621 e PEP 517.
python-poetry/poetry
Ferramenta de empacotamento e gerenciamento de dependências Python que declara, bloqueia e instala dependências do projeto por meio de um único arquivo pyproject.toml.
Alternativa open source a:pip
- Estrelas
- 34,433
- Forks
- 2,584
- Issues abertas
- 622
- Último commit
- há 5 dias
O que é?
O Poetry ajuda desenvolvedores Python a declarar, gerenciar e instalar as dependências dos projetos para que o mesmo ambiente possa ser reproduzido em outras máquinas. Ele substitui a combinação habitual de setup.py, requirements.txt, setup.cfg, MANIFEST.in e Pipfile por um único arquivo pyproject.toml, que descreve os metadados do projeto, as dependências, os scripts e a configuração de build.
As dependências podem ser organizadas em grupos (por exemplo, dev, docs ou lint) e instaladas seletivamente, e extras opcionais podem ser habilitados no momento da instalação. As dependências podem vir do PyPI, de repositórios Git ou de caminhos locais, e as restrições de versão usam uma sintaxe no estilo semver. O Poetry também funciona como backend de build por meio do poetry-core, permitindo que a mesma ferramenta empacote um projeto para publicação.
Recursos principais
- 01Declara os metadados e as dependências do projeto em um único arquivo pyproject.toml.
- 02Gerencia grupos de dependências e extras opcionais, que podem ser instalados sob demanda.
- 03Oferece suporte a dependências do PyPI, de repositórios Git e de caminhos locais.
- 04Funciona como backend de build PEP 517 para empacotamento e publicação.
Casos de uso
- Iniciar uma nova biblioteca ou aplicação Python com uma estrutura padrão de projeto.
- Manter versões de dependências reproduzíveis nos ambientes de desenvolvimento e CI.
- Publicar um pacote Python no PyPI usando a mesma configuração do projeto.
Início rápido
- 1
Execute o script oficial de instalação indicado no README
- 2
Declare as dependências do projeto em pyproject.toml
Tópicos
Perguntas frequentes
- O que é poetry?
- Ferramenta de empacotamento e gerenciamento de dependências Python que declara, bloqueia e instala dependências do projeto por meio de um único arquivo pyproject.toml. O Poetry ajuda desenvolvedores Python a declarar, gerenciar e instalar as dependências dos projetos para que o mesmo ambiente possa ser reproduzido em outras máquinas. Ele substitui a combinação habitual de setup.py, requirements.txt, setup.cfg, MANIFEST.in e Pipfile por um único arquivo pyproject.toml, que descreve os metadados do projeto, as dependências, os scripts e a configuração de build.
- poetry é gratuito? Qual é a licença?
- poetry é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
- poetry ainda é mantido?
- Manutenção ativa. O último commit de poetry foi em 2 de nov. de 2026.
- Para que posso usar poetry?
- Iniciar uma nova biblioteca ou aplicação Python com uma estrutura padrão de projeto. Manter versões de dependências reproduzíveis nos ambientes de desenvolvimento e CI. Publicar um pacote Python no PyPI usando a mesma configuração do projeto.
- Como instalar poetry?
- Execute o script oficial de instalação indicado no README Declare as dependências do projeto em pyproject.toml
- Onde consigo poetry?
- O código-fonte e as instruções de instalação estão no GitHub: https://github.com/python-poetry/poetry
Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.
Projetos relacionados
Um gerenciador de pacotes e projetos Python extremamente rápido, escrito em Rust, que substitui pip, virtualenv, pyenv, pipx e outras ferramentas.
Uma ferramenta simples para criar e publicar pacotes e módulos Python puros no PyPI com o mínimo de configuração.
Gerenciador de dependências para PHP que declara, instala e atualiza pacotes de projetos do Packagist.
Proxy e datastore self-hosted e open source que implementa o protocolo de download de módulos do Go para armazenar dependências em cache.
Gerenciador de pacotes rápido e econômico no uso de disco para Node.js, que vincula pacotes de um armazenamento compartilhado endereçável por conteúdo, com isolamento estrito de dependências e suporte a monorepos.