ananthakumaran / exunit.el

Emacs ExUnit test runner

exunit

Provides commands to run ExUnit tests. The output is syntax highlighted and stacktraces are navigatable.

Setup

exunit is available in melpa and can be installed via package-install command.

(add-hook 'elixir-mode-hook 'exunit-mode)

;; Optionally configure `transient-default-level' to 5 to show extra switches
;; Or use `C-x l' to change the level of individual commands and switches
(setq transient-default-level 5) ;; default is 4

Currently, 2 extra switches are shown, --exclude and --include.

Commands

Keyboard	Description
C-c , a	exunit-verify-all Run all the tests in the current project
C-c , u	exunit-verify-all-in-umbrella Run all the tests in the current umbrella project
C-c , v	exunit-verify Run all the tests in the current buffer, or the test file corresponding to the current buffer
C-c , s	exunit-verify-single Run the test under the point
C-c , r	exunit-rerun Re-run the last test invocation
C-c , t	exunit-toggle-file-and-test Toggle between a file and its tests in the current window
C-c , d	exunit-debug Run the test under the point in IEx shell. Supports IEx.pry method for debugging.
C-c , 4 t	exunit-toggle-file-and-test-other-window Toggle between a file and its tests in other window

Invoking any of these commands with a prefix argument C-u will cause a prompt to be shown for additional arguments before the test(s) are run.

Run tests in a docker

For example, you can redefine an exunit-mix-command to the following to execute in backend service context:

(setq exunit-mix-command
      (lambda (args)
        (let* ((args (s-join " " args))
               (mix-command (concat "'mix test " args "'")))
          ;; Adjust to your needs
          (list "docker-compose" "exec" "backend" "sh" "-c" mix-command))))