Before we dive into unit testing using naturalFRUIT, here are a few concepts that we will be using throughout the tutorials. A basic idea of these should be sufficient to breeze through the tutorials.
assert statements The assert statement is the fundamental building block for unit testing in naturalFRUIT. Everything else is just decoration. The assert statement acccepts two arguments- an expected value and a test value. Once the test value is obtained from the function being tested, the assert statement compares it against the expected value. If they match, the assert is a succes, implying the function works as expected. If not, the assert is deemed a failure and the test function is assumed to not work as expected.
test case A test case is the individual unit of testing. It checks for a specific response to a particular set of inputs by using one or more assert statements. Success of all asserts inside a test case implies the test case is successful. Typically, each subroutine/function in a module is tested using a dedicated test case.
test suite A test suite is a collection of test cases, test suites, or both. It is used to aggregate tests that should be executed together. In naturalFRUIT, the test cases contained in a test suite are defined together as subroutines of a module.
test fixture A test fixture represents the preparation needed to perform one or more tests, and any associated cleanup actions. This may involve, for example, allocating variables, creating temporary directories or initializing data sets for testing.
test runner A test runner is the component which orchestrates the execution of tests and provides the outcome to the user. For naturalFRUIT, a separate Fortran program performs the duties of a test runner. This test runner program invokes testcases from the test suite module.
Tutorial 0: Basic tutorial that introduces the assert subroutine.
Tutorial 1: Basic tutorial that introduces assert subroutines and testrunner.
Tutorial 2: Tutorial that introduces testcases and testrunner.