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 reportAssertion(const TestContext& ctx, const Assertion& ass);
99 
104  void reportException(const TestContext& ctx, const std::exception& ex);
105 
110  void reportError(const TestContext& ctx);
111 
116  void reportMessage(const std::string& msg);
117 
118  void setParent(Test* test);
119 
120  Test* parent();
121 
122  const Test* parent() const;
123 
130  void attachReporter(Reporter& r);
131 
132  void detachReporter(Reporter& r);
133 
134  protected:
138  explicit Test(const std::string& name)
139  : _name(name)
140  , _parent(0)
141  { }
142 
143  private:
144  std::string _name;
145  Test* _parent;
146  std::list<Reporter*> _reporter;
147  };
148 
149 } // namespace unit
150 
151 } // namespace cxxtools
152 
153 #endif