// Copyright 2010 The Kyua Authors. // All rights reserved. // // Redistribution and use in source and binary forms, with or without // modification, are permitted provided that the following conditions are // met: // // * Redistributions of source code must retain the above copyright // notice, this list of conditions and the following disclaimer. // * 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. // * Neither the name of Google Inc. nor the names of its contributors // may be used to endorse or promote products derived from this software // without specific prior written permission. // // THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS 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 COPYRIGHT // OWNER 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. #include "model/test_program.hpp" extern "C" { #include #include } #include #include #include #include "model/exceptions.hpp" #include "model/metadata.hpp" #include "model/test_case.hpp" #include "model/test_result.hpp" #include "utils/env.hpp" #include "utils/format/containers.ipp" #include "utils/format/macros.hpp" #include "utils/fs/operations.hpp" #include "utils/fs/path.hpp" #include "utils/optional.ipp" namespace fs = utils::fs; namespace { /// Test program that sets its test cases lazily. /// /// This test class exists to test the behavior of a test_program object when /// the class is extended to offer lazy loading of test cases. We simulate such /// lazy loading here by storing the list of test cases aside at construction /// time and later setting it lazily the first time test_cases() is called. class lazy_test_program : public model::test_program { /// Whether set_test_cases() has yet been called or not. mutable bool _set_test_cases_called; /// The list of test cases for this test program. /// /// Only use this in the call to set_test_cases(). All other reads of the /// test cases list should happen via the parent class' test_cases() method. model::test_cases_map _lazy_test_cases; public: /// Constructs a new test program. /// /// \param interface_name_ Name of the test program interface. /// \param binary_ The name of the test program binary relative to root_. /// \param root_ The root of the test suite containing the test program. /// \param test_suite_name_ The name of the test suite. /// \param metadata_ Metadata of the test program. /// \param test_cases_ The collection of test cases in the test program. lazy_test_program(const std::string& interface_name_, const utils::fs::path& binary_, const utils::fs::path& root_, const std::string& test_suite_name_, const model::metadata& metadata_, const model::test_cases_map& test_cases_) : test_program(interface_name_, binary_, root_, test_suite_name_, metadata_, model::test_cases_map()), _set_test_cases_called(false), _lazy_test_cases(test_cases_) { } /// Lazily sets the test cases on the parent and returns them. /// /// \return The list of test cases. const model::test_cases_map& test_cases(void) const { if (!_set_test_cases_called) { const_cast< lazy_test_program* >(this)->set_test_cases( _lazy_test_cases); _set_test_cases_called = true; } return test_program::test_cases(); } }; } // anonymous namespace /// Runs a ctor_and_getters test. /// /// \tparam TestProgram Either model::test_program or lazy_test_program. template< class TestProgram > static void check_ctor_and_getters(void) { const model::metadata tp_md = model::metadata_builder() .add_custom("first", "foo") .add_custom("second", "bar") .build(); const model::metadata tc_md = model::metadata_builder() .add_custom("first", "baz") .build(); const TestProgram test_program( "mock", fs::path("binary"), fs::path("root"), "suite-name", tp_md, model::test_cases_map_builder().add("foo", tc_md).build()); ATF_REQUIRE_EQ("mock", test_program.interface_name()); ATF_REQUIRE_EQ(fs::path("binary"), test_program.relative_path()); ATF_REQUIRE_EQ(fs::current_path() / "root/binary", test_program.absolute_path()); ATF_REQUIRE_EQ(fs::path("root"), test_program.root()); ATF_REQUIRE_EQ("suite-name", test_program.test_suite_name()); ATF_REQUIRE_EQ(tp_md, test_program.get_metadata()); const model::metadata exp_tc_md = model::metadata_builder() .add_custom("first", "baz") .add_custom("second", "bar") .build(); const model::test_cases_map exp_tcs = model::test_cases_map_builder() .add("foo", exp_tc_md) .build(); ATF_REQUIRE_EQ(exp_tcs, test_program.test_cases()); } ATF_TEST_CASE_WITHOUT_HEAD(ctor_and_getters); ATF_TEST_CASE_BODY(ctor_and_getters) { check_ctor_and_getters< model::test_program >(); } ATF_TEST_CASE_WITHOUT_HEAD(derived__ctor_and_getters); ATF_TEST_CASE_BODY(derived__ctor_and_getters) { check_ctor_and_getters< lazy_test_program >(); } /// Runs a find_ok test. /// /// \tparam TestProgram Either model::test_program or lazy_test_program. template< class TestProgram > static void check_find_ok(void) { const model::test_case test_case("main", model::metadata_builder().build()); const TestProgram test_program( "mock", fs::path("non-existent"), fs::path("."), "suite-name", model::metadata_builder().build(), model::test_cases_map_builder().add(test_case).build()); const model::test_case& found_test_case = test_program.find("main"); ATF_REQUIRE_EQ(test_case, found_test_case); } ATF_TEST_CASE_WITHOUT_HEAD(find__ok); ATF_TEST_CASE_BODY(find__ok) { check_find_ok< model::test_program >(); } ATF_TEST_CASE_WITHOUT_HEAD(derived__find__ok); ATF_TEST_CASE_BODY(derived__find__ok) { check_find_ok< lazy_test_program >(); } /// Runs a find_missing test. /// /// \tparam TestProgram Either model::test_program or lazy_test_program. template< class TestProgram > static void check_find_missing(void) { const TestProgram test_program( "mock", fs::path("non-existent"), fs::path("."), "suite-name", model::metadata_builder().build(), model::test_cases_map_builder().add("main").build()); ATF_REQUIRE_THROW_RE(model::not_found_error, "case.*abc.*program.*non-existent", test_program.find("abc")); } ATF_TEST_CASE_WITHOUT_HEAD(find__missing); ATF_TEST_CASE_BODY(find__missing) { check_find_missing< model::test_program >(); } ATF_TEST_CASE_WITHOUT_HEAD(derived__find__missing); ATF_TEST_CASE_BODY(derived__find__missing) { check_find_missing< lazy_test_program >(); } /// Runs a metadata_inheritance test. /// /// \tparam TestProgram Either model::test_program or lazy_test_program. template< class TestProgram > static void check_metadata_inheritance(void) { const model::test_cases_map test_cases = model::test_cases_map_builder() .add("inherit-all") .add("inherit-some", model::metadata_builder() .set_description("Overriden description") .build()) .add("inherit-none", model::metadata_builder() .add_allowed_architecture("overriden-arch") .add_allowed_platform("overriden-platform") .set_description("Overriden description") .build()) .build(); const model::metadata metadata = model::metadata_builder() .add_allowed_architecture("base-arch") .set_description("Base description") .build(); const TestProgram test_program( "plain", fs::path("non-existent"), fs::path("."), "suite-name", metadata, test_cases); { const model::metadata exp_metadata = model::metadata_builder() .add_allowed_architecture("base-arch") .set_description("Base description") .build(); ATF_REQUIRE_EQ(exp_metadata, test_program.find("inherit-all").get_metadata()); } { const model::metadata exp_metadata = model::metadata_builder() .add_allowed_architecture("base-arch") .set_description("Overriden description") .build(); ATF_REQUIRE_EQ(exp_metadata, test_program.find("inherit-some").get_metadata()); } { const model::metadata exp_metadata = model::metadata_builder() .add_allowed_architecture("overriden-arch") .add_allowed_platform("overriden-platform") .set_description("Overriden description") .build(); ATF_REQUIRE_EQ(exp_metadata, test_program.find("inherit-none").get_metadata()); } } ATF_TEST_CASE_WITHOUT_HEAD(metadata_inheritance); ATF_TEST_CASE_BODY(metadata_inheritance) { check_metadata_inheritance< model::test_program >(); } ATF_TEST_CASE_WITHOUT_HEAD(derived__metadata_inheritance); ATF_TEST_CASE_BODY(derived__metadata_inheritance) { check_metadata_inheritance< lazy_test_program >(); } /// Runs a operators_eq_and_ne__copy test. /// /// \tparam TestProgram Either model::test_program or lazy_test_program. template< class TestProgram > static void check_operators_eq_and_ne__copy(void) { const TestProgram tp1( "plain", fs::path("non-existent"), fs::path("."), "suite-name", model::metadata_builder().build(), model::test_cases_map()); const TestProgram tp2 = tp1; ATF_REQUIRE( tp1 == tp2); ATF_REQUIRE(!(tp1 != tp2)); } ATF_TEST_CASE_WITHOUT_HEAD(operators_eq_and_ne__copy); ATF_TEST_CASE_BODY(operators_eq_and_ne__copy) { check_operators_eq_and_ne__copy< model::test_program >(); } ATF_TEST_CASE_WITHOUT_HEAD(derived__operators_eq_and_ne__copy); ATF_TEST_CASE_BODY(derived__operators_eq_and_ne__copy) { check_operators_eq_and_ne__copy< lazy_test_program >(); } /// Runs a operators_eq_and_ne__not_copy test. /// /// \tparam TestProgram Either model::test_program or lazy_test_program. template< class TestProgram > static void check_operators_eq_and_ne__not_copy(void) { const std::string base_interface("plain"); const fs::path base_relative_path("the/test/program"); const fs::path base_root("/the/root"); const std::string base_test_suite("suite-name"); const model::metadata base_metadata = model::metadata_builder() .add_custom("foo", "bar") .build(); const model::test_cases_map base_tcs = model::test_cases_map_builder() .add("main", model::metadata_builder() .add_custom("second", "baz") .build()) .build(); const TestProgram base_tp( base_interface, base_relative_path, base_root, base_test_suite, base_metadata, base_tcs); // Construct with all same values. { const model::test_cases_map other_tcs = model::test_cases_map_builder() .add("main", model::metadata_builder() .add_custom("second", "baz") .build()) .build(); const TestProgram other_tp( base_interface, base_relative_path, base_root, base_test_suite, base_metadata, other_tcs); ATF_REQUIRE( base_tp == other_tp); ATF_REQUIRE(!(base_tp != other_tp)); } // Construct with same final metadata values but using a different // intermediate representation. The original test program has one property // in the base test program definition and another in the test case; here, // we put both definitions explicitly in the test case. { const model::test_cases_map other_tcs = model::test_cases_map_builder() .add("main", model::metadata_builder() .add_custom("foo", "bar") .add_custom("second", "baz") .build()) .build(); const TestProgram other_tp( base_interface, base_relative_path, base_root, base_test_suite, base_metadata, other_tcs); ATF_REQUIRE( base_tp == other_tp); ATF_REQUIRE(!(base_tp != other_tp)); } // Different interface. { const TestProgram other_tp( "atf", base_relative_path, base_root, base_test_suite, base_metadata, base_tcs); ATF_REQUIRE(!(base_tp == other_tp)); ATF_REQUIRE( base_tp != other_tp); } // Different relative path. { const TestProgram other_tp( base_interface, fs::path("a/b/c"), base_root, base_test_suite, base_metadata, base_tcs); ATF_REQUIRE(!(base_tp == other_tp)); ATF_REQUIRE( base_tp != other_tp); } // Different root. { const TestProgram other_tp( base_interface, base_relative_path, fs::path("."), base_test_suite, base_metadata, base_tcs); ATF_REQUIRE(!(base_tp == other_tp)); ATF_REQUIRE( base_tp != other_tp); } // Different test suite. { const TestProgram other_tp( base_interface, base_relative_path, base_root, "different-suite", base_metadata, base_tcs); ATF_REQUIRE(!(base_tp == other_tp)); ATF_REQUIRE( base_tp != other_tp); } // Different metadata. { const TestProgram other_tp( base_interface, base_relative_path, base_root, base_test_suite, model::metadata_builder().build(), base_tcs); ATF_REQUIRE(!(base_tp == other_tp)); ATF_REQUIRE( base_tp != other_tp); } // Different test cases. { const model::test_cases_map other_tcs = model::test_cases_map_builder() .add("foo").build(); const TestProgram other_tp( base_interface, base_relative_path, base_root, base_test_suite, base_metadata, other_tcs); ATF_REQUIRE(!(base_tp == other_tp)); ATF_REQUIRE( base_tp != other_tp); } } ATF_TEST_CASE_WITHOUT_HEAD(operators_eq_and_ne__not_copy); ATF_TEST_CASE_BODY(operators_eq_and_ne__not_copy) { check_operators_eq_and_ne__not_copy< model::test_program >(); } ATF_TEST_CASE_WITHOUT_HEAD(derived__operators_eq_and_ne__not_copy); ATF_TEST_CASE_BODY(derived__operators_eq_and_ne__not_copy) { check_operators_eq_and_ne__not_copy< lazy_test_program >(); } /// Runs a operator_lt test. /// /// \tparam TestProgram Either model::test_program or lazy_test_program. template< class TestProgram > static void check_operator_lt(void) { const TestProgram tp1( "plain", fs::path("a/b/c"), fs::path("/foo/bar"), "suite-name", model::metadata_builder().build(), model::test_cases_map()); const TestProgram tp2( "atf", fs::path("c"), fs::path("/foo/bar"), "suite-name", model::metadata_builder().build(), model::test_cases_map()); const TestProgram tp3( "plain", fs::path("a/b/c"), fs::path("/abc"), "suite-name", model::metadata_builder().build(), model::test_cases_map()); ATF_REQUIRE(!(tp1 < tp1)); ATF_REQUIRE( tp1 < tp2); ATF_REQUIRE(!(tp2 < tp1)); ATF_REQUIRE(!(tp1 < tp3)); ATF_REQUIRE( tp3 < tp1); // And now, test the actual reason why we want to have an < overload by // attempting to put the various programs in a set. std::set< TestProgram > programs; programs.insert(tp1); programs.insert(tp2); programs.insert(tp3); } ATF_TEST_CASE_WITHOUT_HEAD(operator_lt); ATF_TEST_CASE_BODY(operator_lt) { check_operator_lt< model::test_program >(); } ATF_TEST_CASE_WITHOUT_HEAD(derived__operator_lt); ATF_TEST_CASE_BODY(derived__operator_lt) { check_operator_lt< lazy_test_program >(); } /// Runs a output__no_test_cases test. /// /// \tparam TestProgram Either model::test_program or lazy_test_program. template< class TestProgram > static void check_output__no_test_cases(void) { TestProgram tp( "plain", fs::path("binary/path"), fs::path("/the/root"), "suite-name", model::metadata_builder().add_allowed_architecture("a").build(), model::test_cases_map()); std::ostringstream str; str << tp; ATF_REQUIRE_EQ( "test_program{interface='plain', binary='binary/path', " "root='/the/root', test_suite='suite-name', " "metadata=metadata{allowed_architectures='a', allowed_platforms='', " "description='', has_cleanup='false', is_exclusive='false', " "required_configs='', required_disk_space='0', required_files='', " "required_memory='0', " "required_programs='', required_user='', timeout='300'}, " "test_cases=map()}", str.str()); } ATF_TEST_CASE_WITHOUT_HEAD(output__no_test_cases); ATF_TEST_CASE_BODY(output__no_test_cases) { check_output__no_test_cases< model::test_program >(); } ATF_TEST_CASE_WITHOUT_HEAD(derived__output__no_test_cases); ATF_TEST_CASE_BODY(derived__output__no_test_cases) { check_output__no_test_cases< lazy_test_program >(); } /// Runs a output__some_test_cases test. /// /// \tparam TestProgram Either model::test_program or lazy_test_program. template< class TestProgram > static void check_output__some_test_cases(void) { const model::test_cases_map test_cases = model::test_cases_map_builder() .add("the-name", model::metadata_builder() .add_allowed_platform("foo") .add_custom("bar", "baz") .build()) .add("another-name") .build(); const TestProgram tp = TestProgram( "plain", fs::path("binary/path"), fs::path("/the/root"), "suite-name", model::metadata_builder().add_allowed_architecture("a").build(), test_cases); std::ostringstream str; str << tp; ATF_REQUIRE_EQ( "test_program{interface='plain', binary='binary/path', " "root='/the/root', test_suite='suite-name', " "metadata=metadata{allowed_architectures='a', allowed_platforms='', " "description='', has_cleanup='false', is_exclusive='false', " "required_configs='', required_disk_space='0', required_files='', " "required_memory='0', " "required_programs='', required_user='', timeout='300'}, " "test_cases=map(" "another-name=test_case{name='another-name', " "metadata=metadata{allowed_architectures='a', allowed_platforms='', " "description='', has_cleanup='false', is_exclusive='false', " "required_configs='', required_disk_space='0', required_files='', " "required_memory='0', " "required_programs='', required_user='', timeout='300'}}, " "the-name=test_case{name='the-name', " "metadata=metadata{allowed_architectures='a', allowed_platforms='foo', " "custom.bar='baz', description='', has_cleanup='false', " "is_exclusive='false', " "required_configs='', required_disk_space='0', required_files='', " "required_memory='0', " "required_programs='', required_user='', timeout='300'}})}", str.str()); } ATF_TEST_CASE_WITHOUT_HEAD(output__some_test_cases); ATF_TEST_CASE_BODY(output__some_test_cases) { check_output__some_test_cases< model::test_program >(); } ATF_TEST_CASE_WITHOUT_HEAD(derived__output__some_test_cases); ATF_TEST_CASE_BODY(derived__output__some_test_cases) { check_output__some_test_cases< lazy_test_program >(); } ATF_TEST_CASE_WITHOUT_HEAD(builder__defaults); ATF_TEST_CASE_BODY(builder__defaults) { const model::test_program expected( "mock", fs::path("non-existent"), fs::path("."), "suite-name", model::metadata_builder().build(), model::test_cases_map()); const model::test_program built = model::test_program_builder( "mock", fs::path("non-existent"), fs::path("."), "suite-name") .build(); ATF_REQUIRE_EQ(built, expected); } ATF_TEST_CASE_WITHOUT_HEAD(builder__overrides); ATF_TEST_CASE_BODY(builder__overrides) { const model::metadata md = model::metadata_builder() .add_custom("foo", "bar") .build(); const model::test_cases_map tcs = model::test_cases_map_builder() .add("first") .add("second", md) .build(); const model::test_program expected( "mock", fs::path("binary"), fs::path("root"), "suite-name", md, tcs); const model::test_program built = model::test_program_builder( "mock", fs::path("binary"), fs::path("root"), "suite-name") .add_test_case("first") .add_test_case("second", md) .set_metadata(md) .build(); ATF_REQUIRE_EQ(built, expected); } ATF_TEST_CASE_WITHOUT_HEAD(builder__ptr); ATF_TEST_CASE_BODY(builder__ptr) { const model::test_program expected( "mock", fs::path("non-existent"), fs::path("."), "suite-name", model::metadata_builder().build(), model::test_cases_map()); const model::test_program_ptr built = model::test_program_builder( "mock", fs::path("non-existent"), fs::path("."), "suite-name") .build_ptr(); ATF_REQUIRE_EQ(*built, expected); } ATF_INIT_TEST_CASES(tcs) { ATF_ADD_TEST_CASE(tcs, ctor_and_getters); ATF_ADD_TEST_CASE(tcs, find__ok); ATF_ADD_TEST_CASE(tcs, find__missing); ATF_ADD_TEST_CASE(tcs, metadata_inheritance); ATF_ADD_TEST_CASE(tcs, operators_eq_and_ne__copy); ATF_ADD_TEST_CASE(tcs, operators_eq_and_ne__not_copy); ATF_ADD_TEST_CASE(tcs, operator_lt); ATF_ADD_TEST_CASE(tcs, output__no_test_cases); ATF_ADD_TEST_CASE(tcs, output__some_test_cases); ATF_ADD_TEST_CASE(tcs, derived__ctor_and_getters); ATF_ADD_TEST_CASE(tcs, derived__find__ok); ATF_ADD_TEST_CASE(tcs, derived__find__missing); ATF_ADD_TEST_CASE(tcs, derived__metadata_inheritance); ATF_ADD_TEST_CASE(tcs, derived__operators_eq_and_ne__copy); ATF_ADD_TEST_CASE(tcs, derived__operators_eq_and_ne__not_copy); ATF_ADD_TEST_CASE(tcs, derived__operator_lt); ATF_ADD_TEST_CASE(tcs, derived__output__no_test_cases); ATF_ADD_TEST_CASE(tcs, derived__output__some_test_cases); ATF_ADD_TEST_CASE(tcs, builder__defaults); ATF_ADD_TEST_CASE(tcs, builder__overrides); ATF_ADD_TEST_CASE(tcs, builder__ptr); }