1 /****************************************************************************
3 ** Copyright (C) 2012 Nokia Corporation and/or its subsidiary(-ies).
4 ** Contact: http://www.qt-project.org/
6 ** This file is part of the test suite of the Qt Toolkit.
8 ** $QT_BEGIN_LICENSE:LGPL$
9 ** GNU Lesser General Public License Usage
10 ** This file may be used under the terms of the GNU Lesser General Public
11 ** License version 2.1 as published by the Free Software Foundation and
12 ** appearing in the file LICENSE.LGPL included in the packaging of this
13 ** file. Please review the following information to ensure the GNU Lesser
14 ** General Public License version 2.1 requirements will be met:
15 ** http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
17 ** In addition, as a special exception, Nokia gives you certain additional
18 ** rights. These rights are described in the Nokia Qt LGPL Exception
19 ** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.
21 ** GNU General Public License Usage
22 ** Alternatively, this file may be used under the terms of the GNU General
23 ** Public License version 3.0 as published by the Free Software Foundation
24 ** and appearing in the file LICENSE.GPL included in the packaging of this
25 ** file. Please review the following information to ensure the GNU General
26 ** Public License version 3.0 requirements will be met:
27 ** http://www.gnu.org/copyleft/gpl.html.
30 ** Alternatively, this file may be used in accordance with the terms and
31 ** conditions contained in a signed written agreement between you and Nokia.
40 ****************************************************************************/
42 #ifndef QUICKTESTRESULT_P_H
43 #define QUICKTESTRESULT_P_H
45 #include <QtQuickTest/quicktestglobal.h>
46 #include <QtCore/qobject.h>
47 #include <QtCore/qstring.h>
48 #include <QtCore/qstringlist.h>
49 #include <QtCore/qscopedpointer.h>
54 class QuickTestResultPrivate;
56 class Q_QUICK_TEST_EXPORT QuickTestResult : public QObject
60 Q_PROPERTY(QString testCaseName READ testCaseName WRITE setTestCaseName NOTIFY testCaseNameChanged)
61 Q_PROPERTY(QString functionName READ functionName WRITE setFunctionName NOTIFY functionNameChanged)
62 Q_PROPERTY(QString dataTag READ dataTag WRITE setDataTag NOTIFY dataTagChanged)
63 Q_PROPERTY(bool failed READ isFailed)
64 Q_PROPERTY(bool skipped READ isSkipped WRITE setSkipped NOTIFY skippedChanged)
65 Q_PROPERTY(int passCount READ passCount)
66 Q_PROPERTY(int failCount READ failCount)
67 Q_PROPERTY(int skipCount READ skipCount)
68 Q_PROPERTY(QStringList functionsToRun READ functionsToRun)
70 QuickTestResult(QObject *parent = 0);
73 // Values must match QBenchmarkIterationController::RunMode.
76 RepeatUntilValidMeasurement,
80 QString testCaseName() const;
81 void setTestCaseName(const QString &name);
83 QString functionName() const;
84 void setFunctionName(const QString &name);
86 QString dataTag() const;
87 void setDataTag(const QString &tag);
89 bool isFailed() const;
91 bool isSkipped() const;
92 void setSkipped(bool skip);
94 int passCount() const;
95 int failCount() const;
96 int skipCount() const;
98 QStringList functionsToRun() const;
106 void initTestTable();
107 void clearTestTable();
109 void finishTestData();
110 void finishTestDataCleanup();
111 void finishTestFunction();
113 void fail(const QString &message, const QUrl &location, int line);
114 bool verify(bool success, const QString &message,
115 const QUrl &location, int line);
116 bool compare(bool success, const QString &message,
117 const QString &val1, const QString &val2,
118 const QUrl &location, int line);
119 void skip(const QString &message, const QUrl &location, int line);
120 bool expectFail(const QString &tag, const QString &comment,
121 const QUrl &location, int line);
122 bool expectFailContinue(const QString &tag, const QString &comment,
123 const QUrl &location, int line);
124 void warn(const QString &message, const QUrl &location, int line);
126 void ignoreWarning(const QString &message);
131 void startMeasurement();
134 bool measurementAccepted();
135 bool needsMoreMeasurements();
137 void startBenchmark(RunMode runMode, const QString &tag);
138 bool isBenchmarkDone() const;
139 void nextBenchmark();
140 void stopBenchmark();
143 // Helper functions for the C++ main() shell.
144 static void parseArgs(int argc, char *argv[]);
145 static void setProgramName(const char *name);
146 static int exitCode();
149 void programNameChanged();
150 void testCaseNameChanged();
151 void functionNameChanged();
152 void dataTagChanged();
153 void skippedChanged();
156 QScopedPointer<QuickTestResultPrivate> d_ptr;
158 Q_DECLARE_PRIVATE(QuickTestResult)
159 Q_DISABLE_COPY(QuickTestResult)