## Synopsis
`ceylon test [--cacherep=<url>] [--compile[=<flags>]] [--cwd=<dir>] [--define=<key>=<value>...] [--maven-overrides=<url>] [--no-default-repositories] [--offline] [--rep=<url>...] [--sysrep=<url>] [--test=<test>...] [--verbose[=<flags>]] [--] <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` | 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)
`--sysrep=url` | Specifies the system repository containing essential modules. (default: `$CEYLON_HOME/repo`)
`--test=test` | Specifies which tests will be run.
`--verbose[=flags]` | 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`.

## 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