5 * (c) 1998 Straylight/Edgeware
8 /*----- Licensing notice --------------------------------------------------*
10 * This file is part of the mLib utilities library.
12 * mLib is free software; you can redistribute it and/or modify
13 * it under the terms of the GNU Library General Public License as
14 * published by the Free Software Foundation; either version 2 of the
15 * License, or (at your option) any later version.
17 * mLib is distributed in the hope that it will be useful,
18 * but WITHOUT ANY WARRANTY; without even the implied warranty of
19 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
20 * GNU Library General Public License for more details.
22 * You should have received a copy of the GNU Library General Public
23 * License along with mLib; if not, write to the Free
24 * Software Foundation, Inc., 59 Temple Place - Suite 330, Boston,
35 /*----- Header files ------------------------------------------------------*/
51 /*----- Magical numbers ---------------------------------------------------*/
53 #define TEST_FIELDMAX 16 /* Maximum fields in a line */
55 /*----- Data structures ---------------------------------------------------*/
57 typedef struct test_results {
58 unsigned tests, failed;
61 /* --- Test field definition --- */
63 typedef struct test_type {
64 void (*cvt)(const char *buf, dstr *d); /* Conversion function */
65 void (*dump)(dstr *d, FILE *fp); /* Dump function */
68 /* --- Test chunk definition --- */
70 typedef struct test_chunk {
71 const char *name; /* Name of this chunk */
72 int (*test)(dstr /*dv*/[]); /* Test verification function */
73 const test_type *f[TEST_FIELDMAX]; /* Field definitions */
76 typedef struct test_suite {
77 const char *name; /* Name of this suite */
78 const test_chunk *chunks; /* Chunks contained in this suite */
81 /*----- Predefined data types ---------------------------------------------*/
83 extern const test_type type_hex;
84 extern const test_type type_string;
85 extern const test_type type_int;
86 extern const test_type type_long;
87 extern const test_type type_ulong;
88 extern const test_type type_uint32;
90 /*----- Functions provided ------------------------------------------------*/
92 /* --- @test_do@ --- *
94 * Arguments: @const test_suite suites[]@ = pointer to suite definitions
95 * @FILE *fp@ = test vector file, ready opened
96 * @test_results *results@ = where to put results
98 * Returns: Negative if something bad happened, or the number of
101 * Use: Runs a collection of tests against a file of test vectors and
102 * reports the results.
105 extern int test_do(const test_suite /*suite*/[],
107 test_results */*results*/);
109 /* --- @test_run@ --- *
111 * Arguments: @int argc@ = number of command line arguments
112 * @char *argv[]@ = pointer to command line arguments
113 * @const test_chunk chunk[]@ = pointer to chunk definitions
114 * @const char *def@ = name of default test vector file
118 * Use: Runs a set of test vectors to ensure that a component is
123 test_run(int /*argc*/, char */*argv*/[],
124 const test_chunk /*chunk*/[],
125 const char */*def*/);
127 /*----- That's all, folks -------------------------------------------------*/