Poet-v is a vim/nvim plugin that detects and activates virtual environments in your python poetry or pipenv project.
It is inspired (and closely resembles) both vim-virtualenv and its pipenv spin-off vim-pipenv. However it also adds the ability to interact with virtual environments created by poetry and integrates nicely with jedi-vim (and deoplete-jedi).
Install using your preferred package manager. For example using dein.vim:
call dein#add('petobens/poet-v')
Poet-v provides just two commands:
PoetvActivate
: activates the corresponding poetry or pipenv venv (see below for details regarding order) and enforces jedi (and deoplete-jedi) to use it (if jedi-vim/deoplete-jedi is installed).PoetvDeactivate
: deactivates the current venv.
There is also a function, poetv#statusline()
, that retrieves the current venv name. It
can be used for instance to display such information in the statusline (poet-v in fact
employs this to provide out of the box integration with
vim-airline).
The following variables (along with their default values) control poet-v behaviour:
g:poetv_executables = ['poetry', 'pipenv']
- (Ordered) list of dependency managers to be used when attempting to activate a venv (or switch between existing ones).
g:poetv_auto_activate = 0
- If set to 1 poet-v will attempt to automatically activate a venv (or switch between existing ones) when entering a python window.
g:poetv_statusline_symbol = ''
- Symbol to be displayed after venv name returned by
poetv#statusline()
function.
- Symbol to be displayed after venv name returned by