SHTK_UNITTEST_ASSERT_... BSD Library Functions Manual SHTK_UNITTEST_ASSERT_...NAMEshtk_unittest_assert_file — Validates the contents of a file against
golden data
LIBRARY
shtk_import unittest
SYNOPSISshtk_unittest_assert_file golden_spec actual_file
DESCRIPTION
The shtk_unittest_assert_file function verifies that actual_file, which
must exist, matches some predefined contents specified by golden_spec.
The valid values for golden_spec are of the form:
empty
actual_file must be empty.
not-empty
actual_file must not be empty.
ignore
The contents of actual_file are irrelevant.
file:<path>
The contents of actual_file must match the contents of the
file path.
inline:<text>
The contents of actual_file must match the inline contents
provided in text. Note that text can include escape
sequences.
match:<regexp>
The contents of actual_file must match the given regular
expression in regexp.
not-match:<regexp>
The contents of actual_file must not match the given regular
expression in regexp.
save:<path>
actual_file is saved to path for further inspection by the
test case. This is not useful in the context of
shtk_unittest_assert_file but comes in handy when used in
conjunction of shtk_unittest_assert_command(3).
stdin
The contents of actual_file must match the golden contents
provided via the standard input.
EXAMPLES
The following examples all pass:
touch my_file
assert_file empty my_file
echo "foo" >my_file
assert_file inline:"foo\n" my_file
echo "bar" >>my_file
cp my_file golden
assert_file file:golden my_file
assert_file stdin my_file <golden
assert_file match:"fo" my_file
assert_file not-match:"abcde" my_file
SEE ALSOshtk(3), shtk_unittest(3)HISTORYshtk_unittest_assert_file first appeared in shtk 1.6.
BSD November 9, 2014 BSD
