/usr/share/ada/adainclude/aunit/aunit-assertions.ads is in libaunit3.7.1-dev 3.7.1-2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 | ------------------------------------------------------------------------------
-- --
-- GNAT COMPILER COMPONENTS --
-- --
-- A U N I T . A S S E R T I O N S --
-- --
-- S p e c --
-- --
-- --
-- Copyright (C) 2000-2011, AdaCore --
-- --
-- GNAT is free software; you can redistribute it and/or modify it under --
-- terms of the GNU General Public License as published by the Free Soft- --
-- ware Foundation; either version 3, or (at your option) any later ver- --
-- sion. GNAT is distributed in the hope that it will be useful, but WITH- --
-- OUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY --
-- or FITNESS FOR A PARTICULAR PURPOSE. --
-- --
-- --
-- --
-- --
-- --
-- You should have received a copy of the GNU General Public License and --
-- a copy of the GCC Runtime Library Exception along with this program; --
-- see the files COPYING3 and COPYING.RUNTIME respectively. If not, see --
-- <http://www.gnu.org/licenses/>. --
-- --
-- GNAT is maintained by AdaCore (http://www.adacore.com) --
-- --
------------------------------------------------------------------------------
-- <description>
-- This package provides the Assert methods used by the user to verify test
-- results.
-- Those methods are used to report errors within AUnit tests when a result
-- does not match an expected value.
-- </description>
with GNAT.Source_Info;
with AUnit.Tests;
with AUnit.Test_Results;
with Ada_Containers.AUnit_Lists;
package AUnit.Assertions is
type Throwing_Exception_Proc is access procedure;
procedure Assert
(Condition : Boolean;
Message : String;
Source : String := GNAT.Source_Info.File;
Line : Natural := GNAT.Source_Info.Line);
-- Test "Condition" and record "Message" if false.
-- If the condition is false, an exception is then raised and the running
-- test is aborted.
function Assert
(Condition : Boolean;
Message : String;
Source : String := GNAT.Source_Info.File;
Line : Natural := GNAT.Source_Info.Line) return Boolean;
-- Functional version to allow the calling routine to decide whether to
-- continue or abandon the execution.
-----------------------
-- Simple assertions --
-----------------------
-- The following subprograms provide specialized version of Assert
-- to compare simple types. In case of failure, the error message will
-- contain both the expected and actual values.
procedure Assert
(Actual : String;
Expected : String;
Message : String;
Source : String := GNAT.Source_Info.File;
Line : Natural := GNAT.Source_Info.Line);
-- Specialized versions of Assert, they call the general version that
-- takes a Condition as a parameter
procedure Assert_Exception
(Proc : Throwing_Exception_Proc;
Message : String;
Source : String := GNAT.Source_Info.File;
Line : Natural := GNAT.Source_Info.Line);
-- Test that Proc throws an exception and record "Message" if not.
------------------------------------------------------------
-- The following declarations are for internal use only --
------------------------------------------------------------
Assertion_Error : exception;
-- For run-time libraries that support exception handling, raised when an
-- assertion fails in order to abandon execution of a test routine.
type Test is abstract new AUnit.Tests.Test with private;
-- Test is used as root type for all Test cases, but also for Test fixtures
-- This allows easy access to all Assert procedures from user tests.
type Test_Access is access all Test'Class;
procedure Init_Test (T : in out Test);
-- Init a new test
procedure Clear_Failures (T : Test);
-- Clear all failures related to T
function Has_Failures (T : Test) return Boolean;
-- The number of failures reported by test
type Failure_Iter is private;
-- Iterator used to retrieve failures.
function First_Failure (T : Test) return Failure_Iter;
function Has_Failure (I : Failure_Iter) return Boolean;
function Get_Failure
(I : Failure_Iter) return AUnit.Test_Results.Test_Failure;
procedure Next (I : in out Failure_Iter);
-- Failures list handling
-- The following is used for the non-dispatching Assert methods.
-- This uses global variables, and thus is incompatible with multitasking.
function Current_Test return Test_Access;
procedure Set_Current_Test (T : Test_Access);
procedure Copy_Id (From : Test'Class; To : in out Test'Class);
-- Copy From's Id to To so that failures reported via To are identified as
-- belonging to From.
private
use AUnit.Test_Results;
-- We can't set the results directly within the test as the result list is
-- limited and we don't want Test to be limited.
-- Instead, we initialize tests with a unique id that we use when putting
-- a new error in this global list.
type Test_Id is new Natural;
Null_Id : constant Test_Id := 0;
type Failure_Elt is record
Failure : Test_Failure;
Id : Test_Id := Null_Id;
end record;
package Failure_Lists is
new Ada_Containers.AUnit_Lists (Failure_Elt);
-- Container for failed assertion messages per routine
type Failure_Iter is new Failure_Lists.Cursor;
type Test is abstract new AUnit.Tests.Test with record
Id : Test_Id := Null_Id;
end record;
end AUnit.Assertions;
|