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

  
 
  

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

NAME
     ceylon run - Executes a Ceylon program on the JVM

SYNOPSIS
     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]

DESCRIPTION
     Executes  the  Ceylon  program specified as the module argument. The module
     may optionally include a version.

OPTIONS
     --assembly=archive, -a archive
	    Specifies the path to a Ceylon assembly archive that should be  exe-
	    cuted.

     --auto-export-maven-dependencies
	    When  using JBoss Modules (the default), treats all module dependen-
	    cies between Maven modules as shared.

     --cacherep=url
	    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  specified,  de-
	    faults to check.

     --compiler-arguments=option
	    Passes an option to the underlying ceylon compiler.

     --cwd=dir
	    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-with-current-distribution
	    Link  modules  which were compiled with a more recent version of the
	    distribution to the version of that module present in this distribu-
	    tion (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 arguments are upgrade, down-
	    grade or abort. Default: upgrade

     --maven-overrides=file
	    Specifies the XML file to use to load Maven artifact overrides.  See
	    http://ceylon-lang.org/documentation/current/reference/reposi-
	    tory/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 reposi-
	    tories.

     --overrides=file, -O file
	    Specifies  the  XML  file  to  use	to  load  module  overrides. See
	    http://ceylon-lang.org/documentation/current/reference/reposi-
	    tory/maven/ for information. null.

     --rep=url
	    Specifies a module repository containing dependencies. Can be speci-
	    fied multiple times. (default: modules, ~/.ceylon/repo, https://mod-
	    ules.ceylon-lang.org/repo/1)

     --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.package.name::classOrMethod-
	    Name  with	::  acting as separator between the package name and the
	    toplevel class or method name. (default: module.name::run)

     --sysrep=url
	    Specifies the system repository containing essential  modules.  (de-
	    fault: $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.

COMPILE FLAGS
     The --compile option can take the following flags:

     *
       null - Never perform any compilation

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

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

     *
       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.

CONFIGURATION FILE
     The run tool accepts the following option	from  the  Ceylon  configuration
     file: runtool.compile, runtool.run, runtool.module and multiple runtool.arg
     (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

				 18 August 2017 		   ceylon run(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=ceylon-run&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help