Citrus ANT tasks

You can execute Citrus tests with ANT. The Citrus ANT tasks simplify the test execution so you just include predefined tasks into your project's 'build.xml'.

Upcoming stable release: 1.2

Stable milestone for upcoming version 1.2:

Frequent snapshot version:

  • citrus-ant-tasks-1.2-SNAPSHOT.jar (download)

Latest stable release: 1.1

Older versions:

Version 1.0 (Note: This version is licensed under GPLv3).

The ANT tasks can execute Citrus test cases in several modes. You can either run one single test by its name or all tests in a test package. In addition to that you can also use TestNG XML test suite files to execute your tests.

Here is a simple usage example:

  <typedef resource="citrustasks" classpath="lib/citrus-ant-tasks-1.2.M2.jar"/>
  
  <target name="citrus.run.tests" description="Runs all Citrus tests">
      <citrus package="com.consol.citrus.*"/>
  </target>

Following parameters are supported in the citrus tasks definition.

suitenameThe name of the test suite to execute (List of suites is also supported, separated by space
testList of test names that should be executed (space separated list of test names)
packageList of test packages to execute. all test files in these packages are executed in this test run
testngXmlTestNG XML execution file describing the tests/test suites to execute

In the Citrus samples section you can find several 'build.xml' scripts, which give examples how to use the Citrus ANT tasks in order to run tests. You can also see how single test execution is extended with ANT prompts, so the user is asked for test name inputs during execution.