testrun.el

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.

Supported testrunners

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

Available commands

• 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

Installation

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)))

Using a different runner

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)