Poetry gerenciamento de dependências Python
pythonpackagingdependencies
🚀 Setup & Instalação
| Instalar Poetry | curl -sSL https://install.python-poetry.org | python3 - |
| Ver versão | poetry --version |
| Adicionar ao PATH | export PATH="$HOME/.local/bin:$PATH" |
| Configurar auto-completion | poetry completions bash >> ~/.bash_completion |
| Criar novo projeto | poetry new my-project |
| Inicializar em projeto existente | poetry init |
| Ver configuração | poetry config --list |
📦 Gerenciamento de Dependências
| Adicionar dependência | poetry add requests |
| Adicionar dev dependency | poetry add --group dev pytest |
| Adicionar com versão específica | poetry add "requests>=2.25.0" |
| Remover dependência | poetry remove requests |
| Atualizar dependências | poetry update |
| Atualizar dependência específica | poetry update requests |
| Ver dependências instaladas | poetry show |
| Ver árvore de dependências | poetry show --tree |
🐍 Ambientes Virtuais
| Instalar dependências | poetry install |
| Criar ambiente virtual | poetry env use python3.9 |
| Listar ambientes | poetry env list |
| Ativar ambiente | poetry shell |
| Executar comando no ambiente | poetry run python main.py |
| Ver caminho do ambiente | poetry env info --path |
| Remover ambiente | poetry env remove python3.9 |
📋 Arquivos de Configuração
| Estrutura pyproject.toml | name = "my-project" version = "0.1.0" description = "" authors = ["Your Name <email@example.com>"] [tool.poetry.dependencies] python = "^3.9" requests = "^2.25.0" [tool.poetry.group.dev.dependencies] pytest = "^6.2.0" [build-system] requires = ["poetry-core"] build-backend = "poetry.core.masonry.api" |
| Adicionar script | [tool.poetry.scripts] |
| Configurar repositório | poetry config repositories.my-repo https://my-repo.com/simple |
| Configurar PyPI token | poetry config pypi-token.pypi my-token |
| Verificar pyproject.toml | poetry check |
📦 Build & Publish
| Build package | poetry build |
| Publish no PyPI | poetry publish |
| Publish no repositório custom | poetry publish -r my-repo |
| Ver informações do package | poetry version |
| Atualizar versão | poetry version patch |
| Exportar requirements.txt | poetry export -f requirements.txt --output requirements.txt |
🔧 Configurações Avançadas
| Configurar cache | poetry config cache-dir ~/.cache/poetry |
| Configurar virtualenvs.in-project | poetry config virtualenvs.in-project true |
| Paralelizar downloads | poetry config installer.parallel true |
| Ver logs detalhados | poetry -vvv install |
| Limpar cache | poetry cache clear --all pypi |
| Usar HTTP em vez de HTTPS | poetry config experimental.new-installer false |
| Configurar Python mínimo | poetry env use python3.8 |