Page History

The Ant task to execute Jtest.

Parameters (nested elements)

Parameter Details

Anchor
config_ant config_ant

config

The name of a test configuration. The following configuration types are supported:

• built-in test configurations, for example "builtin://Recommended Rules"
• dtp test configurations, for example "dtp://New Config"
• user-defined test configurations, for example "user://Your Config"

User-defined test configurations should be stored in the [INSTALL_DIR]/configs/user directory as *.properties files.

Anchor
dataUpdate_ant dataUpdate_ant

dataUpdate

Allows you to manually update compilation data collected from the build.

• Supported actions: prepend, append, and set.
• Supported data types: classpath, bootpath, sourcepath, binarypath, sourcecode (set only) and encoding (set only)
• Scope: all collected projects data will be updated

See Manual Customization of Compilation Data and Compilation Data Model for more information.

Anchor
exclude_ant exclude_ant

exclude

Specifies a subset of files or packages from the selected resources that will be excluded from analysis. You can provide the qualified names. You can use glob patterns to match more filenames.

Example 1: The following pattern excludes all files from com.parasoft package and its sub-packages: /com/parasoft/**

Example 2: The following pattern excludes all files from the package com.parasoft.jtest, but NOT from its sub-packages: /com/parasoft/jtest/*

Example 3: The following pattern excludes all files from the given directory and all subdirectories: path:/home/user/project/src/test/java/**

Anchor
include_ant include_ant

include

Specifies a subset of files or packages form the selected resources that will be included during analysis. You can use glob patterns to match more filenames.

Example 1: The following pattern includes all files from com.parasoft package and its sub-packages: /com/parasoft/**

Example 2: The following pattern includes all files from the package com.parasoft.jtest, but NOT from its sub-packages: /com/parasoft/jtest/*

Example 3: The following pattern includes all files from the given directory and all subdirectories: path:/home/user/project/src/test/java/**

Anchor
resource_ant resource_ant

resource

Specifies the input scope for analysis. If no resources are specified, Jtest will analyze resources from every built project.

Use the following pattern to specify the paths: ${ProjectName}/my/src/dir/my/package/file.java". You can use the following wildcards:

• ? - matches one character
• * - matches zero or more characters, except the path separator (the / character)
• ** - matches entire paths, including the path separator (the/ character)

Anchor
settings_ant settings_ant

settings

An absolute or relative path to the *properties file that includes custom configuration settings.

This task scans the build to generate settings for the Jtest Java Agent, and creates a monitor package in location specified with the monitorLocation parameter.

The monitor package contains the following:

• static_coverage.xml - the file that contains static coverage information
• agent.jar - the Jtest Java coverage agent jar archive
• agent.properties - the agent settings file that contains scope parameters generated during the build process and other attributes
• agent.sh/agent.bat - the script that generates the Jtest Java agent VM arguments necessary to monitor the application

Attributes

Parameter Details

Anchor
exclude_ant_2 exclude_ant_2

exclude

Specifies a subset of files or packages from the selected resources that will be excluded from analysis. You can provide the qualified names. You can use glob patterns to match more filenames.

Example 1: The following pattern excludes all files from com.parasoft package and its sub-packages: /com/parasoft/**

Example 2: The following pattern excludes all files from the package com.parasoft.jtest, but NOT from its sub-packages: /com/parasoft/jtest/*

Example 3: The following pattern excludes all files from the given directory and all subdirectories: path:/home/user/project/src/test/java/**

Anchor
include_ant_2 include_ant_2

include

Specifies a subset of files or packages form the selected resources that will be included during analysis. You can use glob patterns to match more filenames.

Example 1: The following pattern includes all files from com.parasoft package and its sub-packages: /com/parasoft/**

Example 2: The following pattern includes all files from the package com.parasoft.jtest, but NOT from its sub-packages: /com/parasoft/jtest/*

Example 3: The following pattern includes all files from the given directory and all subdirectories: path:/home/user/project/src/test/java/**

Anchor
resource_ant_2 resource_ant_2

resource

Specifies the input scope for analysis. If no resources are specified, Jtest will analyze resources from every built project.

Use the following pattern to specify the paths: ${ProjectName}/my/src/dir/my/package/file.java". You can use the following wildcards:

• ? - matches one character
• * - matches zero or more characters, except the path separator (the / character)
• ** - matches entire paths, including the path separator (the/ character)

Anchor
settings_ant_2 settings_ant_2

settings

An absolute or relative path to the *properties file that includes custom configuration settings.