mirror of
https://github.com/freebsd/freebsd-src.git
synced 2026-10-31 12:56:10 +01:00
Released on October 23rd, 2014.
* Restored the atf(7) manual page to serve as a reference to all the other
manual pages shipped by ATF.
* Added the -s flag to atf-sh to support specifying the shell interpreter
to be used.
* Removed ATF_WORKDIR. The only remaining consumers have been converted to
use the standard TMPDIR environment variable. As a benefit, and because
Kyua forces the TMPDIR to live within the test case's work directory,
any stale files left behind by ATF will be automatically cleaned up.
* Documented the environment variables recognized by each component in the
relevant manual pages. This information was lost with the atf-config(1)
removal.
* Added a new "require.diskspace" metadata property to test cases so that
they can specify the minimum amount of disk space required for the test
to run.
* Renamed the atf-{c,c++,sh}-api(3) manual pages to atf-{c,c++,sh}(3) for
discoverability purposes. Symbolic links are provided for the time
being to still make the old names visible.
* Issue #5: Recommend the (expected, actual) idiom for calls to the test
macros in the manual pages.
* Issue #7: Stopped catching unhandled exceptions in atf-c++ tests. This
propagates the crash to the caller, which in turn allows it to obtain
proper debugging information. In particular, Kyua should now be able to
extract a stacktrace pinpointing the problem.
* Issue #8: Fixed atf-c/macros_test:use test failures spotted by the clang
that ships with FreeBSD 11.0-CURRENT.
* Issue #12: Improved documentation of atf-sh(3) and atf-check(1) by better
explaining how they relate to each other.
* Issue #14: Stopped setting 'set -e' in atf-sh. This setting was
initially added as a way to enable a "strict" mode in the library and to
make test cases fail fast when they run unprotected commands. However,
doing so in the library is surprising as the responsibility of enabling
'set -e' should be on the user's code. Also, 'set -e' introduces
inconsistent behavior on subshells and users do not expect that.
* Issue #15: Fixed atf_utils_{fork,wait} to support nested calls.
* Issue #16: Fixed test failures (by removing a long-standing hack) on
systems that lack \e support in printf(1).
* Issue #19: Removed stale references to atf-config and atf-run.
356 lines
9.8 KiB
C++
356 lines
9.8 KiB
C++
// Copyright (c) 2007 The NetBSD Foundation, Inc.
|
|
// All rights reserved.
|
|
//
|
|
// Redistribution and use in source and binary forms, with or without
|
|
// modification, are permitted provided that the following conditions
|
|
// are met:
|
|
// 1. Redistributions of source code must retain the above copyright
|
|
// notice, this list of conditions and the following disclaimer.
|
|
// 2. Redistributions in binary form must reproduce the above copyright
|
|
// notice, this list of conditions and the following disclaimer in the
|
|
// documentation and/or other materials provided with the distribution.
|
|
//
|
|
// THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND
|
|
// CONTRIBUTORS ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES,
|
|
// INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
|
|
// MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
|
|
// IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS BE LIABLE FOR ANY
|
|
// DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
|
|
// DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
|
|
// GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
|
|
// INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
|
|
// IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
|
|
// OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
|
|
// IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
|
|
|
extern "C" {
|
|
#include <signal.h>
|
|
#include <unistd.h>
|
|
}
|
|
|
|
#include <cstdlib>
|
|
#include <fstream>
|
|
#include <iostream>
|
|
|
|
#include <atf-c++.hpp>
|
|
|
|
#include "atf-c++/detail/fs.hpp"
|
|
|
|
// ------------------------------------------------------------------------
|
|
// Helper tests for "t_config".
|
|
// ------------------------------------------------------------------------
|
|
|
|
ATF_TEST_CASE(config_unset);
|
|
ATF_TEST_CASE_HEAD(config_unset)
|
|
{
|
|
set_md_var("descr", "Helper test case for the t_config test program");
|
|
}
|
|
ATF_TEST_CASE_BODY(config_unset)
|
|
{
|
|
ATF_REQUIRE(!has_config_var("test"));
|
|
}
|
|
|
|
ATF_TEST_CASE(config_empty);
|
|
ATF_TEST_CASE_HEAD(config_empty)
|
|
{
|
|
set_md_var("descr", "Helper test case for the t_config test program");
|
|
}
|
|
ATF_TEST_CASE_BODY(config_empty)
|
|
{
|
|
ATF_REQUIRE_EQ(get_config_var("test"), "");
|
|
}
|
|
|
|
ATF_TEST_CASE(config_value);
|
|
ATF_TEST_CASE_HEAD(config_value)
|
|
{
|
|
set_md_var("descr", "Helper test case for the t_config test program");
|
|
}
|
|
ATF_TEST_CASE_BODY(config_value)
|
|
{
|
|
ATF_REQUIRE_EQ(get_config_var("test"), "foo");
|
|
}
|
|
|
|
ATF_TEST_CASE(config_multi_value);
|
|
ATF_TEST_CASE_HEAD(config_multi_value)
|
|
{
|
|
set_md_var("descr", "Helper test case for the t_config test program");
|
|
}
|
|
ATF_TEST_CASE_BODY(config_multi_value)
|
|
{
|
|
ATF_REQUIRE_EQ(get_config_var("test"), "foo bar");
|
|
}
|
|
|
|
// ------------------------------------------------------------------------
|
|
// Helper tests for "t_expect".
|
|
// ------------------------------------------------------------------------
|
|
|
|
ATF_TEST_CASE_WITHOUT_HEAD(expect_pass_and_pass);
|
|
ATF_TEST_CASE_BODY(expect_pass_and_pass)
|
|
{
|
|
expect_pass();
|
|
}
|
|
|
|
ATF_TEST_CASE_WITHOUT_HEAD(expect_pass_but_fail_requirement);
|
|
ATF_TEST_CASE_BODY(expect_pass_but_fail_requirement)
|
|
{
|
|
expect_pass();
|
|
fail("Some reason");
|
|
}
|
|
|
|
ATF_TEST_CASE_WITHOUT_HEAD(expect_pass_but_fail_check);
|
|
ATF_TEST_CASE_BODY(expect_pass_but_fail_check)
|
|
{
|
|
expect_pass();
|
|
fail_nonfatal("Some reason");
|
|
}
|
|
|
|
ATF_TEST_CASE_WITHOUT_HEAD(expect_fail_and_fail_requirement);
|
|
ATF_TEST_CASE_BODY(expect_fail_and_fail_requirement)
|
|
{
|
|
expect_fail("Fail reason");
|
|
fail("The failure");
|
|
expect_pass();
|
|
}
|
|
|
|
ATF_TEST_CASE_WITHOUT_HEAD(expect_fail_and_fail_check);
|
|
ATF_TEST_CASE_BODY(expect_fail_and_fail_check)
|
|
{
|
|
expect_fail("Fail first");
|
|
fail_nonfatal("abc");
|
|
expect_pass();
|
|
|
|
expect_fail("And fail again");
|
|
fail_nonfatal("def");
|
|
expect_pass();
|
|
}
|
|
|
|
ATF_TEST_CASE_WITHOUT_HEAD(expect_fail_but_pass);
|
|
ATF_TEST_CASE_BODY(expect_fail_but_pass)
|
|
{
|
|
expect_fail("Fail first");
|
|
fail_nonfatal("abc");
|
|
expect_pass();
|
|
|
|
expect_fail("Will not fail");
|
|
expect_pass();
|
|
|
|
expect_fail("And fail again");
|
|
fail_nonfatal("def");
|
|
expect_pass();
|
|
}
|
|
|
|
ATF_TEST_CASE_WITHOUT_HEAD(expect_exit_any_and_exit);
|
|
ATF_TEST_CASE_BODY(expect_exit_any_and_exit)
|
|
{
|
|
expect_exit(-1, "Call will exit");
|
|
std::exit(EXIT_SUCCESS);
|
|
}
|
|
|
|
ATF_TEST_CASE_WITHOUT_HEAD(expect_exit_code_and_exit);
|
|
ATF_TEST_CASE_BODY(expect_exit_code_and_exit)
|
|
{
|
|
expect_exit(123, "Call will exit");
|
|
std::exit(123);
|
|
}
|
|
|
|
ATF_TEST_CASE_WITHOUT_HEAD(expect_exit_but_pass);
|
|
ATF_TEST_CASE_BODY(expect_exit_but_pass)
|
|
{
|
|
expect_exit(-1, "Call won't exit");
|
|
}
|
|
|
|
ATF_TEST_CASE_WITHOUT_HEAD(expect_signal_any_and_signal);
|
|
ATF_TEST_CASE_BODY(expect_signal_any_and_signal)
|
|
{
|
|
expect_signal(-1, "Call will signal");
|
|
::kill(getpid(), SIGKILL);
|
|
}
|
|
|
|
ATF_TEST_CASE_WITHOUT_HEAD(expect_signal_no_and_signal);
|
|
ATF_TEST_CASE_BODY(expect_signal_no_and_signal)
|
|
{
|
|
expect_signal(SIGHUP, "Call will signal");
|
|
::kill(getpid(), SIGHUP);
|
|
}
|
|
|
|
ATF_TEST_CASE_WITHOUT_HEAD(expect_signal_but_pass);
|
|
ATF_TEST_CASE_BODY(expect_signal_but_pass)
|
|
{
|
|
expect_signal(-1, "Call won't signal");
|
|
}
|
|
|
|
ATF_TEST_CASE_WITHOUT_HEAD(expect_death_and_exit);
|
|
ATF_TEST_CASE_BODY(expect_death_and_exit)
|
|
{
|
|
expect_death("Exit case");
|
|
std::exit(123);
|
|
}
|
|
|
|
ATF_TEST_CASE_WITHOUT_HEAD(expect_death_and_signal);
|
|
ATF_TEST_CASE_BODY(expect_death_and_signal)
|
|
{
|
|
expect_death("Signal case");
|
|
kill(getpid(), SIGKILL);
|
|
}
|
|
|
|
ATF_TEST_CASE_WITHOUT_HEAD(expect_death_but_pass);
|
|
ATF_TEST_CASE_BODY(expect_death_but_pass)
|
|
{
|
|
expect_death("Call won't die");
|
|
}
|
|
|
|
ATF_TEST_CASE(expect_timeout_and_hang);
|
|
ATF_TEST_CASE_HEAD(expect_timeout_and_hang)
|
|
{
|
|
set_md_var("timeout", "1");
|
|
}
|
|
ATF_TEST_CASE_BODY(expect_timeout_and_hang)
|
|
{
|
|
expect_timeout("Will overrun");
|
|
::sleep(5);
|
|
}
|
|
|
|
ATF_TEST_CASE(expect_timeout_but_pass);
|
|
ATF_TEST_CASE_HEAD(expect_timeout_but_pass)
|
|
{
|
|
set_md_var("timeout", "1");
|
|
}
|
|
ATF_TEST_CASE_BODY(expect_timeout_but_pass)
|
|
{
|
|
expect_timeout("Will just exit");
|
|
}
|
|
|
|
// ------------------------------------------------------------------------
|
|
// Helper tests for "t_meta_data".
|
|
// ------------------------------------------------------------------------
|
|
|
|
ATF_TEST_CASE(metadata_no_descr);
|
|
ATF_TEST_CASE_HEAD(metadata_no_descr)
|
|
{
|
|
}
|
|
ATF_TEST_CASE_BODY(metadata_no_descr)
|
|
{
|
|
}
|
|
|
|
ATF_TEST_CASE_WITHOUT_HEAD(metadata_no_head);
|
|
ATF_TEST_CASE_BODY(metadata_no_head)
|
|
{
|
|
}
|
|
|
|
// ------------------------------------------------------------------------
|
|
// Helper tests for "t_srcdir".
|
|
// ------------------------------------------------------------------------
|
|
|
|
ATF_TEST_CASE(srcdir_exists);
|
|
ATF_TEST_CASE_HEAD(srcdir_exists)
|
|
{
|
|
set_md_var("descr", "Helper test case for the t_srcdir test program");
|
|
}
|
|
ATF_TEST_CASE_BODY(srcdir_exists)
|
|
{
|
|
if (!atf::fs::exists(atf::fs::path(get_config_var("srcdir")) /
|
|
"datafile"))
|
|
ATF_FAIL("Cannot find datafile");
|
|
}
|
|
|
|
// ------------------------------------------------------------------------
|
|
// Helper tests for "t_result".
|
|
// ------------------------------------------------------------------------
|
|
|
|
ATF_TEST_CASE(result_pass);
|
|
ATF_TEST_CASE_HEAD(result_pass) { }
|
|
ATF_TEST_CASE_BODY(result_pass)
|
|
{
|
|
std::cout << "msg\n";
|
|
}
|
|
|
|
ATF_TEST_CASE(result_fail);
|
|
ATF_TEST_CASE_HEAD(result_fail) { }
|
|
ATF_TEST_CASE_BODY(result_fail)
|
|
{
|
|
std::cout << "msg\n";
|
|
ATF_FAIL("Failure reason");
|
|
}
|
|
|
|
ATF_TEST_CASE(result_skip);
|
|
ATF_TEST_CASE_HEAD(result_skip) { }
|
|
ATF_TEST_CASE_BODY(result_skip)
|
|
{
|
|
std::cout << "msg\n";
|
|
ATF_SKIP("Skipped reason");
|
|
}
|
|
|
|
ATF_TEST_CASE(result_newlines_fail);
|
|
ATF_TEST_CASE_HEAD(result_newlines_fail)
|
|
{
|
|
set_md_var("descr", "Helper test case for the t_result test program");
|
|
}
|
|
ATF_TEST_CASE_BODY(result_newlines_fail)
|
|
{
|
|
ATF_FAIL("First line\nSecond line");
|
|
}
|
|
|
|
ATF_TEST_CASE(result_newlines_skip);
|
|
ATF_TEST_CASE_HEAD(result_newlines_skip)
|
|
{
|
|
set_md_var("descr", "Helper test case for the t_result test program");
|
|
}
|
|
ATF_TEST_CASE_BODY(result_newlines_skip)
|
|
{
|
|
ATF_SKIP("First line\nSecond line");
|
|
}
|
|
|
|
ATF_TEST_CASE(result_exception);
|
|
ATF_TEST_CASE_HEAD(result_exception) { }
|
|
ATF_TEST_CASE_BODY(result_exception)
|
|
{
|
|
throw std::runtime_error("This is unhandled");
|
|
}
|
|
|
|
// ------------------------------------------------------------------------
|
|
// Main.
|
|
// ------------------------------------------------------------------------
|
|
|
|
ATF_INIT_TEST_CASES(tcs)
|
|
{
|
|
// Add helper tests for t_config.
|
|
ATF_ADD_TEST_CASE(tcs, config_unset);
|
|
ATF_ADD_TEST_CASE(tcs, config_empty);
|
|
ATF_ADD_TEST_CASE(tcs, config_value);
|
|
ATF_ADD_TEST_CASE(tcs, config_multi_value);
|
|
|
|
// Add helper tests for t_expect.
|
|
ATF_ADD_TEST_CASE(tcs, expect_pass_and_pass);
|
|
ATF_ADD_TEST_CASE(tcs, expect_pass_but_fail_requirement);
|
|
ATF_ADD_TEST_CASE(tcs, expect_pass_but_fail_check);
|
|
ATF_ADD_TEST_CASE(tcs, expect_fail_and_fail_requirement);
|
|
ATF_ADD_TEST_CASE(tcs, expect_fail_and_fail_check);
|
|
ATF_ADD_TEST_CASE(tcs, expect_fail_but_pass);
|
|
ATF_ADD_TEST_CASE(tcs, expect_exit_any_and_exit);
|
|
ATF_ADD_TEST_CASE(tcs, expect_exit_code_and_exit);
|
|
ATF_ADD_TEST_CASE(tcs, expect_exit_but_pass);
|
|
ATF_ADD_TEST_CASE(tcs, expect_signal_any_and_signal);
|
|
ATF_ADD_TEST_CASE(tcs, expect_signal_no_and_signal);
|
|
ATF_ADD_TEST_CASE(tcs, expect_signal_but_pass);
|
|
ATF_ADD_TEST_CASE(tcs, expect_death_and_exit);
|
|
ATF_ADD_TEST_CASE(tcs, expect_death_and_signal);
|
|
ATF_ADD_TEST_CASE(tcs, expect_death_but_pass);
|
|
ATF_ADD_TEST_CASE(tcs, expect_timeout_and_hang);
|
|
ATF_ADD_TEST_CASE(tcs, expect_timeout_but_pass);
|
|
|
|
// Add helper tests for t_meta_data.
|
|
ATF_ADD_TEST_CASE(tcs, metadata_no_descr);
|
|
ATF_ADD_TEST_CASE(tcs, metadata_no_head);
|
|
|
|
// Add helper tests for t_srcdir.
|
|
ATF_ADD_TEST_CASE(tcs, srcdir_exists);
|
|
|
|
// Add helper tests for t_result.
|
|
ATF_ADD_TEST_CASE(tcs, result_pass);
|
|
ATF_ADD_TEST_CASE(tcs, result_fail);
|
|
ATF_ADD_TEST_CASE(tcs, result_skip);
|
|
ATF_ADD_TEST_CASE(tcs, result_newlines_fail);
|
|
ATF_ADD_TEST_CASE(tcs, result_newlines_skip);
|
|
ATF_ADD_TEST_CASE(tcs, result_exception);
|
|
}
|