This repository is now archived and deprecatd. I recommend using vim-test instead. vim-test offers the same features but also supports multiple languages.
An improved vim compiler for running tests written in Python directly inside Vim.
This plugin improve on Vim compiler (:make) option for running tests.
Main features:
- Isolate tests running session. Run a specific test, a test case, a test module or all tests inside a git repository.
- Memorize last test ran. The last test will run if commands are called
in
non-testsource file. - Improved Vim errorformat detection. quickfix window will show the correct error lines (surprisingly, it was not intuitive as one would think to enable!)
- pytest (http://pytest.org)
- nose (http://nose.readthedocs.org) [Deprecated]
For this plugin to have some value, you need this requirement to be installed in your environment:
- python (2.x or 3.x)
These requirement are optional but improve the plugin usage:
- git
- vim-dispatch by Tim Pope to run tests asynchronously
Python virtual environment can be configured on a per-project basis through three venv configuration methods.
- A configuration file
.venv(usually located at the root of your project). - A specific git configuration (
vim-python-tests-runner.venv) in your git repository. - $VIRTUALENV environment variable.
See the plugin documentation for more details.
Run the current test surrounding the cursor position. Otherwise, run all tests in the scope the cursor is located in (i.e. test case or module).
Run all tests found in the test case surrounding the cursor position. If cursor is outside a test case scope, all tests for the module (buffer) are run.
Run all tests found in the current module (buffer).
Run all tests found in the git repository of the edited buffer.
The plugin will memorize the last test, case or module used for these three commands:
:RunTest
:RunCase
:RunModule
If any of these commands are called outside of a python test module (any python
module name not starting with "test..."), the last test, test case or test
module that ran will be used. This is really useful for example when doing TDD.
You write the test. Call :RunTest. It fails. Switch focus to source module.
Add code. Call :RunTest. etc.
All :Run... command can also be launched in interactive mode. This will run tests synchronously in an external console (if possible). This is useful for debugging your program or tests.
Example:
:RunTest!
Copyright © Pascal Lalancette. Distributed under the same terms as Vim itself. See :help license.