aboutsummaryrefslogtreecommitdiff
path: root/tests/tuktest.h
diff options
context:
space:
mode:
Diffstat (limited to 'tests/tuktest.h')
-rw-r--r--tests/tuktest.h52
1 files changed, 24 insertions, 28 deletions
diff --git a/tests/tuktest.h b/tests/tuktest.h
index b8c0c142..1e45e1e4 100644
--- a/tests/tuktest.h
+++ b/tests/tuktest.h
@@ -2,7 +2,7 @@
//
/// \file tuktest.h
/// \brief Helper macros for writing simple test programs
-/// \version 2022-06-02
+/// \version 2022-06-16
///
/// Some inspiration was taken from STest by Keith Nicholas.
///
@@ -88,12 +88,17 @@
/// (The assert_CONDITION() macros depend on setup code in tuktest_run()
/// and other use results in undefined behavior.)
///
-/// - The tuktest_* functions and macros macros must not be used in
-/// the tests called via tuktest_run()!
+/// - tuktest_start(), tuktest_early_skip, tuktest_error(), tuktest_run(),
+/// and tuktest_end() must not be used in the tests called via
+/// tuktest_run()! (tuktest_end() is called more freely internally
+/// by this file but such use isn't part of the API.)
///
-/// - file_from_* functions and macros may be used anywhere after
+/// - tuktest_malloc(), tuktest_free(), tuktest_file_from_srcdir(), and
+/// tuktest_file_from_builddir() can be used everywhere after
/// tuktest_start() has been called.
///
+/// - Everything else is for internal use only.
+///
/// Footnotes:
///
/// [1] As of 2022-06-02:
@@ -605,7 +610,7 @@ tuktest_run_test(void (*testfunc)(void), const char *testfunc_str)
}
-// Maximum allowed file size in file_from_* macros and functions.
+// Maximum allowed file size in tuktest_file_from_* macros and functions.
#ifndef TUKTEST_FILE_SIZE_MAX
# define TUKTEST_FILE_SIZE_MAX (64L << 20)
#endif
@@ -613,7 +618,7 @@ tuktest_run_test(void (*testfunc)(void), const char *testfunc_str)
/// Allocates memory and reads the specified file into a buffer.
/// If the environment variable srcdir is set, it will be prefixed
/// to the filename. Otherwise the filename is used as is (and so
-/// the behavior is identical to file_from_builddir() below).
+/// the behavior is identical to tuktest_file_from_builddir() below).
///
/// On success the a pointer to malloc'ed memory is returned.
/// The size of the allocation and the file is stored in *size.
@@ -627,16 +632,17 @@ tuktest_run_test(void (*testfunc)(void), const char *testfunc_str)
/// This function can be called either from outside the tests (like in main())
/// or from tests run via tuktest_run(). Remember to free() the memory to
/// keep Valgrind happy.
-#define file_from_srcdir(filename, sizeptr) \
- file_from_x(getenv("srcdir"), filename, sizeptr, __FILE__, __LINE__)
+#define tuktest_file_from_srcdir(filename, sizeptr) \
+ tuktest_file_from_x(getenv("srcdir"), filename, sizeptr, \
+ __FILE__, __LINE__)
-/// Like file_from_srcdir except this reads from the current directory.
-#define file_from_builddir(filename, sizeptr) \
- file_from_x(NULL, filename, sizeptr, __FILE__, __LINE__)
+/// Like tuktest_file_from_srcdir except this reads from the current directory.
+#define tuktest_file_from_builddir(filename, sizeptr) \
+ tuktest_file_from_x(NULL, filename, sizeptr, __FILE__, __LINE__)
// Internal helper for the macros above.
static void *
-file_from_x(const char *prefix, const char *filename, size_t *size,
+tuktest_file_from_x(const char *prefix, const char *filename, size_t *size,
const char *prog_filename, unsigned prog_line)
{
// If needed: buffer for holding prefix + '/' + filename + '\0'.
@@ -674,11 +680,8 @@ file_from_x(const char *prefix, const char *filename, size_t *size,
const size_t alloc_name_size
= prefix_len + 1 + filename_len + 1;
- alloc_name = malloc(alloc_name_size);
- if (alloc_name == NULL) {
- error_msg = "Memory allocation failed (alloc_name)";
- goto error;
- }
+ alloc_name = tuktest_malloc_impl(alloc_name_size,
+ prog_filename, prog_line);
memcpy(alloc_name, prefix, prefix_len);
alloc_name[prefix_len] = '/';
@@ -726,11 +729,7 @@ file_from_x(const char *prefix, const char *filename, size_t *size,
*size = (size_t)end;
rewind(f);
- buf = malloc(*size);
- if (buf == NULL) {
- error_msg = "Memory allocation failed (buf)";
- goto error;
- }
+ buf = tuktest_malloc_impl(*size, prog_filename, prog_line);
const size_t amount = fread(buf, 1, *size, f);
if (ferror(f)) {
@@ -750,7 +749,7 @@ file_from_x(const char *prefix, const char *filename, size_t *size,
goto error;
}
- free(alloc_name);
+ tuktest_free(alloc_name);
return buf;
error:
@@ -760,12 +759,9 @@ error:
tuktest_print_result_prefix(TUKTEST_ERROR, prog_filename, prog_line);
if (filename == NULL)
- printf("file_from_x: %s\n", error_msg);
+ printf("tuktest_file_from_x: %s\n", error_msg);
else
- printf("file_from_x: %s: %s\n", filename, error_msg);
-
- free(buf);
- free(alloc_name);
+ printf("tuktest_file_from_x: %s: %s\n", filename, error_msg);
++tuktest_stats[TUKTEST_ERROR];
exit(tuktest_end());