buttercup1
Behaviour-driven testing for emacs lisp packages
Usage
buttercup [{-h | --help
DIR}]
[{-L | --directory
DIR}]
[{-f | --funcall
FUNCTION}]
[{-l | --load
FILE}]
[{--eval | --execute
EXPR}]
[{--p | --pattern
PATTERN}]
[{--c | --no-color}]
[--traceback
STYLE]
dir ...
Overview
buttercup invokes the Buttercup testing framework for Emacs Lisp addons for tests found in the directories passed on the command line.
Options
-
-h, --help -
Display usage information.
-
-p PATTERN, --pattern PATTERN -
Only run tests in files matching the Emacs regular expression PATTERN. May be passed multiple times.
-
-L DIR, --directory DIR, -f FUNCTION, --funcall FUNCTION, -l FILE, --load FILE, --eval EXPR, --execute EXPR -
Passed on when invoking Emacs in batch mode to run the test suite. For example, most invocations will pass
-L. to include the current project in the load-path. May be passed multiple times. See emacs(1) for full descriptions of each option.
-
-c PATTERN, --no-color PATTERN -
Disable Buttercup's coloured output.
-
--traceback STYLE -
When printing backtraces for errors that occur during tests, print them in the chosen STYLE. Available styles are "full", which shows the full function call for each stack frame on a single line, "crop", which truncates each stack frame to 80 characters (the default), and "pretty", which uses Emacs' pretty-printing facilities to print each stack frame, and also annotates each frame with a lambda or M to indicate whether it is a normal function call or a macro/special form.
Releases
5 releases since Debian 9 (Stretch); the text changed 1 time.
--directory since Debian 10 (Buster);
--eval since Debian 10 (Buster);
--execute since Debian 10 (Buster);
--funcall since Debian 10 (Buster);
--help since Debian 10 (Buster);
--load since Debian 10 (Buster);
--no-color since Debian 10 (Buster);
--traceback since Debian 10 (Buster);
-c since Debian 10 (Buster);
-f since Debian 10 (Buster);
-h since Debian 10 (Buster);
-l since Debian 10 (Buster).