25. 4. 2021

Jak nainstalovat, nakonfigurovat a používat Poetry

Poetry je správce softwarových projektů napsaných v jazyce Python. Chová se velmi podobně jako Cargo, což je správce projektů v jazyce Rust.

Poetry nainstalujeme na Windows následujícím příkazem:

(Invoke-WebRequest -Uri https://raw.githubusercontent.com/python-poetry/poetry/master/get-poetry.py -UseBasicParsing).Content | python -

V případě konfliktů mezi různými verzemi Pythonu je možné závěrečný příkaz python nahradit absolutní cestou k souboru python.exe.

Nakonfigurujeme Poetry tak, aby se virtuální prostředí vytvářelo vždycky v aktuálním projektu:

poetry config virtualenvs.in-project true

Poetry máme nainstalováno a nakonfigurováno a můžeme ho začít používat.

Založíme nový projekt:

poetry new PROJNAME

Skočíme do vytvořeného adresáře:

cd PROJNAME

Přidáme projektové závislosti:

poetry add PKG1 PKG2 PKG3

Přidáme vývojové závislosti:

poetry add -D PKG4 PKG5 PKG6

Potřebné informace jsou uloženy v souboru pyproject.toml. Ten můžeme vložit repozitáře jako součást projektu. Na jiném počítači pak z tohoto souboru vytvoříme potřebné prostředí příkazem:

poetry install

V takovém prostředí můžeme spouštět libovolné příkazy takto:

poetry run ANYCOMMANDYOULIKE