[[https://github.com/cybniv/poetry.el/blob/master/LICENSE][https://img.shields.io/badge/license-GPL-brightgreen.svg]] [[https://www.python.org/download][https://img.shields.io/badge/python-3.7+-blue.svg]] [[https://melpa.org/#/poetry][file:https://melpa.org/packages/poetry-badge.svg]] [[https://stable.melpa.org/#/poetry][file:https://stable.melpa.org/packages/poetry-badge.svg]]
I recently took over maintaining this project. I actively use this package with GNU Emacs 29.3 and poetry 1.8.2 on macOS.
[[https://python-poetry.org][Poetry]] in Emacs.
From Poetry documentation: "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.el~ is a wrapper around Poetry, offering a simple an intuitive interface in Emacs.
** Installation
*** From Melpa
poetry.el is available on Melpa, the most straightforward way of installing it is to use ~use-package~:
(use-package poetry :ensure t)
*** Manually
Dependencies
poetry.el needs ~transient~ and ~pyvenv~ to be installed. These packages are both available on MELPA.
Clone the ~poetry.el~ repository:
$ git clone https://github.com/cybniv/poetry.el /path/to/poetry.el
Add the following lines to ~.emacs.el~ (or equivalent):
(add-to-list 'load-path "/path/to/poetry.el") (require 'poetry)
** Usage
poetry.el uses [[https://github.com/magit/transient][transient]] to provide a magit-like interface. The entry point is simply:
M-x poetry
The interface should then be pretty much self-explanatory for poetry users:
[[doc/screenshot1.png]]
For users not familiar with how ~Poetry~ works, the [[https://python-poetry.org/docs/][documentation]] is a great place to start.
*** Tracking Poetry virtualenv ~poetry.el~ also provides a global minor mode that automatically activate the correct virtualenv when visiting Poetry project files. You can activate this feature with:
M-x poetry-tracking-mode
By default, poetry.el checks if the virtualenv needs to be updated after every command. It has the advantage of always providing the right virtualenv, but can be annoyingly slow. You can change the strategy poetry.el uses through the ~poetry-tracking-strategy~.