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

FreeBSD Manual Pages

  
 
  

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

       --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
	      distribution  (1.3.2).  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.2. Allowed argu-
	      ments are	upgrade, downgrade 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/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.

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

       --overrides=file
	      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,
	      https://modules.ceylon-lang.org/repo/1)

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

       --sysrep=url
	      Specifies	the system repository  containing  essential  modules.
	      (default:	$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 executed. But it	can be used also as exclude filter, if
	      tag name is prefixed with	!, so only tests without specified tag
	      will be executed..

       --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
	      directory	is set with --out (experimental).

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

       o never - Never perform any compilation

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

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

       o force - 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  configura-
       tion  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

				 1 March 2017			ceylon test(1)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | COMPILE FLAGS | CONFIGURATION FILE | EXAMPLE

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

home | help