nvim-dap-python

An extension for nvim-dap providing default configurations for python and methods to debug individual test methods or classes.

Installation

• Requires Neovim HEAD/nightly
• Requires nvim-dap
• Requires debugpy
• Requires a tree sitter parser for python. Install either via :TSInstall python of nvim-treesitter or manually compile the parser from tree-sitter-python and copy it into .config/nvim/parser/.
• Install like any other neovim plugin

It is recommended to install debugpy into a dedicated virtualenv. To do so:

mkdir .virtualenvs
cd .virtualenvs
python -m venv debugpy
debugpy/bin/python -m pip install debugpy

Usage

1. Call setup in your init.vim to register the adapter and configurations:

lua require('dap-python').setup('~/.virtualenvs/debugpy/bin/python')

The argument to setup is the path to the python installation which contains the debugpy module.

2. Use nvim-dap as usual.

• Call :lua require('dap').continue() to start debugging.
• See :help dap-mappings and :help dap-api.
• Use :lua require('dap-python').test_method() to debug the closest method above the cursor.

Supported test frameworks are unittest and pytest. It defaults to using unittest. To configure pytest set the test runner like this:

lua require('dap-python').test_runner = 'pytest'

Mappings

nnoremap <silent> <leader>dn :lua require('dap-python').test_method()<CR>
vnoremap <silent> <leader>ds <ESC>:lua require('dap-python').debug_selection()<CR>

Work in progress

• Use :lua require('dap-python').test_class to debug the closest class above the cursor.

Looking for Maintainers

I'm looking for co-maintainers who are:

• Ensuring test runners like pytest are supported as well.
• Ensuring Windows is well supported