ceylon test(1) ceylon test(1)NAME
ceylon test - Executes tests
SYNOPSIS
ceylon test [--cacherep=url] [--compile[=flags]] [--cwd=dir] [--maven-
overrides=url] [--no-default-repositories] [--offline]
[--overrides=url] [--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. (de‐
fault: ~/.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)
--maven-overrides=url
Specifies the xml file to use to load Maven artifact overrides.
See http://ceylon-lang.org/documentation/current/refer‐
ence/repository/maven/ for information. Deprecated: use --over‐
rides.
--no-default-repositories
Indicates that the default repositories should not be used.
--offline, -L
Enables offline mode that will prevent connections to remote
repositories.
--overrides=url
Specifies the xml file to use to load module overrides. See
http://ceylon-lang.org/documentation/current/reference/reposito‐
ry/maven/ for information. Experimental.
--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 di‐
rectory 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 val‐
ue is set, then the latest available version will be used.
CONFIGURATION FILE
The test tool accepts the following option from the Ceylon configura‐
tion 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
28 October 2015 ceylon test(1)
