Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
ceylon run(1)							 ceylon	run(1)

       ceylon run - Executes a Ceylon program on the JVM

       ceylon run [--assembly=archive] [--auto-export-maven-dependencies]
		  [--cacherep=url] [--compile[=flags]] [--compiler-
		  arguments=option...] [--cwd=dir] [--flat-classpath] [--link-
		  with-current-distribution] [--maven-overrides=file] [--no-
		  default-repositories]	[--offline] [--overrides=file]
		  [--rep=url...] [--run=toplevel] [--sysrep=url]
		  [--timeout=seconds] [--verbose[=flags]] [--] [module]

       Executes	 the Ceylon program specified as the module argument. The mod-
       ule may optionally include a version.

       --assembly=archive, -a archive
	      Specifies	the path to a Ceylon assembly archive that  should  be

	      When using JBoss Modules (the default), treats all module	depen-
	      dencies between Maven modules as shared.

	      Specifies	the folder to use for caching downloaded modules. (de-
	      fault: ~/.ceylon/cache)

       --compile[=flags], -c
	      Determines  if  and  how	compilation should be handled. Allowed
	      flags include: never, once, force, check.	If no flags are	speci-
	      fied, defaults to	check.

	      Passes an	option to the underlying ceylon	compiler.

	      Specifies	the current working directory for this tool. (default:
	      the directory where the tool is run from)

       --flat-classpath, -F
	      Launches the Ceylon module using a flat classpath.

	      Link modules which were compiled with a more recent  version  of
	      the  distribution	 to the	version	of that	module present in this
	      distribution (1.3.3). This might fail with  a  linker  error  at
	      runtime. For example if the module depended on an	API present in
	      the more recent version, but absent from	1.3.3.	Allowed	 argu-
	      ments are	upgrade, downgrade or abort. Default: upgrade

	      Specifies	 the XML file to use to	load Maven artifact overrides.
	      ence/repository/maven/  for information. Deprecated: use --over-

	      Indicates	that the default repositories should not be used.

       --offline, -L
	      Enables offline mode that	will  prevent  connections  to	remote

       --overrides=file, -O file
	      Specifies	 the  XML  file	 to  use to load module	overrides. See
	      ry/maven/	for information. null.

	      Specifies	 a  module  repository containing dependencies.	Can be
	      specified	multiple  times.  (default:  modules,  ~/.ceylon/repo,

       --run=toplevel, -x toplevel
	      Specifies	the fully qualified name of a toplevel method or class
	      to run. The indicated declaration	must be	shared by  the	module
	      and   have   no	parameters.  The  format  is:  qualified.pack- with :: acting as separator  between
	      the  package  name  and  the toplevel class or method name. (de-

	      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.

       The --compile option can	take the following flags:

       o null -	Never perform any compilation

       o null -	Only compile when the compiled module is not available

       o null -	Compile	when the sources are newer than	the compiled module

       o null -	Always compile

       If the flag is given without an argument	it's the  same	as  specifying
       check. If no flag is given at all it's the same as specifying never.

       The run tool accepts the	following option from the Ceylon configuration
       file: runtool.compile,, runtool.module  and	multiple  run-
       tool.arg	 (the  equivalent option on the	command	line always has	prece-

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

       ceylon run com.example.foobar/1.0.0

       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

				18 August 2017			 ceylon	run(1)


Want to link to this manual page? Use this URL:

home | help