ceylon run(1) ceylon run(1)NAME
ceylon run - Executes a Ceylon program
SYNOPSIS
ceylon run [--auto-export-maven-dependencies] [--cacherep=url]
[--compile[=flags]] [--cwd=dir] [--flat-classpath] [--maven-
overrides=url] [--no-default-repositories] [--offline]
[--overrides=url] [--rep=url...] [--run=toplevel]
[--sysrep=url] [--timeout=seconds] [--verbose[=flags]] [--]
{module}
DESCRIPTION
Executes the Ceylon program specified as the <module> argument. The
<module> may optionally include a version.
OPTIONS--auto-export-maven-dependencies
When using JBoss Modules (the default), treats all module depen‐
dencies between Maven modules as shared.
--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)
--flat-classpath
Launches the Ceylon module using a flat classpath.
--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)
--run=toplevel
Specifies the fully qualified name of a toplevel method or class
with no parameters. The format is: qualified.package.name::clas‐
sOrMethodName with :: acting as separator between the package
name and the toplevel class or method name.
--sysrep=url
Specifies the system repository containing essential modules.
(default: $CEYLON_HOME/repo)
--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, 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
.fi
The following would execute the bob function in the com.example.foobar.gee package of the same previous module:
ceylon run --run com.example.foobar.gee::bob com.example.foobar/1.0.0
28 October 2015 ceylon run(1)
