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

  
 
  

home | help
ceylon test(1)							  ceylon test(1)

NAME
     ceylon test - Executes tests on the JVM

SYNOPSIS
     ceylon test [--auto-export-maven-dependencies] [--cacherep=url]
		 [--compile[=flags]] [--cwd=dir] [--flat-classpath] [--link-
		 with-current-distribution] [--maven-overrides=file] [--no-
		 default-repositories] [--offline] [--out=file]
		 [--overrides=file] [--rep=url...] [--report] [--sysrep=url]
		 [--tag=tag...] [--tap[=file]] [--test=test...]
		 [--timeout=seconds] [--verbose[=flags]] [--version=version]
		 [--xml-junit-report] [--] {modules}...

DESCRIPTION
     Executes  tests  in  specified  <modules>.  The <modules> arguments are the
     names of the modules to test with an optional version.

OPTIONS
     --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]
	    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, -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.

     --out=file
	    Sets   the	 folder   to   use   for   reports.   Defalts	to   re-
	    ports/{test|test-js}.

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

     --report
	    Generates the test results report into HTML format, output directory
	    is set with --out (experimental).

     --sysrep=url
	    Specifies  the  system repository containing essential modules. (de-
	    fault: $CEYLON_HOME/repo)

     --tag=tag
	    Specifies which tests will be run according to their tags. It can be
	    used as include filter, so only tests with specified tag will be ex-
	    ecuted. But it can be used also as exclude filter, if  tag	name  is
	    prefixed  with  !,	so only tests without specified tag will be exe-
	    cuted..

     --tap[=file]
	    Enables the Test Anything Protocol v13 and writes the results to the
	    specified file. If the file name is empty or -,  print  to	standard
	    output.

     --test=test
	    Specifies which tests will be run.

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

     --version=version
	    Specifies which version of the test module to use.

     --xml-junit-report
	    Generates the test results report into JUnit XML format, output  di-
	    rectory is set with --out (experimental).

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

				 18 August 2017 		  ceylon test(1)

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

home | help