Blame cli/config_test.cpp

Packit 209faa
// Copyright 2011 The Kyua Authors.
Packit 209faa
// All rights reserved.
Packit 209faa
//
Packit 209faa
// Redistribution and use in source and binary forms, with or without
Packit 209faa
// modification, are permitted provided that the following conditions are
Packit 209faa
// met:
Packit 209faa
//
Packit 209faa
// * Redistributions of source code must retain the above copyright
Packit 209faa
//   notice, this list of conditions and the following disclaimer.
Packit 209faa
// * Redistributions in binary form must reproduce the above copyright
Packit 209faa
//   notice, this list of conditions and the following disclaimer in the
Packit 209faa
//   documentation and/or other materials provided with the distribution.
Packit 209faa
// * Neither the name of Google Inc. nor the names of its contributors
Packit 209faa
//   may be used to endorse or promote products derived from this software
Packit 209faa
//   without specific prior written permission.
Packit 209faa
//
Packit 209faa
// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
Packit 209faa
// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
Packit 209faa
// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
Packit 209faa
// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
Packit 209faa
// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
Packit 209faa
// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
Packit 209faa
// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
Packit 209faa
// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
Packit 209faa
// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
Packit 209faa
// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
Packit 209faa
// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
Packit 209faa
Packit 209faa
#include "cli/config.hpp"
Packit 209faa
Packit 209faa
#include <atf-c++.hpp>
Packit 209faa
Packit 209faa
#include "engine/config.hpp"
Packit 209faa
#include "engine/exceptions.hpp"
Packit 209faa
#include "utils/cmdline/options.hpp"
Packit 209faa
#include "utils/cmdline/parser.ipp"
Packit 209faa
#include "utils/config/tree.ipp"
Packit 209faa
#include "utils/env.hpp"
Packit 209faa
#include "utils/format/macros.hpp"
Packit 209faa
#include "utils/fs/operations.hpp"
Packit 209faa
#include "utils/fs/path.hpp"
Packit 209faa
Packit 209faa
namespace cmdline = utils::cmdline;
Packit 209faa
namespace config = utils::config;
Packit 209faa
namespace fs = utils::fs;
Packit 209faa
Packit 209faa
Packit 209faa
namespace {
Packit 209faa
Packit 209faa
Packit 209faa
/// Creates a configuration file for testing purposes.
Packit 209faa
///
Packit 209faa
/// To ensure that the loaded file is the one created by this function, use
Packit 209faa
/// validate_mock_config().
Packit 209faa
///
Packit 209faa
/// \param name The name of the configuration file to create.
Packit 209faa
/// \param cookie The magic value to set in the configuration file, or NULL if a
Packit 209faa
///     broken configuration file is desired.
Packit 209faa
static void
Packit 209faa
create_mock_config(const char* name, const char* cookie)
Packit 209faa
{
Packit 209faa
    if (cookie != NULL) {
Packit 209faa
        atf::utils::create_file(
Packit 209faa
            name,
Packit 209faa
            F("syntax(2)\n"
Packit 209faa
              "test_suites.suite.magic_value = '%s'\n") % cookie);
Packit 209faa
    } else {
Packit 209faa
        atf::utils::create_file(name, "syntax(200)\n");
Packit 209faa
    }
Packit 209faa
}
Packit 209faa
Packit 209faa
Packit 209faa
/// Creates an invalid system configuration.
Packit 209faa
///
Packit 209faa
/// \param cookie The magic value to set in the configuration file, or NULL if a
Packit 209faa
///     broken configuration file is desired.
Packit 209faa
static void
Packit 209faa
mock_system_config(const char* cookie)
Packit 209faa
{
Packit 209faa
    fs::mkdir(fs::path("system-dir"), 0755);
Packit 209faa
    utils::setenv("KYUA_CONFDIR", (fs::current_path() / "system-dir").str());
Packit 209faa
    create_mock_config("system-dir/kyua.conf", cookie);
Packit 209faa
}
Packit 209faa
Packit 209faa
Packit 209faa
/// Creates an invalid user configuration.
Packit 209faa
///
Packit 209faa
/// \param cookie The magic value to set in the configuration file, or NULL if a
Packit 209faa
///     broken configuration file is desired.
Packit 209faa
static void
Packit 209faa
mock_user_config(const char* cookie)
Packit 209faa
{
Packit 209faa
    fs::mkdir(fs::path("user-dir"), 0755);
Packit 209faa
    fs::mkdir(fs::path("user-dir/.kyua"), 0755);
Packit 209faa
    utils::setenv("HOME", (fs::current_path() / "user-dir").str());
Packit 209faa
    create_mock_config("user-dir/.kyua/kyua.conf", cookie);
Packit 209faa
}
Packit 209faa
Packit 209faa
Packit 209faa
/// Ensures that a loaded configuration was created with create_mock_config().
Packit 209faa
///
Packit 209faa
/// \param user_config The configuration to validate.
Packit 209faa
/// \param cookie The magic value to expect in the configuration file.
Packit 209faa
static void
Packit 209faa
validate_mock_config(const config::tree& user_config, const char* cookie)
Packit 209faa
{
Packit 209faa
    const config::properties_map& properties = user_config.all_properties(
Packit 209faa
        "test_suites.suite", true);
Packit 209faa
    const config::properties_map::const_iterator iter =
Packit 209faa
        properties.find("magic_value");
Packit 209faa
    ATF_REQUIRE(iter != properties.end());
Packit 209faa
    ATF_REQUIRE_EQ(cookie, (*iter).second);
Packit 209faa
}
Packit 209faa
Packit 209faa
Packit 209faa
/// Ensures that two configuration trees are equal.
Packit 209faa
///
Packit 209faa
/// \param exp_tree The expected configuration tree.
Packit 209faa
/// \param actual_tree The configuration tree being validated against exp_tree.
Packit 209faa
static void
Packit 209faa
require_eq(const config::tree& exp_tree, const config::tree& actual_tree)
Packit 209faa
{
Packit 209faa
    ATF_REQUIRE(exp_tree.all_properties() == actual_tree.all_properties());
Packit 209faa
}
Packit 209faa
Packit 209faa
Packit 209faa
}  // anonymous namespace
Packit 209faa
Packit 209faa
Packit 209faa
ATF_TEST_CASE_WITHOUT_HEAD(load_config__none);
Packit 209faa
ATF_TEST_CASE_BODY(load_config__none)
Packit 209faa
{
Packit 209faa
    utils::setenv("KYUA_CONFDIR", "/the/system/does/not/exist");
Packit 209faa
    utils::setenv("HOME", "/the/user/does/not/exist");
Packit 209faa
Packit 209faa
    std::map< std::string, std::vector< std::string > > options;
Packit 209faa
    options["config"].push_back(cli::config_option.default_value());
Packit 209faa
    const cmdline::parsed_cmdline mock_cmdline(options, cmdline::args_vector());
Packit 209faa
Packit 209faa
    require_eq(engine::default_config(),
Packit 209faa
               cli::load_config(mock_cmdline, true));
Packit 209faa
}
Packit 209faa
Packit 209faa
Packit 209faa
ATF_TEST_CASE_WITHOUT_HEAD(load_config__explicit__ok);
Packit 209faa
ATF_TEST_CASE_BODY(load_config__explicit__ok)
Packit 209faa
{
Packit 209faa
    mock_system_config(NULL);
Packit 209faa
    mock_user_config(NULL);
Packit 209faa
Packit 209faa
    create_mock_config("test-file", "hello");
Packit 209faa
Packit 209faa
    std::map< std::string, std::vector< std::string > > options;
Packit 209faa
    options["config"].push_back("test-file");
Packit 209faa
    const cmdline::parsed_cmdline mock_cmdline(options, cmdline::args_vector());
Packit 209faa
Packit 209faa
    const config::tree user_config = cli::load_config(mock_cmdline, true);
Packit 209faa
    validate_mock_config(user_config, "hello");
Packit 209faa
}
Packit 209faa
Packit 209faa
Packit 209faa
ATF_TEST_CASE_WITHOUT_HEAD(load_config__explicit__disable);
Packit 209faa
ATF_TEST_CASE_BODY(load_config__explicit__disable)
Packit 209faa
{
Packit 209faa
    mock_system_config(NULL);
Packit 209faa
    mock_user_config(NULL);
Packit 209faa
Packit 209faa
    std::map< std::string, std::vector< std::string > > options;
Packit 209faa
    options["config"].push_back("none");
Packit 209faa
    const cmdline::parsed_cmdline mock_cmdline(options, cmdline::args_vector());
Packit 209faa
Packit 209faa
    require_eq(engine::default_config(),
Packit 209faa
               cli::load_config(mock_cmdline, true));
Packit 209faa
}
Packit 209faa
Packit 209faa
Packit 209faa
ATF_TEST_CASE_WITHOUT_HEAD(load_config__explicit__fail);
Packit 209faa
ATF_TEST_CASE_BODY(load_config__explicit__fail)
Packit 209faa
{
Packit 209faa
    mock_system_config("ok1");
Packit 209faa
    mock_user_config("ok2");
Packit 209faa
Packit 209faa
    create_mock_config("test-file", NULL);
Packit 209faa
Packit 209faa
    std::map< std::string, std::vector< std::string > > options;
Packit 209faa
    options["config"].push_back("test-file");
Packit 209faa
    const cmdline::parsed_cmdline mock_cmdline(options, cmdline::args_vector());
Packit 209faa
Packit 209faa
    ATF_REQUIRE_THROW_RE(engine::error, "200",
Packit 209faa
                         cli::load_config(mock_cmdline, true));
Packit 209faa
Packit 209faa
    const config::tree config = cli::load_config(mock_cmdline, false);
Packit 209faa
    require_eq(engine::default_config(), config);
Packit 209faa
}
Packit 209faa
Packit 209faa
Packit 209faa
ATF_TEST_CASE_WITHOUT_HEAD(load_config__user__ok);
Packit 209faa
ATF_TEST_CASE_BODY(load_config__user__ok)
Packit 209faa
{
Packit 209faa
    mock_system_config(NULL);
Packit 209faa
    mock_user_config("I am the user config");
Packit 209faa
Packit 209faa
    std::map< std::string, std::vector< std::string > > options;
Packit 209faa
    options["config"].push_back(cli::config_option.default_value());
Packit 209faa
    const cmdline::parsed_cmdline mock_cmdline(options, cmdline::args_vector());
Packit 209faa
Packit 209faa
    const config::tree user_config = cli::load_config(mock_cmdline, true);
Packit 209faa
    validate_mock_config(user_config, "I am the user config");
Packit 209faa
}
Packit 209faa
Packit 209faa
Packit 209faa
ATF_TEST_CASE_WITHOUT_HEAD(load_config__user__fail);
Packit 209faa
ATF_TEST_CASE_BODY(load_config__user__fail)
Packit 209faa
{
Packit 209faa
    mock_system_config("valid");
Packit 209faa
    mock_user_config(NULL);
Packit 209faa
Packit 209faa
    std::map< std::string, std::vector< std::string > > options;
Packit 209faa
    options["config"].push_back(cli::config_option.default_value());
Packit 209faa
    const cmdline::parsed_cmdline mock_cmdline(options, cmdline::args_vector());
Packit 209faa
Packit 209faa
    ATF_REQUIRE_THROW_RE(engine::error, "200",
Packit 209faa
                         cli::load_config(mock_cmdline, true));
Packit 209faa
Packit 209faa
    const config::tree config = cli::load_config(mock_cmdline, false);
Packit 209faa
    require_eq(engine::default_config(), config);
Packit 209faa
}
Packit 209faa
Packit 209faa
Packit 209faa
ATF_TEST_CASE_WITHOUT_HEAD(load_config__user__bad_home);
Packit 209faa
ATF_TEST_CASE_BODY(load_config__user__bad_home)
Packit 209faa
{
Packit 209faa
    mock_system_config("Fallback system config");
Packit 209faa
    utils::setenv("HOME", "");
Packit 209faa
Packit 209faa
    std::map< std::string, std::vector< std::string > > options;
Packit 209faa
    options["config"].push_back(cli::config_option.default_value());
Packit 209faa
    const cmdline::parsed_cmdline mock_cmdline(options, cmdline::args_vector());
Packit 209faa
Packit 209faa
    const config::tree user_config = cli::load_config(mock_cmdline, true);
Packit 209faa
    validate_mock_config(user_config, "Fallback system config");
Packit 209faa
}
Packit 209faa
Packit 209faa
Packit 209faa
ATF_TEST_CASE_WITHOUT_HEAD(load_config__system__ok);
Packit 209faa
ATF_TEST_CASE_BODY(load_config__system__ok)
Packit 209faa
{
Packit 209faa
    mock_system_config("I am the system config");
Packit 209faa
    utils::setenv("HOME", "/the/user/does/not/exist");
Packit 209faa
Packit 209faa
    std::map< std::string, std::vector< std::string > > options;
Packit 209faa
    options["config"].push_back(cli::config_option.default_value());
Packit 209faa
    const cmdline::parsed_cmdline mock_cmdline(options, cmdline::args_vector());
Packit 209faa
Packit 209faa
    const config::tree user_config = cli::load_config(mock_cmdline, true);
Packit 209faa
    validate_mock_config(user_config, "I am the system config");
Packit 209faa
}
Packit 209faa
Packit 209faa
Packit 209faa
ATF_TEST_CASE_WITHOUT_HEAD(load_config__system__fail);
Packit 209faa
ATF_TEST_CASE_BODY(load_config__system__fail)
Packit 209faa
{
Packit 209faa
    mock_system_config(NULL);
Packit 209faa
    utils::setenv("HOME", "/the/user/does/not/exist");
Packit 209faa
Packit 209faa
    std::map< std::string, std::vector< std::string > > options;
Packit 209faa
    options["config"].push_back(cli::config_option.default_value());
Packit 209faa
    const cmdline::parsed_cmdline mock_cmdline(options, cmdline::args_vector());
Packit 209faa
Packit 209faa
    ATF_REQUIRE_THROW_RE(engine::error, "200",
Packit 209faa
                         cli::load_config(mock_cmdline, true));
Packit 209faa
Packit 209faa
    const config::tree config = cli::load_config(mock_cmdline, false);
Packit 209faa
    require_eq(engine::default_config(), config);
Packit 209faa
}
Packit 209faa
Packit 209faa
Packit 209faa
ATF_TEST_CASE_WITHOUT_HEAD(load_config__overrides__no);
Packit 209faa
ATF_TEST_CASE_BODY(load_config__overrides__no)
Packit 209faa
{
Packit 209faa
    utils::setenv("KYUA_CONFDIR", fs::current_path().str());
Packit 209faa
Packit 209faa
    std::map< std::string, std::vector< std::string > > options;
Packit 209faa
    options["config"].push_back(cli::config_option.default_value());
Packit 209faa
    options["variable"].push_back("architecture=1");
Packit 209faa
    options["variable"].push_back("platform=2");
Packit 209faa
    const cmdline::parsed_cmdline mock_cmdline(options, cmdline::args_vector());
Packit 209faa
Packit 209faa
    const config::tree user_config = cli::load_config(mock_cmdline, true);
Packit 209faa
    ATF_REQUIRE_EQ("1",
Packit 209faa
                   user_config.lookup< config::string_node >("architecture"));
Packit 209faa
    ATF_REQUIRE_EQ("2",
Packit 209faa
                   user_config.lookup< config::string_node >("platform"));
Packit 209faa
}
Packit 209faa
Packit 209faa
Packit 209faa
ATF_TEST_CASE_WITHOUT_HEAD(load_config__overrides__yes);
Packit 209faa
ATF_TEST_CASE_BODY(load_config__overrides__yes)
Packit 209faa
{
Packit 209faa
    atf::utils::create_file(
Packit 209faa
        "config",
Packit 209faa
        "syntax(2)\n"
Packit 209faa
        "architecture = 'do not see me'\n"
Packit 209faa
        "platform = 'see me'\n");
Packit 209faa
Packit 209faa
    std::map< std::string, std::vector< std::string > > options;
Packit 209faa
    options["config"].push_back("config");
Packit 209faa
    options["variable"].push_back("architecture=overriden");
Packit 209faa
    const cmdline::parsed_cmdline mock_cmdline(options, cmdline::args_vector());
Packit 209faa
Packit 209faa
    const config::tree user_config = cli::load_config(mock_cmdline, true);
Packit 209faa
    ATF_REQUIRE_EQ("overriden",
Packit 209faa
                   user_config.lookup< config::string_node >("architecture"));
Packit 209faa
    ATF_REQUIRE_EQ("see me",
Packit 209faa
                   user_config.lookup< config::string_node >("platform"));
Packit 209faa
}
Packit 209faa
Packit 209faa
Packit 209faa
ATF_TEST_CASE_WITHOUT_HEAD(load_config__overrides__fail);
Packit 209faa
ATF_TEST_CASE_BODY(load_config__overrides__fail)
Packit 209faa
{
Packit 209faa
    utils::setenv("KYUA_CONFDIR", fs::current_path().str());
Packit 209faa
Packit 209faa
    std::map< std::string, std::vector< std::string > > options;
Packit 209faa
    options["config"].push_back(cli::config_option.default_value());
Packit 209faa
    options["variable"].push_back(".a=d");
Packit 209faa
    const cmdline::parsed_cmdline mock_cmdline(options, cmdline::args_vector());
Packit 209faa
Packit 209faa
    ATF_REQUIRE_THROW_RE(engine::error, "Empty component in key.*'\\.a'",
Packit 209faa
                         cli::load_config(mock_cmdline, true));
Packit 209faa
Packit 209faa
    const config::tree config = cli::load_config(mock_cmdline, false);
Packit 209faa
    require_eq(engine::default_config(), config);
Packit 209faa
}
Packit 209faa
Packit 209faa
Packit 209faa
ATF_INIT_TEST_CASES(tcs)
Packit 209faa
{
Packit 209faa
    ATF_ADD_TEST_CASE(tcs, load_config__none);
Packit 209faa
    ATF_ADD_TEST_CASE(tcs, load_config__explicit__ok);
Packit 209faa
    ATF_ADD_TEST_CASE(tcs, load_config__explicit__disable);
Packit 209faa
    ATF_ADD_TEST_CASE(tcs, load_config__explicit__fail);
Packit 209faa
    ATF_ADD_TEST_CASE(tcs, load_config__user__ok);
Packit 209faa
    ATF_ADD_TEST_CASE(tcs, load_config__user__fail);
Packit 209faa
    ATF_ADD_TEST_CASE(tcs, load_config__user__bad_home);
Packit 209faa
    ATF_ADD_TEST_CASE(tcs, load_config__system__ok);
Packit 209faa
    ATF_ADD_TEST_CASE(tcs, load_config__system__fail);
Packit 209faa
    ATF_ADD_TEST_CASE(tcs, load_config__overrides__no);
Packit 209faa
    ATF_ADD_TEST_CASE(tcs, load_config__overrides__yes);
Packit 209faa
    ATF_ADD_TEST_CASE(tcs, load_config__overrides__fail);
Packit 209faa
}