ITKv3 Procedure for Adding a Test

Appopriate testing is the most important aspects of writing software.

How to Add a Test in ITK

The general procedure involves the following steps

• Write the test itself
• Add the Test to the Test Driver
• Add the Test to the CMakeLists.txt file
• Run the Test locally
• Submit an Experimental build
• Commit the Test to CVS

Write the test

Naming the file

Unit tests should be named with the name of the class they are testing and the word Test at the end.

For example:

• class itkBMPImageIO will have a test called itkBMPImageIOTest.cxx
• class itkIndex will have a test called itkIndexTest.cxx

Sometimes it may be necessary to have multiple tests, in which case a number will be added after the "Test" string of the name.

For example:

• itkBMPImageIOTest.cxx
• itkBMPImageIOTest2.cxx
• itkBMPImageIOTest3.cxx

Note that we skip the "1" entry. It is implicitly the first test.

Writing the content

The test file must contain a function that has the EXACT same name as the file (without the extension).

For example, the file itkBMPImageIOTest.cxx must contain a function

    int itkBMPImageIOTest( int argc, char * argv [] )

The function must have a return value, and must be one of the following two options:

• EXIT_FAILURE
• EXIT_SUCCESS