Files
freebsd/test-programs/cpp_helpers.cpp
T
Julio Merino 94d25974a7 Import atf-0.21:
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.
2014-10-30 17:14:07 +00:00

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);
}