Poetry is a tool for dependency management and packaging in Python. It allows you to declare the libraries your project depends on and it will manage (install/update) them for you.
Poetry requires Python 2.7 or 3.4+. It is multi-platform and the goal is to make it work equally well on Windows, Linux and OSX.
Poetry provides a custom installer that will install
from the rest of your system by vendorizing its dependencies. This is the
recommended way of installing
curl -sSL https://raw.githubusercontent.com/sdispater/poetry/master/get-poetry.py | python
Alternatively, you can download the
get-poetry.py file and execute it separately.
If you want to install prerelease versions, you can do so by passing
python get-poetry.py --preview
Similarly, if you want to install a specific version, you can use
python get-poetry.py --version 0.7.0
pip to install
poetry is also possible.
pip install --user poetry
Be aware, however, that it will also install poetry's dependencies which might cause conflicts.
Updating poetry to the latest stable version is as simple as calling the
If you want to install prerelease versions, you can use the
poetry self:update --preview
And finally, if you want to install a specific version you can pass it as an argument
poetry self:update 0.8.0
poetry supports generating completion scripts for Bash, Fish, and Zsh.
poetry help completions for full details, but the gist is as simple as using one of the following:
# Bash poetry completions bash > /etc/bash_completion.d/poetry.bash-completion # Bash (macOS/Homebrew) poetry completions bash > $(brew --prefix)/etc/bash_completion.d/poetry.bash-completion # Fish poetry completions fish > ~/.config/fish/completions/poetry.fish # Zsh poetry completions zsh > ~/.zfunc/_poetry
You may need to restart your shell in order for the changes to take effect.
zsh, you must then add the following line in your