chiark / gitweb /
f026f4bbe6a99c3622fe752f779bb7759a3231dc
[mLib] / testrig.h
1 /* -*-c-*-
2  *
3  * $Id: testrig.h,v 1.4 1999/07/06 19:15:28 mdw Exp $
4  *
5  * Generic test driver
6  *
7  * (c) 1998 Straylight/Edgeware
8  */
9
10 /*----- Licensing notice --------------------------------------------------* 
11  *
12  * This file is part of the mLib utilities library.
13  *
14  * mLib is free software; you can redistribute it and/or modify
15  * it under the terms of the GNU Library General Public License as
16  * published by the Free Software Foundation; either version 2 of the
17  * License, or (at your option) any later version.
18  * 
19  * mLib is distributed in the hope that it will be useful,
20  * but WITHOUT ANY WARRANTY; without even the implied warranty of
21  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
22  * GNU Library General Public License for more details.
23  * 
24  * You should have received a copy of the GNU Library General Public
25  * License along with mLib; if not, write to the Free
26  * Software Foundation, Inc., 59 Temple Place - Suite 330, Boston,
27  * MA 02111-1307, USA.
28  */
29
30 /*----- Revision history --------------------------------------------------* 
31  *
32  * $Log: testrig.h,v $
33  * Revision 1.4  1999/07/06 19:15:28  mdw
34  * Comment out argument in structure definition.
35  *
36  * Revision 1.3  1999/05/06 19:51:35  mdw
37  * Reformatted the LGPL notice a little bit.
38  *
39  * Revision 1.2  1999/05/05 18:50:31  mdw
40  * Change licensing conditions to LGPL.
41  *
42  * Revision 1.1.1.1  1998/06/17 23:44:42  mdw
43  * Initial version of mLib
44  *
45  */
46
47 #ifndef TESTER_H
48 #define TESTER_H
49
50 #ifdef __cplusplus
51   extern "C" {
52 #endif
53
54 /*----- Header files ------------------------------------------------------*/
55
56 #include <stddef.h>
57
58 #include "dstr.h"
59
60 /*----- Magical numbers ---------------------------------------------------*/
61
62 #define TEST_FIELDMAX 16                /* Maximum fields in a line */
63
64 /*----- Data structures ---------------------------------------------------*/
65
66 /* --- Test field definition --- */
67
68 typedef struct test_type {
69   void (*cvt)(const char *buf, dstr *d); /* Conversion function */
70   void (*dump)(dstr *d, FILE *fp);      /* Dump function */
71 } test_type;
72
73 /* --- Test chunk definition --- */
74
75 typedef struct test_chunk {
76   const char *name;                     /* Name of this chunk */
77   int (*test)(dstr /*dv*/[]);           /* Test verification function */
78   test_type *f[TEST_FIELDMAX];          /* Field definitions */
79 } test_chunk;
80
81 /*----- Predefined data types ---------------------------------------------*/
82
83 extern test_type type_hex;
84 extern test_type type_string;
85 extern test_type type_int;
86
87 /*----- Functions provided ------------------------------------------------*/
88
89 /* --- @test_run@ --- *
90  *
91  * Arguments:   @int argc@ = number of command line arguments
92  *              @char *argv[]@ = pointer to command line arguments
93  *              @const test_chunk chunk[]@ = pointer to chunk definitions
94  *              @const char *def@ = name of default test vector file
95  *
96  * Returns:     Doesn't.
97  *
98  * Use:         Runs a set of test vectors to ensure that a component is
99  *              working properly.
100  */
101
102 extern void test_run(int /*argc*/, char */*argv*/[],
103                      const test_chunk /*chunk*/[],
104                      const char */*def*/);
105
106 /*----- That's all, folks -------------------------------------------------*/
107
108 #ifdef __cplusplus
109   }
110 #endif
111
112 #endif