test.h
Go to the documentation of this file.
1 /*
2  * Copyright (C) 2005-2008 by Dr. Marc Boris Duerner
3  *
4  * This library is free software; you can redistribute it and/or
5  * modify it under the terms of the GNU Lesser General Public
6  * License as published by the Free Software Foundation; either
7  * version 2.1 of the License, or (at your option) any later version.
8  *
9  * As a special exception, you may use this file as part of a free
10  * software library without restriction. Specifically, if other files
11  * instantiate templates or use macros or inline functions from this
12  * file, or you compile this file and link it with other files to
13  * produce an executable, this file does not by itself cause the
14  * resulting executable to be covered by the GNU General Public
15  * License. This exception does not however invalidate any other
16  * reasons why the executable file might be covered by the GNU Library
17  * General Public License.
18  *
19  * This library is distributed in the hope that it will be useful,
20  * but WITHOUT ANY WARRANTY; without even the implied warranty of
21  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
22  * Lesser General Public License for more details.
23  *
24  * You should have received a copy of the GNU Lesser General Public
25  * License along with this library; if not, write to the Free Software
26  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
27  */
28 #ifndef CXXTOOLS_UNIT_TEST_H
29 #define CXXTOOLS_UNIT_TEST_H
30 
31 #include <cxxtools/unit/reporter.h>
33 #include <cxxtools/connectable.h>
34 #include <cxxtools/noncopyable.h>
35 #include <string>
36 
37 namespace cxxtools {
38 
39 namespace unit {
40 
41  class TestContext;
42 
51  class Test : public Connectable,
52  protected NonCopyable
53  {
54  public:
57  virtual ~Test()
58  { }
59 
73  virtual void run() = 0;
74 
75  const std::string& name() const;
76 
79  void reportStart(const TestContext& ctx);
80 
86  void reportFinish(const TestContext& ctx);
87 
92  void reportSuccess(const TestContext& ctx);
93 
98  void reportSkip(const TestContext& ctx);
99 
104  void reportAssertion(const TestContext& ctx, const Assertion& ass);
105 
110  void reportException(const TestContext& ctx, const std::exception& ex);
111 
116  void reportError(const TestContext& ctx);
117 
122  void reportMessage(const std::string& msg);
123 
124  void setParent(Test* test);
125 
126  Test* parent();
127 
128  const Test* parent() const;
129 
136  void attachReporter(Reporter& r);
137 
138  void detachReporter(Reporter& r);
139 
140  protected:
144  explicit Test(const std::string& name)
145  : _name(name)
146  , _parent(0)
147  { }
148 
149  private:
150  std::string _name;
151  Test* _parent;
152  std::list<Reporter*> _reporter;
153  };
154 
155 } // namespace unit
156 
157 } // namespace cxxtools
158 
159 #endif