chiark - git - mdw - mLib/blob - testrig.h

   1 /* -*-c-*-
   2  *
   3  * $Id: testrig.h,v 1.1 1998/06/17 23:44:42 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 General Public License as published by
  16  * the Free Software Foundation; either version 2 of the License, or
  17  * (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 General Public License for more details.
  23  *
  24  * You should have received a copy of the GNU General Public License
  25  * along with mLib; if not, write to the Free Software Foundation,
  26  * Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
  27  */
  28
  29 /*----- Revision history --------------------------------------------------*
  30  *
  31  * $Log: testrig.h,v $
  32  * Revision 1.1  1998/06/17 23:44:42  mdw
  33  * Initial revision
  34  *
  35  */
  36
  37 #ifndef TESTER_H
  38 #define TESTER_H
  39
  40 #ifdef __cplusplus
  41   extern "C" {
  42 #endif
  43
  44 /*----- Header files ------------------------------------------------------*/
  45
  46 #include <stddef.h>
  47
  48 #include "dstr.h"
  49
  50 /*----- Magical numbers ---------------------------------------------------*/
  51
  52 #define TEST_FIELDMAX 16                /* Maximum fields in a line */
  53
  54 /*----- Data structures ---------------------------------------------------*/
  55
  56 /* --- Test field definition --- */
  57
  58 typedef struct test_type {
  59   void (*cvt)(const char *buf, dstr *d); /* Conversion function */
  60   void (*dump)(dstr *d, FILE *fp);      /* Dump function */
  61 } test_type;
  62
  63 /* --- Test chunk definition --- */
  64
  65 typedef struct test_chunk {
  66   const char *name;                     /* Name of this chunk */
  67   int (*test)(dstr dv[]);               /* Test verification function */
  68   test_type *f[TEST_FIELDMAX];          /* Field definitions */
  69 } test_chunk;
  70
  71 /*----- Predefined data types ---------------------------------------------*/
  72
  73 extern test_type type_hex;
  74 extern test_type type_string;
  75 extern test_type type_int;
  76
  77 /*----- Functions provided ------------------------------------------------*/
  78
  79 /* --- @test_run@ --- *
  80  *
  81  * Arguments:   @int argc@ = number of command line arguments
  82  *              @char *argv[]@ = pointer to command line arguments
  83  *              @const test_chunk chunk[]@ = pointer to chunk definitions
  84  *              @const char *def@ = name of default test vector file
  85  *
  86  * Returns:     Doesn't.
  87  *
  88  * Use:         Runs a set of test vectors to ensure that a component is
  89  *              working properly.
  90  */
  91
  92 extern void test_run(int /*argc*/, char */*argv*/[],
  93                      const test_chunk /*chunk*/[],
  94                      const char */*def*/);
  95
  96 /*----- That's all, folks -------------------------------------------------*/
  97
  98 #ifdef __cplusplus
  99   }
 100 #endif
 101
 102 #endif