summaryrefslogtreecommitdiffstats
path: root/kunittest/module.h
blob: e338871017ff31c10a70e171c5d4530751356eb7 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
/*
 * Copyright (C)  2005  Jeroen Wijnhout <Jeroen.Wijnhout@kdemail.net>
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions
 * are met:
 *
 * 1. Redistributions of source code must retain the above copyright
 *   notice, this list of conditions and the following disclaimer.
 * 2. 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.
 *
 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``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 AUTHOR 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 module.h
 * Provides macros to ease building unit tests as shared libraries
 */

#ifndef KUNITTEST_MODULE_H
#define KUNITTEST_MODULE_H

#include <qstring.h>

#include <klibloader.h>
#include <kunittest/runner.h>

namespace KUnitTest
{
    /*! @def KUNITTEST_MODULE(library,suite)
    * Use this macro if you are creating a KUnitTest module named library. 
    * This macro creates a module-class named a factory class. The module
    * will appear under the name suite in the test runner.
    * There is no need in calling the K_EXPORT_COMPONENT_FACTORY macro,
    * this is taken care of automatically.
    * 
    * @code KUNITTEST_MODULE(kunittest_samplemodule,"TestSuite") @endcode
    */
    #define KUNITTEST_MODULE(library,suite)                                                 \
    static const QString s_kunittest_suite  = QString::fromLatin1(suite);                   \
    class library##Module : public QObject                                                  \
    {                                                                                       \
    public:                                                                                 \
        library##Module()                                                                   \
        {                                                                                   \
            KUnitTest::RegistryIteratorType it(s_registry);                                 \
            for( ; it.current(); ++it )                                                     \
                KUnitTest::Runner::registerTester(it.currentKey(), it.current());           \
        }                                                                                   \
                                                                                            \
        static KUnitTest::RegistryType s_registry;                                          \
    };                                                                                      \
                                                                                            \
    KUnitTest::RegistryType library##Module::s_registry;                                    \
                                                                                            \
    void kunittest_registerModuleTester(const char *name, KUnitTest::Tester *test)          \
    {                                                                                       \
        library##Module::s_registry.insert(name, test);                                     \
    }                                                                                       \
                                                                                            \
    class module##Factory : public KLibFactory                                              \
    {                                                                                       \
    public:                                                                                 \
        QObject *createObject (QObject *, const char *, const char *, const QStringList &)  \
        {                                                                                   \
            return new library##Module();                                                   \
        };                                                                                  \
    };                                                                                      \
                                                                                            \
    K_EXPORT_COMPONENT_FACTORY( library, module##Factory )

    /*! @def KUNITTEST_MODULE_REGISTER_TESTER(tester)
    * Use this macro to add a tester class to your module. The name of the tester will
    * be identical to the class name.
    *
    * @code KUNITTEST_MODULE_REGISTER_TESTER(SimpleSampleTester) @endcode
    */
    #define KUNITTEST_MODULE_REGISTER_TESTER( tester)                                           \
    static class tester##ModuleAutoregister                                                     \
    {                                                                                           \
    public:                                                                                     \
        tester##ModuleAutoregister()                                                            \
        {                                                                                       \
            KUnitTest::Tester *test = new tester();                                             \
            QString name = s_kunittest_suite + QString::fromLatin1("::") + QString::fromLocal8Bit(#tester); \
            test->setName(name.local8Bit());                                                    \
            kunittest_registerModuleTester(name.local8Bit(), test );                            \
        }                                                                                       \
    } tester##ModuleAutoregisterInstance;

    /*! @def KUNITTEST_MODULE_REGISTER_NAMEDTESTER(name,tester)
    * Use this macro to add a tester class, with specified name, to your module..
    *
    * @code KUNITTEST_MODULE_REGISTER_TESTER("SubSuite::PrettyName",SimpleSampleTester) @endcode
    */
    #define KUNITTEST_MODULE_REGISTER_NAMEDTESTER( name , tester)                             \
    static class tester##ModuleAutoregister                                                   \
    {                                                                                         \
    public:                                                                                   \
        tester##ModuleAutoregister()                                                          \
        {                                                                                     \
            QString fullName = s_kunittest_suite + QString("::") + QString::fromLocal8Bit(name); \
            KUnitTest::Tester *test = new tester(fullName.local8Bit());                       \
            kunittest_registerModuleTester(fullName.local8Bit(), test);                       \
        }                                                                                     \
    } tester##ModuleAutoregisterInstance;
}

#endif