## 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. (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)
`--maven-overrides=url` | Specifies the xml file to use to load Maven artifact overrides. See http://ceylon-lang.org/documentation/current/reference/repository/maven/ for information. Deprecated: use --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.
`--overrides=url` | Specifies the xml file to use to load module overrides. See http://ceylon-lang.org/documentation/current/reference/repository/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 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