AUnit Cookbook

Ada Unit Testing Framework

Version 27.0w

Date: Mar 18, 2026

AdaCore

Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.3 or any later version published by the Free Software Foundation; with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the license is included in the section entitled GNU Free Documentation License.

• 1. Introduction
  • 1.1. What’s new in AUnit 3
  • 1.2. Typographic conventions
  • 1.3. Examples
  • 1.4. Note about limited run-time libraries
  • 1.5. Thanks
• 2. Overview
• 3. Test Case
  • 3.1. AUnit.Options
  • 3.2. AUnit.Test_Info
  • 3.3. AUnit.Simple_Test_Cases
  • 3.4. AUnit.Test_Cases
  • 3.5. AUnit.Test_Caller
• 4. Fixture
• 5. Suite
  • 5.1. Creating a Test Suite
  • 5.2. Composition of Suites
• 6. Reporting
  • 6.1. Test Examples
  • 6.2. Text output
  • 6.3. GNATtest output
  • 6.4. JUnit XML output
    • 6.4.1. <testsuites>
    • 6.4.2. <testsuite>
    • 6.4.3. <testcase>
    • 6.4.4. <failure>
    • 6.4.5. <error>
  • 6.5. XML output
    • 6.5.1. <TestRun>
    • 6.5.2. <Statistics>
    • 6.5.3. <SuccessfulTests>
    • 6.5.4. <FailedTests>
    • 6.5.5. <Test>
    • 6.5.6. <Location>
    • 6.5.7. <Exception>
  • 6.6. XML output (deprecated)
• 7. Test Organization
  • 7.1. General considerations
  • 7.2. OOP considerations
    • 7.2.1. Using AUnit.Test_Fixtures
    • 7.2.2. Using AUnit.Test_Cases
  • 7.3. Testing generic units
• 8. Using AUnit with Restricted Run-Time Libraries
• 9. Installation and Use
  • 9.1. Note on gprbuild
  • 9.2. Support for other platforms/run-times
  • 9.3. Installing AUnit
  • 9.4. Installed files
• 10. GNAT Studio Support

• GNU Free Documentation License