snp-lab-code/testlib/tests/tests.c

/* ----------------------------------------------------------------------------
 * --  _____       ______  _____                                              -
 * -- |_   _|     |  ____|/ ____|                                             -
 * --   | |  _ __ | |__  | (___    Institute of Embedded Systems              -
 * --   | | | '_ \|  __|  \___ \   Zuercher Hochschule Winterthur             -
 * --  _| |_| | | | |____ ____) |  (University of Applied Sciences)           -
 * -- |_____|_| |_|______|_____/   8401 Winterthur, Switzerland               -
 * ----------------------------------------------------------------------------
 */
/**
 * @file
 * @brief Test suite for the given package.
 */
#include <stdio.h>
#include <stdlib.h>
#include "CUnit/Basic.h"
#include "test_utils.h"

#ifndef TARGET // must be given by the make file --> see test target
#error missing TARGET define
#endif

/// @brief The name of the STDOUT text file.
#define OUTFILE "stdout.txt"
/// @brief The name of the STDERR text file.
#define ERRFILE "stderr.txt"
/// @brief Some test output file
#define EMPTYFILE             "EmptyFile.txt"
/// @brief Some test output file
#define NONEMPTYFILE          "NonEmptyFile.txt"
/// @brief Some test output file
#define NONEMPTYFILE_NONLEND  "NonEmptyFileNoNlEnd.txt"

// setup & teardown
static int setup(void)
{
    remove_file_if_exists(OUTFILE);
    remove_file_if_exists(ERRFILE);
    remove_file_if_exists(EMPTYFILE);
    remove_file_if_exists(NONEMPTYFILE);
    remove_file_if_exists(NONEMPTYFILE_NONLEND);
    // do nothing
    return 0; // success
}
static int teardown(void)
{
    // do nothing
    return 0; // success
}


// tests
static void test_remove_file_that_exists(void)
{
    // ** arrange **

    // create a file
    FILE *file = fopen(OUTFILE, "w");
    CU_ASSERT_PTR_NOT_NULL(file);
    CU_ASSERT_EQUAL(fclose(file), 0);
    errno = 0;

    // ** act **
    remove_file_if_exists(OUTFILE);

    // ** assert **

    // make sure the file is removed
    CU_ASSERT_EQUAL(errno, 0);
    file = fopen(OUTFILE, "r");
    CU_ASSERT_TRUE(!file && errno == ENOENT);
    // cleanup gracefully
    if (file) CU_ASSERT_EQUAL(fclose(file), 0);
    errno = 0;
}
static void test_remove_file_that_does_not_exist(void)
{
    // ** arrange **
    remove_file_if_exists(OUTFILE);
    // the file is now supposed to not exist any more --> see test_remove_file_that_exists test result

    // ** act **

    // call with a not existing file
    remove_file_if_exists(OUTFILE);
    // must not fail in any internal assertion

    // ** assert **

    // make sure the file is removed
    CU_ASSERT_EQUAL(errno, 0);
    FILE *file = fopen(OUTFILE, "r");
    CU_ASSERT_TRUE(!file && errno == ENOENT);
    // cleanup gracefully
    if (file) CU_ASSERT_EQUAL(fclose(file), 0);
    errno = 0;
}

static void test_assert_lines_empty_file(void)
{
    // ** arrange **

    // empty file
    remove_file_if_exists(EMPTYFILE);
    FILE *file = fopen(EMPTYFILE, "w");
    CU_ASSERT_PTR_NOT_NULL_FATAL(file);
    CU_ASSERT_EQUAL(fclose(file), 0);
    const char *lines[] = {};

    // ** act **
    assert_lines(EMPTYFILE, lines, sizeof(lines)/sizeof(*lines));

    // ** assert **

    // no assertions should have happened within assert_lines(...)
}
static void test_assert_lines_non_empty_file(void)
{
    // ** arrange **

    // reference file
    remove_file_if_exists(NONEMPTYFILE);
    FILE *file = fopen(NONEMPTYFILE, "w");
    CU_ASSERT_PTR_NOT_NULL_FATAL(file);
    CU_ASSERT_EQUAL(fprintf(file, "LINE1\n"), 6);
    CU_ASSERT_EQUAL(fprintf(file, "LINE2\n"), 6);
    CU_ASSERT_EQUAL(fclose(file), 0);
    const char *lines[] = { "LINE1\n", "LINE2\n"};

    // ** act **
    assert_lines(NONEMPTYFILE, lines, sizeof(lines)/sizeof(*lines));

    // ** assert **

    // no assertions should have happened within assert_lines(...)
}
static void test_assert_lines_no_newline_at_the_end(void)
{
    // ** arrange **

    // reference file
    remove_file_if_exists(NONEMPTYFILE_NONLEND);
    FILE *file = fopen(NONEMPTYFILE_NONLEND, "w");
    CU_ASSERT_PTR_NOT_NULL_FATAL(file);
    CU_ASSERT_EQUAL(fprintf(file, "LINE1\n"), 6);
    CU_ASSERT_EQUAL(fprintf(file, "LINE2"), 5);
    CU_ASSERT_EQUAL(fclose(file), 0);
    const char *lines[] = { "LINE1\n", "LINE2"};

    // ** act **
    assert_lines(NONEMPTYFILE_NONLEND, lines, sizeof(lines)/sizeof(*lines));

    // ** assert **

    // no assertions should have happened within assert_lines(...)
}

/**
 * @brief Registers and runs the tests.
 */
int main(void)
{
    TestMainBasic("PROGC Test Lib", setup, teardown
                  , test_remove_file_that_exists
                  , test_remove_file_that_does_not_exist
                  , test_assert_lines_empty_file
                  , test_assert_lines_non_empty_file
                  , test_assert_lines_no_newline_at_the_end
                  );
}