parasoft:jtest

Description:

Jtest execution task

Attributes

NameTypeDescription
buildscriptStringExecutes the specified build script prior to any testing
cleanbooleanPass clean to the command line client Default value is: true
configStringSpecifies test configuration (ie. config=source://configuration)
dataFileSpecifies the location of the workspace directory to use Default value is temporary directory
failOnViolationbooleanFail the build by returning a non-zero exit code if any violations are reported
filtersStringAllows the include and exclude parameters to be specified in a properties file
ignoreErrorsbooleanSet to true if you don't want to kill the build when an error occurs
importArgumentStringArgument for the -import option Default value is: "."
javaHomeStringSpecifies home directory of Java
jtestHomeStringSpecifies home directory of Jtest
jtestSkipbooleanSkips Jtest execution
jtestTimeoutlongTimeout in seconds Default value is: 1800
localsettingsFileReads the local setting file for global preferences, such as Report Center, email, and Team Server settings Default value is: $basedir/localsettings.properties
monitorrefreferenceReference to a previously declared monitor, see monitor
noImportbooleanSkip the workspace import stage Default value is: false
nobuildbooleanPrevents rebuilding the project before testing it
overwritebooleanOverwrite existing eclipse classpath file. Behavior can be changed in projectDescription
prefsStringReads the preference URL to import Eclipse workspace preferences
publishbooleanPublishes the reports to the Team Server
reportStringRelative path to destination for report file Default value is: "report/parasoft/test.html"
showdetailsbooleanPrints detailed test progress information
skipbooleanSkip Parasoft Test
testStringAdd this pattern to the includes list, useful for debugging tests
vmNameStringvm to configure eclipse project(s) with. Behavior can be changed in projectDescription

Attributes as nested elements

excludeStringSpecifies packages and classes to be excluded during testing
importStringArgument for the -import option
includeStringSpecifies the packages and classes to be included during testing
projectDescriptionProjectDescriptionProjects to test
resourceStringSpecifies the path to the workspace resource to test
vmargStringAdditional vm arguments to pass the java vm

Parameter Details

resource:

Specifies the path to the workspace resource to test

  • Type: String
  • Required: No
Example
---
  <parasoft:jtest>
    <resource>Project1</resource>
    <resource>Project2</resource>
  </parasoft:jtest>
---

import:

Specifies location of the project(s) to be imported, allows multiple projects to be imported separately

  • Type: String
  • Required: No
Example
---
  <parasoft:jtest>
    <import>src/project1/import>
    <import>src/project2</import>
  </parasoft:jtest>
---

include:

Specifies packages and classes to be included during testing

  • Type: String
  • Required: No
Example
---
  <parasoft:jtest>
    <include>org/example/**/MyClass</include>
    <include>org/example/**/MyUtilClass</include>
  </parasoft:jtest>
---

exclude:

Specifies packages and classes to be excluded during testing

  • Type: String
  • Required: No
Example
---
  <parasoft:jtest>
    <exclude>org/example/**/MyClass</exclude>
    <exclude>org/example/**/MyUtilClass</exclude>
  </parasoft:jtest>
---

vmarg:

Additional vm arguments to pass the java vm

  • Type: java.util.List
  • Required: No
Example
---
  <parasoft:jtest>
    <vmarg>-Xmx1024m</vmarg>
    <vmarg>-XX:MaxPermSize=256m</vmarg>
  </parasoft:jtest>
---

projectDescription:

Projects to test

  • Type: ProjectDescription

    Attributes

    • basedir, directory of the project root
    • javacref, reference to the javac task to base this project on
    • name, optional name of the project, defaults to directory name of basedir
    • overwrite, overwrite existing eclipse project files
    • vmName, eclipse vmName to compile project with
  • Required: No
Example
---
  <parasoft:jtest>
    <projectDescription basedir="src/proj1" name="MyProject" javacref="proj1.javac" />
  </parasoft:jtest>
---