AceUnit Glossary

Products

AceUnit

Advanced C and Embedded Unit. A framework for Unit Testing in C, based on the ideas of JUnit 4.x and the experience with usage of CUnit and EmbUnit. Supports Unit Testing on embedded systems as well as in "normal" development.
URL: http://aceunit.sourceforge.net/

CUnit

A framework for Unit Testing in C, based on the ideas of JUnit 3.x. Not suited for embedded systems. (E.g. Strings as messages)
URL: http://cunit.sourceforge.net/

EmbUnit

A framework for Unit Testing in C, based on the ideas of JUnit 3.x and CUnit. Only suited for embedded systems. (E.g. ints as messages)
URL: http://embunit.sourceforge.net/

Check

A framework for Unit Testing in C, based on the ideas of JUnit 3.x. Well suited for POSIX environments (takes advantage of fork()).

JUnit

A framework for Unit Testing in Java.
URL: http://junit.sourceforge.net/

Terms

After

After is a Method in a Fixture that will be executed after each Test Case independently of whether or not that Test Case was successful. It is part of the Test Case Setup.

AfterClass

AfterClass is a Method in a Fixture that will be executed once for that Fixture after the last Test Case. It is part of the Fixture Setup.

Before

Before is a Method in a Fixture that will be executed before each Test Case. It is part of the Test Case Setup.

BeforeClass

BeforeClass is a Method in a Fixture that will be executed once for that Fixture before the first Test Case. It is part of the Fixture Setup.

Class

In this environment usually used as a synonym for Fixture.

Fixture

Logic View: A Fixture (or "Class") is a Suite that contains Test Cases.
Physical View: A Fixture is a C Source that contains at least one method (function) annotated with A_Test.
Besides Test Cases Fixtures can also contain a Test Case Setup and a Fixture Setup.

Fixture Setup

Logic View: The Fixture Setup is a preparation / cleanup for a fixture that is executed once for the fixture.
Physical View: The Fixture Setup preparation steps are Methods annotated with A_BeforeClass. The Fixture Setup cleanup steps are Methods annotated with A_AfterClass.

Generator

The Generator is a tool which scans logic Suites and generates all physical information required for the Runner to run the Suites.

Logger

A Logger is an implementation of a C interface which will be called by the Runner upon certain events which are:

• Runner started
• Suite started.
• Fixture started.
• Test Case started.
• Test Case failed.
• Test Case ended.
• Fixture ended.
• Suite ended.
• Runner ended.

Loggers are configurable and needn't necessary implement all of these functions.

Method

Synonym for function. The devs of AceUnit design with OO in their minds. Thus they tend to speak of methods instead of functions. Technically, that's just a different term with a different point of view / perspective.

Runner

The Runner performs one or more Suites. The Suites will be traversed recursively to their Fixtures. Each fixture will be executed in the following order:

1. Perform all BeforeClass Methods.
2. For each Test Case
   1. Perform all Before Methods.
   2. Perform the Test Case Method.
   3. Perform all After Methods.
3. Perform all AfterClass Methods.

Within above order, the Methods will always be executed in the same order as they were found by the Generator in the C Source.

Suite

Logic View: A Suite is an indirect collection of test cases that contains Suites.
Physical View: A Suite is either
Explanation: A Fixture is a special kind of Suite. A Suite that is not a Fixture will only contain other Suites. A Suite that is a Fixture will only contain Test Cases. Thus a Suite contains Test Cases, either directly because the Suite is a Fixture or indirectly because the Suite contains other Suites.

Test Case

Logic View: A Test Case is a Method in a Fixture that when executed performs a test.
Physical View: A Test Case is a function annotated with A_Test.

Test Case Setup

Logic View: The Test Case Setup is a prepartion / cleanup for all test cases of a fixture that is executed before / after each test case of that fixture.
Physical View: The Test Case Setup preparation steps are Methods annotated with A_Before. The Test Case Setup cleanup steps are Methods annotated with A_After.
Note: This corresponds to setUp() / tearDown() in older frameworks.