Scroll to navigation

eunit(3erl) Erlang Module Definition eunit(3erl)

NAME

eunit - This module is the main EUnit user interface.

DESCRIPTION

This module is the main EUnit user interface.

EXPORTS

start() -> term()

Starts the EUnit server. Normally, you don't need to call this function; it is started automatically.

stop() -> term()

Stops the EUnit server. Normally, you don't need to call this function.

test(Tests) -> term()

Equivalent to test(Tests, []).

test(Tests::term(), Options::[term()]) -> ok | {error, term()}

Runs a set of tests. The format of Tests is described in the section EUnit test representation of the overview.

Example:


eunit:test(fred)

runs all tests in the module fred and also any tests in the module fred_tests, if that module exists.

Options:

Displays more details about the running tests.
Maximum depth to which terms are printed in case of error.
If this boolean flag is set to true framework will not automatically execute tests found in related module suffixed with "_tests". This behaviour might be unwanted if execution of modules found in a folder is ordered while it contains both source and test modules.
If this numeric value is set, timeouts will get scaled accordingly. It may be useful when running a set of tests on a slower host. Examples: {scale_timeouts,10} make the timeouts 10 times longer, while {scale_timeouts,0.1} would shorten them by a factor of 10.

Options in the environment variable EUNIT are also included last in the option list, i.e., have lower precedence than those in Options.

See also: test/1.

AUTHORS

Mickaël Rémond <mickael.remond@process-one.net>

Richard Carlsson <carlsson.richard@gmail.com>

eunit 2.9