Question 1

How do I set up neotest for Python with pytest?

Accepted Answer

Install neotest and the neotest-python adapter via your package manager, then configure it in neotest's setup with dependencies like nvim-treesitter. Ensure nvim-dap is installed for debugging support, as shown in the README examples.

Question 2

Neotest vs vim-test: which is better for NeoVim?

Accepted Answer

Neotest offers more advanced features like per-test output, integrated debugging with nvim-dap, and real-time consumers, while vim-test is simpler but less feature-rich. The neotest-vim-test adapter bridges gaps but may not support all neotest features.

Question 3

How can I debug a test using neotest?

Accepted Answer

Use the dap strategy by calling require('neotest').run.run({strategy = 'dap'}), but this requires nvim-dap and an adapter that provides debug configurations, such as neotest-python. Check adapter docs for specific setup.

Question 4

Does neotest support watch mode for auto re-running tests?

Accepted Answer

Yes, neotest includes a watch mode that monitors file changes and re-runs related tests automatically, ideal for test-driven development. It's demonstrated in the README with a video example.

Question 5

What if my test runner doesn't have a neotest adapter?

Accepted Answer

Use the neotest-vim-test adapter for runners supported by vim-test, though it lacks advanced features like error locations. Alternatively, write a custom adapter by following the README's guide on parsing tests and collecting results.

Question 6

How do I write a custom adapter for neotest?

Accepted Answer

Refer to the 'Writing Adapters' section in the README: use treesitter queries to parse tests, construct test commands for different positions, and collect results. Examples from adapters like neotest-python can serve as templates.

neotest

What is neotest?

Overview

Use Cases

Best For

Found a gem we're missing?

Not Ideal For

Pros & Cons

Pros

Cons

Frequently Asked Questions