tests/version.c

   1 /*
   2  * This file is part of the libsigrok project.
   3  *
   4  * Copyright (C) 2013 Uwe Hermann <uwe@hermann-uwe.de>
   5  *
   6  * This program is free software; you can redistribute it and/or modify
   7  * it under the terms of the GNU General Public License as published by
   8  * the Free Software Foundation; either version 2 of the License, or
   9  * (at your option) any later version.
  10  *
  11  * This program is distributed in the hope that it will be useful,
  12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14  * GNU General Public License for more details.
  15  *
  16  * You should have received a copy of the GNU General Public License
  17  * along with this program; if not, see <http://www.gnu.org/licenses/>.
  18  */
  19
  20 #include <config.h>
  21 #include <stdlib.h>
  22 #include <check.h>
  23 #include <libsigrok/libsigrok.h>
  24 #include "lib.h"
  25
  26 /*
  27  * Check the version number API calls and macros.
  28  *
  29  * The numbers returned by the sr_*_version*get() calls must match the
  30  * respective SR_*_VERSION* macro values, must be >= 0, and must not be
  31  * unreasonably high (> 20), otherwise something is probably wrong.
  32  */
  33 START_TEST(test_version_numbers)
  34 {
  35         int ver;
  36
  37         ver = sr_package_version_major_get();
  38         fail_unless(ver == SR_PACKAGE_VERSION_MAJOR);
  39         fail_unless(ver >= 0 && ver <= 20);
  40         ver = sr_package_version_minor_get();
  41         fail_unless(ver == SR_PACKAGE_VERSION_MINOR);
  42         fail_unless(ver >= 0 && ver <= 20);
  43         ver = sr_package_version_micro_get();
  44         fail_unless(ver == SR_PACKAGE_VERSION_MICRO);
  45         fail_unless(ver >= 0 && ver <= 20);
  46
  47         ver = sr_lib_version_current_get();
  48         fail_unless(ver == SR_LIB_VERSION_CURRENT);
  49         fail_unless(ver >= 0 && ver <= 20);
  50         ver = sr_lib_version_revision_get();
  51         fail_unless(ver == SR_LIB_VERSION_REVISION);
  52         fail_unless(ver >= 0 && ver <= 20);
  53         ver = sr_lib_version_age_get();
  54         fail_unless(ver == SR_LIB_VERSION_AGE);
  55         fail_unless(ver >= 0 && ver <= 20);
  56 }
  57 END_TEST
  58
  59 /*
  60  * Check the version number API calls and macros.
  61  *
  62  * The string representations of the package/lib version must neither be
  63  * NULL nor empty, and the length shall be within an expected range.
  64  *
  65  * The lower limit assumes:
  66  * - A version text consists of three parts (major, minor, micro),
  67  *   like "0.1.0".
  68  * - Three numbers with at least one digit, and their separators,
  69  *   result in a minimum length of 5.
  70  *
  71  * The upper limit assumes:
  72  * - The major, minor, and micro parts won't contain more than two
  73  *   digits each (this is an arbitrary choice).
  74  * - An optional "-git-<hash>" suffix might follow. While git(1)
  75  *   defaults to 7 hex digits for abbreviated hashes, projects of
  76  *   larger scale might recommend to use more digits to avoid
  77  *   potential ambiguity (e.g. Linux recommends core.abbrev=12).
  78  *   Again, this is an arbitrary choice.
  79  */
  80 START_TEST(test_version_strings)
  81 {
  82         const char *str;
  83         const size_t len_min = 5;
  84         const size_t len_max = 2 + 1 + 2 + 1 + 2 + 5 + 12;
  85
  86         str = sr_package_version_string_get();
  87         fail_unless(str != NULL);
  88         fail_unless(strlen(str) >= len_min);
  89         fail_unless(strlen(str) <= len_max);
  90         str = sr_lib_version_string_get();
  91         fail_unless(str != NULL);
  92         fail_unless(strlen(str) >= len_min);
  93         fail_unless(strlen(str) <= len_max);
  94 }
  95 END_TEST
  96
  97 Suite *suite_version(void)
  98 {
  99         Suite *s;
 100         TCase *tc;
 101
 102         s = suite_create("version");
 103
 104         tc = tcase_create("version");
 105         tcase_add_test(tc, test_version_numbers);
 106         tcase_add_test(tc, test_version_strings);
 107         suite_add_tcase(s, tc);
 108
 109         return s;
 110 }