diff options
author | Thiago Macieira <thiago.macieira@intel.com> | 2013-12-20 11:14:04 -0800 |
---|---|---|
committer | The Qt Project <gerrit-noreply@qt-project.org> | 2014-02-14 00:34:25 +0100 |
commit | 8dcb72fd1e2c17ad000474496b6d000580e0a943 (patch) | |
tree | 7e210404d51d2aff3fc6cdd92938071701acc0b1 /src/testlib | |
parent | 539196689e806f8c175bb50343a4dc2cab52e838 (diff) |
Add a CSV logging feature to the benchlib
This is only useful for logging benchmarks, since it won't print test
passes, failures, etc. It's useful for importing to spreadsheets to do
number-crunching.
[ChangeLog][QtTest]Added a CSV logging mode that is suitable for
importing benchmark results into spreadsheets. This can be enabled by
the -csv option on the command-line. The CSV logging mode will not print
test failures, debug messages, warnings, etc.
Change-Id: I245d6f86bb380645c9bc0d748cf474b3ed42cab8
Reviewed-by: Sergio Ahumada <sahumada@blackberry.com>
Reviewed-by: Jason McDonald <macadder1@gmail.com>
Diffstat (limited to 'src/testlib')
-rw-r--r-- | src/testlib/doc/src/qttestlib-manual.qdoc | 3 | ||||
-rw-r--r-- | src/testlib/qcsvbenchmarklogger.cpp | 103 | ||||
-rw-r--r-- | src/testlib/qcsvbenchmarklogger_p.h | 82 | ||||
-rw-r--r-- | src/testlib/qtestcase.cpp | 8 | ||||
-rw-r--r-- | src/testlib/qtestlog.cpp | 4 | ||||
-rw-r--r-- | src/testlib/qtestlog_p.h | 2 | ||||
-rw-r--r-- | src/testlib/testlib.pro | 3 |
7 files changed, 202 insertions, 3 deletions
diff --git a/src/testlib/doc/src/qttestlib-manual.qdoc b/src/testlib/doc/src/qttestlib-manual.qdoc index bdd9769175..13654972ec 100644 --- a/src/testlib/doc/src/qttestlib-manual.qdoc +++ b/src/testlib/doc/src/qttestlib-manual.qdoc @@ -186,6 +186,9 @@ Outputs results as a stream of XML tags. \li \c -xunitxml \br Outputs results as an Xunit XML document. + \li \c -csv \br + Outputs results as comma-separated values (CSV). This mode is only suitable for + benchmarks, since it suppresses normal pass/fail messages. \endlist The first version of the \c -o option may be repeated in order to log diff --git a/src/testlib/qcsvbenchmarklogger.cpp b/src/testlib/qcsvbenchmarklogger.cpp new file mode 100644 index 0000000000..ae5c3183dc --- /dev/null +++ b/src/testlib/qcsvbenchmarklogger.cpp @@ -0,0 +1,103 @@ +/**************************************************************************** +** +** Copyright (C) 2013 Intel Corporation +** Contact: http://www.qt-project.org/legal +** +** This file is part of the QtTest module of the Qt Toolkit. +** +** $QT_BEGIN_LICENSE:LGPL$ +** Commercial License Usage +** Licensees holding valid commercial Qt licenses may use this file in +** accordance with the commercial license agreement provided with the +** Software or, alternatively, in accordance with the terms contained in +** a written agreement between you and Digia. For licensing terms and +** conditions see http://qt.digia.com/licensing. For further information +** use the contact form at http://qt.digia.com/contact-us. +** +** GNU Lesser General Public License Usage +** Alternatively, this file may be used under the terms of the GNU Lesser +** General Public License version 2.1 as published by the Free Software +** Foundation and appearing in the file LICENSE.LGPL included in the +** packaging of this file. Please review the following information to +** ensure the GNU Lesser General Public License version 2.1 requirements +** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html. +** +** In addition, as a special exception, Digia gives you certain additional +** rights. These rights are described in the Digia Qt LGPL Exception +** version 1.1, included in the file LGPL_EXCEPTION.txt in this package. +** +** GNU General Public License Usage +** Alternatively, this file may be used under the terms of the GNU +** General Public License version 3.0 as published by the Free Software +** Foundation and appearing in the file LICENSE.GPL included in the +** packaging of this file. Please review the following information to +** ensure the GNU General Public License version 3.0 requirements will be +** met: http://www.gnu.org/copyleft/gpl.html. +** +** +** $QT_END_LICENSE$ +** +****************************************************************************/ + +#include "qcsvbenchmarklogger_p.h" +#include "qtestresult_p.h" +#include "qbenchmark_p.h" + +QCsvBenchmarkLogger::QCsvBenchmarkLogger(const char *filename) + : QAbstractTestLogger(filename) +{ +} + +QCsvBenchmarkLogger::~QCsvBenchmarkLogger() +{ +} + +void QCsvBenchmarkLogger::startLogging() +{ + // don't print anything +} + +void QCsvBenchmarkLogger::stopLogging() +{ + // don't print anything +} + +void QCsvBenchmarkLogger::enterTestFunction(const char *) +{ + // don't print anything +} + +void QCsvBenchmarkLogger::leaveTestFunction() +{ + // don't print anything +} + +void QCsvBenchmarkLogger::addIncident(QAbstractTestLogger::IncidentTypes, const char *, const char *, int) +{ + // don't print anything +} + +void QCsvBenchmarkLogger::addBenchmarkResult(const QBenchmarkResult &result) +{ + const char *fn = QTestResult::currentTestFunction() ? QTestResult::currentTestFunction() + : "UnknownTestFunc"; + const char *tag = QTestResult::currentDataTag() ? QTestResult::currentDataTag() : ""; + const char *gtag = QTestResult::currentGlobalDataTag() + ? QTestResult::currentGlobalDataTag() + : ""; + const char *filler = (tag[0] && gtag[0]) ? ":" : ""; + + const char *metric = QTest::benchmarkMetricName(result.metric); + + char buf[1024]; + // "function","[globaltag:]tag","metric",value_per_iteration,total,iterations + qsnprintf(buf, sizeof(buf), "\"%s\",\"%s%s%s\",\"%s\",%.13g,%.13g,%u\n", + fn, gtag, filler, tag, metric, + result.value / result.iterations, result.value, result.iterations); + outputString(buf); +} + +void QCsvBenchmarkLogger::addMessage(QAbstractTestLogger::MessageTypes, const QString &, const char *, int) +{ + // don't print anything +} diff --git a/src/testlib/qcsvbenchmarklogger_p.h b/src/testlib/qcsvbenchmarklogger_p.h new file mode 100644 index 0000000000..89692de972 --- /dev/null +++ b/src/testlib/qcsvbenchmarklogger_p.h @@ -0,0 +1,82 @@ +/**************************************************************************** +** +** Copyright (C) 2013 Intel Corporation +** Contact: http://www.qt-project.org/legal +** +** This file is part of the QtTest module of the Qt Toolkit. +** +** $QT_BEGIN_LICENSE:LGPL$ +** Commercial License Usage +** Licensees holding valid commercial Qt licenses may use this file in +** accordance with the commercial license agreement provided with the +** Software or, alternatively, in accordance with the terms contained in +** a written agreement between you and Digia. For licensing terms and +** conditions see http://qt.digia.com/licensing. For further information +** use the contact form at http://qt.digia.com/contact-us. +** +** GNU Lesser General Public License Usage +** Alternatively, this file may be used under the terms of the GNU Lesser +** General Public License version 2.1 as published by the Free Software +** Foundation and appearing in the file LICENSE.LGPL included in the +** packaging of this file. Please review the following information to +** ensure the GNU Lesser General Public License version 2.1 requirements +** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html. +** +** In addition, as a special exception, Digia gives you certain additional +** rights. These rights are described in the Digia Qt LGPL Exception +** version 1.1, included in the file LGPL_EXCEPTION.txt in this package. +** +** GNU General Public License Usage +** Alternatively, this file may be used under the terms of the GNU +** General Public License version 3.0 as published by the Free Software +** Foundation and appearing in the file LICENSE.GPL included in the +** packaging of this file. Please review the following information to +** ensure the GNU General Public License version 3.0 requirements will be +** met: http://www.gnu.org/copyleft/gpl.html. +** +** +** $QT_END_LICENSE$ +** +****************************************************************************/ + +#ifndef QCSVBENCHMARKLOGGER_P_H +#define QCSVBENCHMARKLOGGER_P_H + +// +// W A R N I N G +// ------------- +// +// This file is not part of the Qt API. It exists purely as an +// implementation detail. This header file may change from version to +// version without notice, or even be removed. +// +// We mean it. +// + +#include "qabstracttestlogger_p.h" + +QT_BEGIN_NAMESPACE + +class QCsvBenchmarkLogger : public QAbstractTestLogger +{ +public: + QCsvBenchmarkLogger(const char *filename); + ~QCsvBenchmarkLogger(); + + void startLogging() Q_DECL_OVERRIDE; + void stopLogging() Q_DECL_OVERRIDE; + + void enterTestFunction(const char *function) Q_DECL_OVERRIDE; + void leaveTestFunction() Q_DECL_OVERRIDE; + + void addIncident(IncidentTypes type, const char *description, + const char *file = 0, int line = 0) Q_DECL_OVERRIDE; + void addBenchmarkResult(const QBenchmarkResult &result) Q_DECL_OVERRIDE; + + void addMessage(MessageTypes type, const QString &message, + const char *file = 0, int line = 0) Q_DECL_OVERRIDE; +}; + +QT_END_NAMESPACE + +#endif // QCSVBENCHMARKLOGGER_P_H diff --git a/src/testlib/qtestcase.cpp b/src/testlib/qtestcase.cpp index 224357dd85..0d7a017f89 100644 --- a/src/testlib/qtestcase.cpp +++ b/src/testlib/qtestcase.cpp @@ -1320,6 +1320,7 @@ Q_TESTLIB_EXPORT void qtest_qParseArgs(int argc, char *argv[], bool qml) " Use - to output to stdout\n" " Valid formats are:\n" " txt : Plain text\n" + " csv : CSV format (suitable for benchmarks)\n" " xunitxml : XML XUnit document\n" " xml : XML document\n" " lightxml : A stream of XML tags\n" @@ -1329,6 +1330,7 @@ Q_TESTLIB_EXPORT void qtest_qParseArgs(int argc, char *argv[], bool qml) " Old-style logging options:\n" " -o filename : Write the output into file\n" " -txt : Output results in Plain Text\n" + " -csv : Output results in a CSV format (suitable for benchmarks)\n" " -xunitxml : Output results as XML XUnit document\n" " -xml : Output results as XML document\n" " -lightxml : Output results as stream of XML tags\n" @@ -1408,6 +1410,8 @@ Q_TESTLIB_EXPORT void qtest_qParseArgs(int argc, char *argv[], bool qml) } } else if (strcmp(argv[i], "-txt") == 0) { logFormat = QTestLog::Plain; + } else if (strcmp(argv[i], "-csv") == 0) { + logFormat = QTestLog::CSV; } else if (strcmp(argv[i], "-xunitxml") == 0) { logFormat = QTestLog::XunitXML; } else if (strcmp(argv[i], "-xml") == 0) { @@ -1438,6 +1442,8 @@ Q_TESTLIB_EXPORT void qtest_qParseArgs(int argc, char *argv[], bool qml) // New-style if (strcmp(format, "txt") == 0) logFormat = QTestLog::Plain; + else if (strcmp(format, "csv") == 0) + logFormat = QTestLog::CSV; else if (strcmp(format, "lightxml") == 0) logFormat = QTestLog::LightXML; else if (strcmp(format, "xml") == 0) @@ -1445,7 +1451,7 @@ Q_TESTLIB_EXPORT void qtest_qParseArgs(int argc, char *argv[], bool qml) else if (strcmp(format, "xunitxml") == 0) logFormat = QTestLog::XunitXML; else { - fprintf(stderr, "output format must be one of txt, lightxml, xml or xunitxml\n"); + fprintf(stderr, "output format must be one of txt, csv, lightxml, xml or xunitxml\n"); exit(1); } if (strcmp(filename, "-") == 0 && QTestLog::loggerUsingStdout()) { diff --git a/src/testlib/qtestlog.cpp b/src/testlib/qtestlog.cpp index 74947b3f3a..8cca892a4d 100644 --- a/src/testlib/qtestlog.cpp +++ b/src/testlib/qtestlog.cpp @@ -45,6 +45,7 @@ #include <QtTest/private/qtestresult_p.h> #include <QtTest/private/qabstracttestlogger_p.h> #include <QtTest/private/qplaintestlogger_p.h> +#include <QtTest/private/qcsvbenchmarklogger_p.h> #include <QtTest/private/qxunittestlogger_p.h> #include <QtTest/private/qxmltestlogger_p.h> #include <QtCore/qatomic.h> @@ -452,6 +453,9 @@ void QTestLog::addLogger(LogMode mode, const char *filename) case QTestLog::Plain: logger = new QPlainTestLogger(filename); break; + case QTestLog::CSV: + logger = new QCsvBenchmarkLogger(filename); + break; case QTestLog::XML: logger = new QXmlTestLogger(QXmlTestLogger::Complete, filename); break; diff --git a/src/testlib/qtestlog_p.h b/src/testlib/qtestlog_p.h index bd83870934..a987c45806 100644 --- a/src/testlib/qtestlog_p.h +++ b/src/testlib/qtestlog_p.h @@ -63,7 +63,7 @@ class QRegularExpression; class Q_TESTLIB_EXPORT QTestLog { public: - enum LogMode { Plain = 0, XML, LightXML, XunitXML }; + enum LogMode { Plain = 0, XML, LightXML, XunitXML, CSV }; static void enterTestFunction(const char* function); static void leaveTestFunction(); diff --git a/src/testlib/testlib.pro b/src/testlib/testlib.pro index 571e3b2fca..1fb6d6df18 100644 --- a/src/testlib/testlib.pro +++ b/src/testlib/testlib.pro @@ -33,7 +33,7 @@ HEADERS = qbenchmark.h \ qtestmouse.h \ qtestspontaneevent.h \ qtestsystem.h \ - qtesttouch.h \ + qtesttouch.h SOURCES = qtestcase.cpp \ qtestlog.cpp \ @@ -51,6 +51,7 @@ SOURCES = qtestcase.cpp \ qbenchmarkevent.cpp \ qbenchmarkperfevents.cpp \ qbenchmarkmetric.cpp \ + qcsvbenchmarklogger.cpp \ qtestelement.cpp \ qtestelementattribute.cpp \ qtestxunitstreamer.cpp \ |