LUMIERA.clone/src/lib/test/run.hpp
Ichthyostega 9dfd3fc981 phase out some use of auto_ptr
TODO: the toolfactory needs a redesign anyway,
this was just placeholder code added in a very early
state of the Lumiera project. We have way better memory
managing facilities at hand now
2014-09-15 02:03:10 +02:00

120 lines
3.1 KiB
C++

/*
RUN.hpp - helper class for grouping, registering and invoking testcases
Copyright (C) Lumiera.org
2008, Christian Thaeter <ct@pipapo.org>
Hermann Vosseler <Ichthyostega@web.de>
This program is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License as
published by the Free Software Foundation; either version 2 of
the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
*/
/** @file run.hpp
** Simple test class runner. Allows for writing unit tests as subclass of
** test::Test . They may be installed for automatic invocation through test::Suite
** by defining a Launcher instance, which can be done conveniently by the macro LAUNCHER
**
** @see HelloWorld_test
** @see test::Suite
** @see testrunner.cpp
** @see main.cpp
*/
#ifndef TESTHELPER_RUN_H
#define TESTHELPER_RUN_H
#include "proc/common.hpp"
#include "include/logging.h"
#include "lib/test/suite.hpp"
#include "lib/util.hpp"
#include <memory>
#include <string>
namespace test {
using std::string;
using std::shared_ptr;
typedef std::vector<string> & Arg;
/**
* Abstract Base Class for all testcases.
* Typically, such testcases are created by a Launcher.
*/
class Test
{
public:
virtual ~Test() {}
virtual void run(Arg arg) = 0;
};
/** interface: generic testcase creating functor. */
class Launcher
{
public:
virtual ~Launcher() {}
virtual shared_ptr<Test> makeInstance() =0;
};
/**
* Helper class for running a collection of tests.
* Launch objects are functors, which create on
* invocation an instance of the Test class
* they were created with. Creating such a
* Test Launcher internally registers this
* testcase with the Testsuite-Class,
* optionally under several groups
* (=categories, suite selections).
* @note a subclass of Launcher
*/
template<class TEST>
class Launch : public Launcher
{
public:
Launch (string testID, string groups)
{
Suite::enrol (this,testID,groups);
}
virtual shared_ptr<Test>
makeInstance () override
{
return shared_ptr<Test> (new TEST );
}
};
} // namespace test
// make them global for convenience
using ::test::Arg;
using ::test::Test;
using ::test::Launch;
// and provide shortcut for registration
#define LAUNCHER(_TEST_CLASS_, _GROUPS_) \
/** Register _TEST_CLASS_ to be invoked in some test suites (groups) _GROUPS_ */ \
Launch<_TEST_CLASS_> run_##_TEST_CLASS_##_(STRINGIFY(_TEST_CLASS_), _GROUPS_);
#endif