Repolode
python-poetry

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. 1

    Execute o script oficial de instalação indicado no README

  2. 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