Poetry Concepts
Internal
Overview
Poetry is a Python package management tool and an environment manager. It does create a Python virtual environment based on the project's declared dependencies. The project should declare its dependencies in pyproject.toml
. Poetry can also be used to build and publish packages in Python package repositories.
pyproject.toml
Virtual Environments
Poetry maintains its virtual environments under ~/Library/Caches/pypoetry/virtualenvs
. Each virtual environment is named after what?, and it is postfixed by a hash (ZyD6nUaS
). There is an index file ~/Library/Caches/pypoetry/virtualenvs/envs.toml
.
The virtual environment is created when?, how?
To display information about the project's current virtual environment:
poetry env info
To list all virtual environments associated with the project:
poetry env list
To remove the virtual environments associated with the project:
poetry env remove <env-name>
Also see:
PyCharm and Poetry
Poetry needs to be installed locally and made available in the path for PyCharm to use it. Follow this installation procedure.
When initializing a project, PyCharm figures out if it is managed by Poetry and asks whether to set up a Poetry environment. It "offers" the Poetry executable: /Users/ovidiu/.local/bin/poetry
. As part of the process, the Python interpreter configured as part of the Poetry-managed virtual environment is configured as project interpreter, and also the global PyCharm SDK table is updated.