### Navigation

- index
- Ada modules |
- next |
- previous |
- Ahven 2.2 documentation »
- API Documentation for Ahven »

# `Ahven.Framework` – Package

## Types

### Test_Count_Type

    type Test_Count_Type is new Natural;

Type for the test count. This effectively limits the amount tests to whatever Natural is.

Although, in practice when adding tests the limit is not checked.

### Test_Duration

    subtype Test_Duration is Duration range 0.0 .. Three_Hours;

Subtype for the test timeouts. Limited to 3 hours, which should be enough for unit tests. Timeout value 0.0 means infinite time.

### Test

    type Test is abstract new Ada.Finalization.Controlled with null record;

### Test_Class_Access

    type Test_Class_Access is access all Test'Class;

An access type for Test’Class.

### Test_Case

    type Test_Case is abstract new Test with private;

The base type for other test cases.

### Object_Test_Routine_Access

    type Object_Test_Routine_Access is
      access procedure (T : in out Test_Case'Class);

A pointer to a test routine which takes Test_Case’Class object as an argument.

For this kind of test routines, the framework will call Set_Up and Tear_Down routines before and after test routine execution.

### Simple_Test_Routine_Access

    type Simple_Test_Routine_Access is access procedure;

A pointer to a test routine which does not take arguments.

### Test_Suite

    type Test_Suite is new Test with private;

A collection of Tests.

You can either fill a Test_Suite object with Test_Case objects or nest multiple Test_Suite objects. You can even mix Test_Case and Test_Suite objects, if necessary.

### Test_Suite_Access

    type Test_Suite_Access is access all Test_Suite;

An access type for Test_Suite.

## Procedures and functions

### Set_Up

    procedure Set_Up (T : in out Test);

### Tear_Down

    procedure Tear_Down (T : in out Test);

Tear_Down is called after the test procedure is executed.

### Get_Name

    function Get_Name (T : Test) return String is abstract;

### Run

    procedure Run (T         : in out Test;
                   Listener  : in out Listeners.Result_Listener'Class);

### Run

    procedure Run (T         : in out Test;
                   Listener  : in out Listeners.Result_Listener'Class;
                   Timeout   :        Test_Duration)
      is abstract;

### Run

    procedure Run (T         : in out Test;
                   Test_Name :        String;
                   Listener  : in out Listeners.Result_Listener'Class);

Run the test with given name and place the test result to Result. Notice: If multiple tests have same name this might call all of them.

### Run

    procedure Run (T         : in out Test;
                   Test_Name :        String;
                   Listener  : in out Listeners.Result_Listener'Class;
                   Timeout   :        Test_Duration)
      is abstract;

Run the test with given name and place the test result to Result. Notice: If multiple tests have same name this might call all of them. Timeout specifies maximum execution time for the tests.

> param T: | The test object to run.
> param Test_Name:
> | The name of the test which will be run.
> param Listener: | The listener which will be called during the test execution.
> param Timeout: | Time limit for the test.

### Test_Count

    function Test_Count (T : Test) return Test_Count_Type is abstract;

Return the amount of tests (test routines) which will be executed when the Run (T) procedure is called.

### Test_Count

    function Test_Count (T : Test; Test_Name : String)
      return Test_Count_Type is abstract;

Return the amount of tests (test routines) which will be executed when the Run (T, Test_Name) procedure is called.

### Execute

    procedure Execute (T        : in out Test'Class;
                       Listener : in out Listeners.Result_Listener'Class);

Call Test class’ Run method and place the test outcome to Result. The procedure calls Start_Test of every listener before calling the Run procedure and End_Test after calling the Run procedure.

### Execute

    procedure Execute (T        : in out Test'Class;
                       Listener : in out Listeners.Result_Listener'Class;
                       Timeout  :        Test_Duration);

Call Test class’ Run method and place the test outcome to Result. The procedure calls Start_Test of every listener before calling the Run procedure and End_Test after calling the Run procedure. Timeout specifies the maximum execution time for a test.

### Execute

    procedure Execute (T         : in out Test'Class;
                       Test_Name :        String;
                       Listener  : in out Listeners.Result_Listener'Class);

Same as Execute above, but call the Run procedure which takes Test_Name parameter.

### Execute

    procedure Execute (T         : in out Test'Class;
                       Test_Name :        String;
                       Listener  : in out Listeners.Result_Listener'Class;
                       Timeout  :        Test_Duration);

Same as Execute above, but call the Run procedure which takes Test_Name parameter. Timeout specifies the maximum execution time for a test.

### Get_Name

    function Get_Name (T : Test_Case) return String;

Return the name of the test case.

### Run

    procedure Run (T        : in out Test_Case;
                   Listener : in out Listeners.Result_Listener'Class);

Run Test_Case’s test routines.

### Run

    procedure Run (T        : in out Test_Case;
                   Listener : in out Listeners.Result_Listener'Class;
                   Timeout  :        Test_Duration);

Run Test_Case’s test routines with timeout value.

### Run

    procedure Run (T         : in out Test_Case;
                   Test_Name :        String;
                   Listener  : in out Listeners.Result_Listener'Class);

Run Test_Case’s test routine which matches to the Name.

### Run

    procedure Run (T         : in out Test_Case;
                   Test_Name :        String;
                   Listener  : in out Listeners.Result_Listener'Class;
                   Timeout   :        Test_Duration);

Run Test_Case’s test routine which matches to the Name, with timeout value.

### Test_Count

    function Test_Count (T : Test_Case) return Test_Count_Type;

Implementation of Test_Count (T : Test).

### Test_Count

    function Test_Count (T : Test_Case; Test_Name : String)
      return Test_Count_Type;

Implementation of Test_Count (T : Test, Test_Name : String).

### Finalize

    procedure Finalize (T : in out Test_Case);

Finalize procedure of the Test_Case.

### Set_Name

    procedure Set_Name (T : in out Test_Case; Name : String);

Set Test_Case’s name.

### Add_Test_Routine

    procedure Add_Test_Routine (T       : in out Test_Case'Class;
                                Routine :        Object_Test_Routine_Access;
                                Name    :        String);

Register a test routine to the Test_Case object.

### Add_Test_Routine

    procedure Add_Test_Routine (T       : in out Test_Case'Class;
                                Routine :        Simple_Test_Routine_Access;
                                Name    :        String);

Register a simple test routine to the Test_Case.

### Create_Suite

    function Create_Suite (Suite_Name : String)
      return Test_Suite_Access;

Create a new Test_Suite. Caller must free the returned Test_Suite using Release_Suite.

### Create_Suite

    function Create_Suite (Suite_Name : String)
      return Test_Suite;

Create a new Test_Suite. The suite and its children are released automatically.

### Add_Test

    procedure Add_Test (Suite : in out Test_Suite; T : Test_Class_Access);

Add a Test to the suite. The suite frees the Test automatically when it is no longer needed.

### Add_Test

    procedure Add_Test (Suite : in out Test_Suite; T : Test_Suite_Access);

Add a Test suite to the suite. The suite frees the Test automatically when it is no longer needed.

### Add_Static_Test

    procedure Add_Static_Test
      (Suite : in out Test_Suite; T : Test'Class);

Add a Test to the suite. This procedure is meant for statically allocated Test_Case objects.

### Get_Name

    function Get_Name (T : Test_Suite) return String;

Return the name of Test_Suite.

### Run

    procedure Run (T        : in out Test_Suite;
                   Listener : in out Listeners.Result_Listener'Class);

Run Test_Suite’s Test_Cases.

### Run

    procedure Run (T        : in out Test_Suite;
                   Listener : in out Listeners.Result_Listener'Class;
                   Timeout  :        Test_Duration);

Run Test_Suite’s Test_Cases with timeout value.

### Run

    procedure Run (T         : in out Test_Suite;
                   Test_Name :        String;
                   Listener  : in out Listeners.Result_Listener'Class);

Run test suite’s child which matches to the given name.

### Run

    procedure Run (T         : in out Test_Suite;
                   Test_Name :        String;
                   Listener  : in out Listeners.Result_Listener'Class;
                   Timeout  :        Test_Duration);

Run test suite’s child which matches to the given name, with timeout value.

### Test_Count

    function Test_Count (T : Test_Suite) return Test_Count_Type;

Implementation of Test_Count (T : Test).

### Test_Count

    function Test_Count (T : Test_Suite; Test_Name : String)
      return Test_Count_Type;

Implementation of Test_Count (T : Test, Test_Name : String).

### Adjust

    procedure Adjust (T : in out Test_Suite);

Adjust procedure of Test_Suite. Handles the copying of the structure properly

### Finalize

    procedure Finalize (T : in out Test_Suite);

Finalize procedure of Test_Suite. Frees all added Tests.

### Release_Suite

    procedure Release_Suite (T : Test_Suite_Access);

Release the memory of Test_Suite. All added tests are released automatically.

### Navigation

- index
- Ada modules |
- next |
- previous |
- Ahven 2.2 documentation »
- API Documentation for Ahven »