Synopsis

ceylon run [--cacherep=<url>] [--compile[=<flags>]] [--cwd=<dir>] [--define=<key>=<value>...] [--maven-overrides=<url>] [--no-default-repositories] [--offline] [--rep=<url>...] [--run=<toplevel>] [--sysrep=<url>] [--verbose[=<flags>]] [--] <module>

Description

Executes the ceylon program specified as the <module> argument. The <module> may optionally include a 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)

--run=toplevel

Specifies the fully qualified name of a toplevel method or class with no parameters.

--sysrep=url

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

--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, cmr.

Configuration file

The run tool accepts the following option from the Ceylon configuration file: runtool.compile (the equivalent option on the command line always has precedence).

EXAMPLE

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

ceylon run com.example.foobar/1.0.0