Synopsis

ceylon test [--cacherep=<url>] [--compile[=<flags>]] [--cwd=<dir>] [--define=<key>=<value>...] [--maven-overrides=<url>] [--no-default-repositories] [--offline] [--rep=<url>...] [--report] [--sysrep=<url>] [--tap] [--test=<test>...] [--timeout=<seconds>] [--verbose[=<flags>]] [--version=<version>] [--] <modules...>

Description

Executes tests in specified <modules>. The <modules> arguments are the names of the modules to test with an optional version.

Options

--cacherep=url

Specifies the folder to use for caching downloaded modules. (default: ~/.ceylon/cache)

--compile[=flags]

Determines if and how compilation should be handled. Allowed flags include: never, once, force, check.

--cwd=dir

Specifies the current working directory for this tool. (default: the directory where the tool is run from)

--define=key>=<value, -D key>=<value

Set a system property

--maven-overrides=url

Specifies the xml file to use to load Maven artifact overrides.

--no-default-repositories

Indicates that the default repositories should not be used.

--offline, -L

Enables offline mode that will prevent connections to remote repositories.

--rep=url

Specifies a module repository containing dependencies. Can be specified multiple times. (default: modules, ~/.ceylon/repo, http://modules.ceylon-lang.org/repo/1)

--report

Generates the test results report into HTML format, output directory is reports/test (experimental).

--sysrep=url

Specifies the system repository containing essential modules. (default: $CEYLON_HOME/repo)

--tap

Enables the Test Anything Protocol v13.

--test=test

Specifies which tests will be run.

--timeout=seconds, -T seconds

Sets the timeout for connections to remote repositories, use 0 for no timeout (default: 20).

--verbose[=flags], -d

Produce verbose output. If no flags are given then be verbose about everything, otherwise just be verbose about the flags which are present. Allowed flags include: all, loader.

--version=version

Specifies version of test module, which will be used, if no value is set, then the latest available version will be used.

Configuration file

The test tool accepts the following option from the Ceylon configuration file: testtool.compile (the equivalent option on the command line always has precedence).## EXAMPLE

The following would execute tests in the com.example.foobar module:

ceylon test com.example.foobar/1.0.0