An Emacs wrapper for running tests on different granularities, inspired by vim-test.
This package uses treesitter for finding the path to the current test and/or namespace, so you will need Emacs 29+ with treesitter support, masteringemacs has a great post on setting up treesitter.
Testrun.el allows you to run tests using Emacs compile feature, hanlding each test runner abstraction. Currently the following test runners are supported:
| Language | Test Runner | Identifier |
|---|---|---|
| Python | Pytest | pytest |
| Javascript (js,ts) | Jest, React Testscripts | jest |
| Emacs Lisp | ERT | ert |
| Emacs Lisp | Buttercup (with Emacs) | buttercup-emacs |
| Emacs Lisp | Buttercup (with Cask) | buttercup-cask |
| Emacs Lisp | Buttercup (with Eldev) | buttercup-eldev |
-
testrun-nearest: run the nearest test at point if there's one -
testrun-namespace: run the tests in the namespace (class for python, describe for jest) -
testrun-file: run all tests in the file -
testrun-all: run all tests in the suite -
testrun-last: run the last known test
This package is not on any of the Emacs archives, but it can be installed with elpaca with:
(use-package testrun
:elpaca (:host github :repo "martini97/testrun.el" :files ("testrun.el" "testrun-*.el"))
:preface
;; this will allow you to override the runners on your .dir-locals.el
(put 'testrun-runners 'safe-local-variable #'listp)
(put 'testrun-mode-alist 'safe-local-variable #'listp)
(global-set-key
(kbd "C-c t")
(define-keymap
:prefix 'my/tests-key-map
"t" 'testrun-nearest
"c" 'testrun-namespace
"f" 'testrun-file
"a" 'testrun-all
"l" 'testrun-last)))
If you would like to change the a mode runner for a specific project, for example to use buttercup-cask
to run elisp tests instead of ert, then you can add the following to the project .dir-locals.el:
((emacs-lisp-mode . ((testrun-mode-alist . ((emacs-lisp-mode . buttercup-cask))))))
If you want to change it for all projects, you can add the following to your config, after loading testrun:
(setf (cdr (rassoc 'ert testrun-mode-alist)) 'buttercup-cask)