To do so, a few dependencies have been imported: * external/bsd/lutok * external/mit/lua * external/public-domain/sqlite * external/public-domain/xz The Kyua framework is the new generation of ATF (Automated Test Framework), it is composed of: * external/bsd/atf * external/bsd/kyua-atf-compat * external/bsd/kyua-cli * external/bsd/kyua-tester * tests Kyua/ATF being written in C++, it depends on libstdc++ which is provided by GCC. As this is not part of the sources, Kyua is only compiled when the native GCC utils are installed. To install Kyua do the following: * In a cross-build enviromnent, add the following to the build.sh commandline: -V MKBINUTILS=yes -V MKGCCCMDS=yes WARNING: At this point the import is still experimental, and not supported on native builds (a.k.a make build). Change-Id: I26aee23c5bbd2d64adcb7c1beb98fe0d479d7ada
141 lines
4.9 KiB
C++
141 lines
4.9 KiB
C++
// Copyright 2011 Google 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:
|
|
//
|
|
// * 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.
|
|
|
|
/// \file test_utils.hpp
|
|
/// Utilities for tests of the lua modules.
|
|
///
|
|
/// This file is intended to be included once, and only once, for every test
|
|
/// program that needs it. All the code is herein contained to simplify the
|
|
/// dependency chain in the build rules.
|
|
|
|
#if !defined(LUTOK_TEST_UTILS_HPP)
|
|
# define LUTOK_TEST_UTILS_HPP
|
|
#else
|
|
# error "test_utils.hpp can only be included once"
|
|
#endif
|
|
|
|
#include <atf-c++.hpp>
|
|
|
|
#include "c_gate.hpp"
|
|
#include "exceptions.hpp"
|
|
#include "state.hpp"
|
|
|
|
|
|
namespace {
|
|
|
|
|
|
/// Checks that a given expression raises a particular lutok::api_error.
|
|
///
|
|
/// We cannot make any assumptions regarding the error text provided by Lua, so
|
|
/// we resort to checking only which API function raised the error (because our
|
|
/// code is the one hardcoding these strings).
|
|
///
|
|
/// \param exp_api_function The name of the Lua C API function that causes the
|
|
/// error.
|
|
/// \param statement The statement to execute.
|
|
#define REQUIRE_API_ERROR(exp_api_function, statement) \
|
|
do { \
|
|
try { \
|
|
statement; \
|
|
ATF_FAIL("api_error not raised by " #statement); \
|
|
} catch (const lutok::api_error& api_error) { \
|
|
ATF_REQUIRE_EQ(exp_api_function, api_error.api_function()); \
|
|
} \
|
|
} while (0)
|
|
|
|
|
|
/// Gets the pointer to the internal lua_State of a state object.
|
|
///
|
|
/// This is pure syntactic sugar to simplify typing in the test cases.
|
|
///
|
|
/// \param state The Lua state.
|
|
///
|
|
/// \return The internal lua_State of the input Lua state.
|
|
static inline lua_State*
|
|
raw(lutok::state& state)
|
|
{
|
|
return lutok::state_c_gate(state).c_state();
|
|
}
|
|
|
|
|
|
/// Ensures that the Lua stack maintains its original height upon exit.
|
|
///
|
|
/// Use an instance of this class to check that a piece of code does not have
|
|
/// side-effects on the Lua stack.
|
|
///
|
|
/// To be used within a test case only.
|
|
class stack_balance_checker {
|
|
/// The Lua state.
|
|
lutok::state& _state;
|
|
|
|
/// Whether to install a sentinel on the stack for balance enforcement.
|
|
bool _with_sentinel;
|
|
|
|
/// The height of the stack on creation.
|
|
unsigned int _old_count;
|
|
|
|
public:
|
|
/// Constructs a new stack balance checker.
|
|
///
|
|
/// \param state_ The Lua state to validate.
|
|
/// \param with_sentinel_ If true, insert a sentinel item into the stack and
|
|
/// validate upon exit that the item is still there. This is an attempt
|
|
/// to ensure that already-existing items are not removed from the stack
|
|
/// by the code under test.
|
|
stack_balance_checker(lutok::state& state_,
|
|
const bool with_sentinel_ = true) :
|
|
_state(state_),
|
|
_with_sentinel(with_sentinel_),
|
|
_old_count(_state.get_top())
|
|
{
|
|
if (_with_sentinel)
|
|
_state.push_integer(987654321);
|
|
}
|
|
|
|
/// Destructor for the object.
|
|
///
|
|
/// If the stack height does not match the height when the instance was
|
|
/// created, this fails the test case.
|
|
~stack_balance_checker(void)
|
|
{
|
|
if (_with_sentinel) {
|
|
if (!_state.is_number() || _state.to_integer() != 987654321)
|
|
ATF_FAIL("Stack corrupted: sentinel not found");
|
|
_state.pop(1);
|
|
}
|
|
|
|
unsigned int new_count = _state.get_top();
|
|
if (_old_count != new_count)
|
|
//ATF_FAIL(F("Stack not balanced: before %d, after %d") %
|
|
// _old_count % new_count);
|
|
ATF_FAIL("Stack not balanced");
|
|
}
|
|
};
|
|
|
|
|
|
} // anonymous namespace
|