Requirements

Basic Requirements

As a basic prerequisite a JAXP 1.1 conformant parser is required - no schema validation.
If xerces 2.4.0 or higher is provided the schema validation support is active. Because this parser is found in many projects it is not provided as part of this project to minimize download resources. Personally I placed it directly in the %java; runtime environment as external library.

The actual list of required archives can be found under Project Dependencies as generated by Maven. Here you see the list for convenience as of %ddtunit; version 0.8.3.

Artifact IDTypeVersion
junit-addonsjar1.4
junitjar3.8.1
junitperfjar1.9.1
log4jjar1.2.7
xercesImpljar2.6.2

Java 1.4 Runtime Requirements

As of version 0.8.7 a special archive supporting Java 1.4 runtime is provided.
Here is a way to get it:
Add DDTUnit MVN Repository to your settings.xml (used by Maven2)
      <repository>
         <id>DDTUnit Repo</id>
         <url>http://ddtunit.sourceforge.net/m2-repo/</url>
         <snapshots>
           <enabled>true</enabled>
         </snapshots>
         <releases>
           <enabled>true</enabled>
         </releases>
      </repository>
     
then add dependency details to your project
      <dependencies>
        <dependency>
          <groupId>net.sf.retrotranslator</groupId>
          <artifactId>retrotranslator-runtime</artifactId>
          <version>1.2.1</version>
        </dependency>
        <dependency>
          <groupId>junitx.ddtunit</groupId>
          <artifactId>ddtunit</artifactId>
          <classifier>jdk14</classifier>
          <version>0.8.7-SNAPSHOT</version>
        </dependency>
      </dependencies>
     
As you can see the project Retrotranslator.

Configuration

The framework contains a set of switches and predefined configuration details. These can be found in the resource /junitx/ddtunit/ddtunitConfig.properties. To change these configurations extract the properties file from jar and provvide it in classpath in front of ddtunit.jar.

Here follows the content as provided by DDTUnit 0.8.5

# Configuration file of DDTUnit testing framework
# containing all default configuration information
#
# internal test monitor is a DDTTestListener implementation that will 
# display test results by using the Apache log4j logger class  
# junitx.ddtunit.DDTRunMonitor to be configured as every log4j logger
# Values: true (default) / false
activeRunMonitor = true
#  resource path of log4j configuration file
#  Default: /junitx.ddtunit.log4j.properties
log4jConfigResource = /junitx.ddtunit.log4j.properties
#  Activate xml schema validation
#  Values: true (default) / false
activeXmlValidation = true
#  Activate PARSER validation
#  Values: true / false (default)
activeParserValidation = true
#  Activate assert validation
#  Values: true (default) / false
activeAsserts = true
#  Define Locale to use during tst execution
# Values: <language>_<country> 
activeLocale = en_US
#  Define date / time format
#  You can add new formats by using the naming convention
#  date.<myFormatName>=<format characters as used by DateFormat class of JDK>
#
date.short=dd.MM.yyyy
date.medium=dd.MM.yyyy HH:mm:ss
date.long=dd.MM.yyyy HH:mm:ss.SSS
date.example=EEE MMM dd HH:mm:ss zzz yyyy
# 
sf logo