/**************************************************************************** ** ** Copyright (C) 2019 The Qt Company Ltd. ** Copyright (C) 2020 Intel Corporation. ** Contact: https://www.qt.io/licensing/ ** ** 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 The Qt Company. For licensing terms ** and conditions see https://www.qt.io/terms-conditions. For further ** information use the contact form at https://www.qt.io/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 3 as published by the Free Software ** Foundation and appearing in the file LICENSE.LGPL3 included in the ** packaging of this file. Please review the following information to ** ensure the GNU Lesser General Public License version 3 requirements ** will be met: https://www.gnu.org/licenses/lgpl-3.0.html. ** ** GNU General Public License Usage ** Alternatively, this file may be used under the terms of the GNU ** General Public License version 2.0 or (at your option) the GNU General ** Public license version 3 or any later version approved by the KDE Free ** Qt Foundation. The licenses are as published by the Free Software ** Foundation and appearing in the file LICENSE.GPL2 and LICENSE.GPL3 ** included in the packaging of this file. Please review the following ** information to ensure the GNU General Public License requirements will ** be met: https://www.gnu.org/licenses/gpl-2.0.html and ** https://www.gnu.org/licenses/gpl-3.0.html. ** ** $QT_END_LICENSE$ ** ****************************************************************************/ #ifndef QTEST_H #define QTEST_H #include #include #include #include #include #include #include #include #include #include #include #include #include #include #if QT_CONFIG(itemmodel) #include #endif #include #include #include #include #if defined(TESTCASE_LOWDPI) #include #endif #include #include #include #include #include QT_BEGIN_NAMESPACE namespace QTest { template <> inline char *toString(const QStringView &str) { return QTest::toPrettyUnicode(str); } template<> inline char *toString(const QString &str) { return toString(QStringView(str)); } template<> inline char *toString(const QLatin1String &str) { return toString(QString(str)); } template<> inline char *toString(const QByteArray &ba) { return QTest::toPrettyCString(ba.constData(), ba.length()); } template<> inline char *toString(const QBitArray &ba) { qsizetype size = ba.size(); char *str = new char[size + 1]; for (qsizetype i = 0; i < size; ++i) str[i] = "01"[ba.testBit(int(i))]; str[size] = '\0'; return str; } #if QT_CONFIG(datestring) template<> inline char *toString(const QTime &time) { return time.isValid() ? qstrdup(qPrintable(time.toString(u"hh:mm:ss.zzz"))) : qstrdup("Invalid QTime"); } template<> inline char *toString(const QDate &date) { return date.isValid() ? qstrdup(qPrintable(date.toString(u"yyyy/MM/dd"))) : qstrdup("Invalid QDate"); } template<> inline char *toString(const QDateTime &dateTime) { return dateTime.isValid() ? qstrdup(qPrintable(dateTime.toString(u"yyyy/MM/dd hh:mm:ss.zzz[t]"))) : qstrdup("Invalid QDateTime"); } #endif // datestring template<> inline char *toString(const QCborError &c) { // use the Q_ENUM formatting return toString(c.c); } template<> inline char *toString(const QChar &c) { const ushort uc = c.unicode(); if (uc < 128) { char msg[32] = {'\0'}; qsnprintf(msg, sizeof(msg), "QChar: '%c' (0x%x)", char(uc), unsigned(uc)); return qstrdup(msg); } return qstrdup(qPrintable(QString::fromLatin1("QChar: '%1' (0x%2)").arg(c).arg(QString::number(static_cast(c.unicode()), 16)))); } #if QT_CONFIG(itemmodel) template<> inline char *toString(const QModelIndex &idx) { char msg[128]; qsnprintf(msg, sizeof(msg), "QModelIndex(%d,%d,%p,%p)", idx.row(), idx.column(), idx.internalPointer(), idx.model()); return qstrdup(msg); } #endif template<> inline char *toString(const QPoint &p) { char msg[128] = {'\0'}; qsnprintf(msg, sizeof(msg), "QPoint(%d,%d)", p.x(), p.y()); return qstrdup(msg); } template<> inline char *toString(const QSize &s) { char msg[128] = {'\0'}; qsnprintf(msg, sizeof(msg), "QSize(%dx%d)", s.width(), s.height()); return qstrdup(msg); } template<> inline char *toString(const QRect &s) { char msg[256] = {'\0'}; qsnprintf(msg, sizeof(msg), "QRect(%d,%d %dx%d) (bottomright %d,%d)", s.left(), s.top(), s.width(), s.height(), s.right(), s.bottom()); return qstrdup(msg); } template<> inline char *toString(const QPointF &p) { char msg[64] = {'\0'}; qsnprintf(msg, sizeof(msg), "QPointF(%g,%g)", p.x(), p.y()); return qstrdup(msg); } template<> inline char *toString(const QSizeF &s) { char msg[64] = {'\0'}; qsnprintf(msg, sizeof(msg), "QSizeF(%gx%g)", s.width(), s.height()); return qstrdup(msg); } template<> inline char *toString(const QRectF &s) { char msg[256] = {'\0'}; qsnprintf(msg, sizeof(msg), "QRectF(%g,%g %gx%g) (bottomright %g,%g)", s.left(), s.top(), s.width(), s.height(), s.right(), s.bottom()); return qstrdup(msg); } template<> inline char *toString(const QUrl &uri) { if (!uri.isValid()) return qstrdup(qPrintable(QLatin1String("Invalid URL: ") + uri.errorString())); return qstrdup(uri.toEncoded().constData()); } template <> inline char *toString(const QUuid &uuid) { return qstrdup(uuid.toByteArray().constData()); } template<> inline char *toString(const QVariant &v) { QByteArray vstring("QVariant("); if (v.isValid()) { QByteArray type(v.typeName()); if (type.isEmpty()) { type = QByteArray::number(v.userType()); } vstring.append(type); if (!v.isNull()) { vstring.append(','); if (v.canConvert()) { vstring.append(v.toString().toLocal8Bit()); } else { vstring.append(""); } } } vstring.append(')'); return qstrdup(vstring.constData()); } namespace Internal { struct QCborValueFormatter { enum { BufferLen = 256 }; static char *formatSimpleType(QCborSimpleType st) { char *buf = new char[BufferLen]; qsnprintf(buf, BufferLen, "QCborValue(QCborSimpleType(%d))", int(st)); return buf; } static char *formatTag(QCborTag tag, const QCborValue &taggedValue) { QScopedArrayPointer hold(format(taggedValue)); char *buf = new char[BufferLen]; qsnprintf(buf, BufferLen, "QCborValue(QCborTag(%llu), %s)", tag, hold.get()); return buf; } static char *innerFormat(QCborValue::Type t, const char *str) { static const QMetaEnum typeEnum = []() { int idx = QCborValue::staticMetaObject.indexOfEnumerator("Type"); return QCborValue::staticMetaObject.enumerator(idx); }(); char *buf = new char[BufferLen]; const char *typeName = typeEnum.valueToKey(t); if (typeName) qsnprintf(buf, BufferLen, "QCborValue(%s, %s)", typeName, str); else qsnprintf(buf, BufferLen, "QCborValue()", t); return buf; } template static char *format(QCborValue::Type type, const T &t) { QScopedArrayPointer hold(QTest::toString(t)); return innerFormat(type, hold.get()); } static char *format(const QCborValue &v) { switch (v.type()) { case QCborValue::Integer: return format(v.type(), v.toInteger()); case QCborValue::ByteArray: return format(v.type(), v.toByteArray()); case QCborValue::String: return format(v.type(), v.toString()); case QCborValue::Array: return innerFormat(v.type(), QScopedArrayPointer(format(v.toArray())).get()); case QCborValue::Map: return innerFormat(v.type(), QScopedArrayPointer(format(v.toMap())).get()); case QCborValue::Tag: return formatTag(v.tag(), v.taggedValue()); case QCborValue::SimpleType: break; case QCborValue::True: return qstrdup("QCborValue(true)"); case QCborValue::False: return qstrdup("QCborValue(false)"); case QCborValue::Null: return qstrdup("QCborValue(nullptr)"); case QCborValue::Undefined: return qstrdup("QCborValue()"); case QCborValue::Double: return format(v.type(), v.toDouble()); case QCborValue::DateTime: case QCborValue::Url: case QCborValue::RegularExpression: return format(v.type(), v.taggedValue().toString()); case QCborValue::Uuid: return format(v.type(), v.toUuid()); case QCborValue::Invalid: return qstrdup("QCborValue()"); } if (v.isSimpleType()) return formatSimpleType(v.toSimpleType()); return innerFormat(v.type(), ""); } static char *format(const QCborArray &a) { QByteArray out(1, '['); const char *comma = ""; for (const QCborValueRef v : a) { QScopedArrayPointer s(format(v)); out += comma; out += s.get(); comma = ", "; } out += ']'; return qstrdup(out.constData()); } static char *format(const QCborMap &m) { QByteArray out(1, '{'); const char *comma = ""; for (auto pair : m) { QScopedArrayPointer key(format(pair.first)); QScopedArrayPointer value(format(pair.second)); out += comma; out += key.get(); out += ": "; out += value.get(); comma = ", "; } out += '}'; return qstrdup(out.constData()); } }; } template<> inline char *toString(const QCborValue &v) { return Internal::QCborValueFormatter::format(v); } template<> inline char *toString(const QCborValueRef &v) { return toString(QCborValue(v)); } template<> inline char *toString(const QCborArray &a) { return Internal::QCborValueFormatter::format(a); } template<> inline char *toString(const QCborMap &m) { return Internal::QCborValueFormatter::format(m); } template inline char *toString(const std::pair &pair) { const QScopedArrayPointer first(toString(pair.first)); const QScopedArrayPointer second(toString(pair.second)); return toString(QString::asprintf("std::pair(%s,%s)", first.data(), second.data())); } template inline char *toString(const Tuple & tuple, QtPrivate::IndexesList) { using UP = std::unique_ptr; // Generate a table of N + 1 elements where N is the number of // elements in the tuple. // The last element is needed to support the empty tuple use case. const UP data[] = { UP(toString(std::get(tuple)))..., UP{} }; return formatString("std::tuple(", ")", sizeof...(I), data[I].get()...); } template inline char *toString(const std::tuple &tuple) { static const std::size_t params_count = sizeof...(Types); return toString(tuple, typename QtPrivate::Indexes::Value()); } inline char *toString(std::nullptr_t) { return toString(QLatin1String("nullptr")); } template<> inline bool qCompare(QString const &t1, QLatin1String const &t2, const char *actual, const char *expected, const char *file, int line) { return qCompare(t1, QString(t2), actual, expected, file, line); } template<> inline bool qCompare(QLatin1String const &t1, QString const &t2, const char *actual, const char *expected, const char *file, int line) { return qCompare(QString(t1), t2, actual, expected, file, line); } namespace Internal { // Compare sequences of equal size template bool compareSequence(ActualIterator actualIt, ActualIterator actualEnd, ExpectedIterator expectedBegin, ExpectedIterator expectedEnd, const char *actual, const char *expected, const char *file, int line) { char msg[1024]; msg[0] = '\0'; const qsizetype actualSize = actualEnd - actualIt; const qsizetype expectedSize = expectedEnd - expectedBegin; bool isOk = actualSize == expectedSize; if (!isOk) { qsnprintf(msg, sizeof(msg), "Compared lists have different sizes.\n" " Actual (%s) size: %zd\n" " Expected (%s) size: %zd", actual, actualSize, expected, expectedSize); } for (auto expectedIt = expectedBegin; isOk && expectedIt < expectedEnd; ++actualIt, ++expectedIt) { if (!(*actualIt == *expectedIt)) { const qsizetype i = qsizetype(expectedIt - expectedBegin); char *val1 = QTest::toString(*actualIt); char *val2 = QTest::toString(*expectedIt); qsnprintf(msg, sizeof(msg), "Compared lists differ at index %zd.\n" " Actual (%s): %s\n" " Expected (%s): %s", i, actual, val1 ? val1 : "", expected, val2 ? val2 : ""); isOk = false; delete [] val1; delete [] val2; } } return compare_helper(isOk, msg, nullptr, nullptr, actual, expected, file, line); } #if defined(TESTCASE_LOWDPI) void disableHighDpi() { qputenv("QT_ENABLE_HIGHDPI_SCALING", "0"); } Q_CONSTRUCTOR_FUNCTION(disableHighDpi); #endif } // namespace Internal template inline bool qCompare(QList const &t1, QList const &t2, const char *actual, const char *expected, const char *file, int line) { return Internal::compareSequence(t1.cbegin(), t1.cend(), t2.cbegin(), t2.cend(), actual, expected, file, line); } template bool qCompare(QList const &t1, std::initializer_list t2, const char *actual, const char *expected, const char *file, int line) { return Internal::compareSequence(t1.cbegin(), t1.cend(), t2.cbegin(), t2.cend(), actual, expected, file, line); } // Compare QList against array template bool qCompare(QList const &t1, const T (& t2)[N], const char *actual, const char *expected, const char *file, int line) { return Internal::compareSequence(t1.cbegin(), t1.cend(), t2, t2 + N, actual, expected, file, line); } template <> inline bool qCompare(QStringList const &t1, QStringList const &t2, const char *actual, const char *expected, const char *file, int line) { return qCompare(t1, t2, actual, expected, file, line); } template inline bool qCompare(QFlags const &t1, T const &t2, const char *actual, const char *expected, const char *file, int line) { return qCompare(int(t1), int(t2), actual, expected, file, line); } template inline bool qCompare(QFlags const &t1, int const &t2, const char *actual, const char *expected, const char *file, int line) { return qCompare(int(t1), t2, actual, expected, file, line); } template<> inline bool qCompare(qint64 const &t1, qint32 const &t2, const char *actual, const char *expected, const char *file, int line) { return qCompare(t1, static_cast(t2), actual, expected, file, line); } template<> inline bool qCompare(qint64 const &t1, quint32 const &t2, const char *actual, const char *expected, const char *file, int line) { return qCompare(t1, static_cast(t2), actual, expected, file, line); } template<> inline bool qCompare(quint64 const &t1, quint32 const &t2, const char *actual, const char *expected, const char *file, int line) { return qCompare(t1, static_cast(t2), actual, expected, file, line); } template<> inline bool qCompare(qint32 const &t1, qint64 const &t2, const char *actual, const char *expected, const char *file, int line) { return qCompare(static_cast(t1), t2, actual, expected, file, line); } template<> inline bool qCompare(quint32 const &t1, qint64 const &t2, const char *actual, const char *expected, const char *file, int line) { return qCompare(static_cast(t1), t2, actual, expected, file, line); } template<> inline bool qCompare(quint32 const &t1, quint64 const &t2, const char *actual, const char *expected, const char *file, int line) { return qCompare(static_cast(t1), t2, actual, expected, file, line); } namespace Internal { template class HasInitMain // SFINAE test for the presence of initMain() { private: using YesType = char[1]; using NoType = char[2]; template static YesType& test( decltype(&C::initMain) ) ; template static NoType& test(...); public: enum { value = sizeof(test(nullptr)) == sizeof(YesType) }; }; template typename std::enable_if::value, void>::type callInitMain() { T::initMain(); } template typename std::enable_if::value, void>::type callInitMain() { } } // namespace Internal } // namespace QTest QT_END_NAMESPACE #ifdef QT_TESTCASE_BUILDDIR # define QTEST_SET_MAIN_SOURCE_PATH QTest::setMainSourcePath(__FILE__, QT_TESTCASE_BUILDDIR); #else # define QTEST_SET_MAIN_SOURCE_PATH QTest::setMainSourcePath(__FILE__); #endif // Hooks for coverage-testing of QTestLib itself: #if QT_CONFIG(testlib_selfcover) && defined(__COVERAGESCANNER__) struct QtCoverageScanner { QtCoverageScanner(const char *name) { __coveragescanner_clear(); __coveragescanner_testname(name); } ~QtCoverageScanner() { __coveragescanner_save(); __coveragescanner_testname(""); } }; #define TESTLIB_SELFCOVERAGE_START(name) QtCoverageScanner _qtCoverageScanner(name); #else #define TESTLIB_SELFCOVERAGE_START(name) #endif #define QTEST_APPLESS_MAIN(TestObject) \ int main(int argc, char *argv[]) \ { \ TESTLIB_SELFCOVERAGE_START(TestObject) \ TestObject tc; \ QTEST_SET_MAIN_SOURCE_PATH \ return QTest::qExec(&tc, argc, argv); \ } #include // Two backwards-compatibility defines for an obsolete feature: #define QTEST_ADD_GPU_BLACKLIST_SUPPORT_DEFS #define QTEST_ADD_GPU_BLACKLIST_SUPPORT // ### Qt 6: fully remove these. #if defined(QT_NETWORK_LIB) # include #endif #if defined(QT_WIDGETS_LIB) #include #ifdef QT_KEYPAD_NAVIGATION # define QTEST_DISABLE_KEYPAD_NAVIGATION QApplication::setNavigationMode(Qt::NavigationModeNone); #else # define QTEST_DISABLE_KEYPAD_NAVIGATION #endif #define QTEST_MAIN_IMPL(TestObject) \ TESTLIB_SELFCOVERAGE_START(#TestObject) \ QT_PREPEND_NAMESPACE(QTest::Internal::callInitMain)(); \ QApplication app(argc, argv); \ app.setAttribute(Qt::AA_Use96Dpi, true); \ QTEST_DISABLE_KEYPAD_NAVIGATION \ TestObject tc; \ QTEST_SET_MAIN_SOURCE_PATH \ return QTest::qExec(&tc, argc, argv); #elif defined(QT_GUI_LIB) #include #define QTEST_MAIN_IMPL(TestObject) \ TESTLIB_SELFCOVERAGE_START(#TestObject) \ QT_PREPEND_NAMESPACE(QTest::Internal::callInitMain)(); \ QGuiApplication app(argc, argv); \ app.setAttribute(Qt::AA_Use96Dpi, true); \ TestObject tc; \ QTEST_SET_MAIN_SOURCE_PATH \ return QTest::qExec(&tc, argc, argv); #else #define QTEST_MAIN_IMPL(TestObject) \ TESTLIB_SELFCOVERAGE_START(#TestObject) \ QT_PREPEND_NAMESPACE(QTest::Internal::callInitMain)(); \ QCoreApplication app(argc, argv); \ app.setAttribute(Qt::AA_Use96Dpi, true); \ TestObject tc; \ QTEST_SET_MAIN_SOURCE_PATH \ return QTest::qExec(&tc, argc, argv); #endif // QT_GUI_LIB #define QTEST_MAIN(TestObject) \ int main(int argc, char *argv[]) \ { \ QTEST_MAIN_IMPL(TestObject) \ } #define QTEST_GUILESS_MAIN(TestObject) \ int main(int argc, char *argv[]) \ { \ TESTLIB_SELFCOVERAGE_START(#TestObject) \ QT_PREPEND_NAMESPACE(QTest::Internal::callInitMain)(); \ QCoreApplication app(argc, argv); \ app.setAttribute(Qt::AA_Use96Dpi, true); \ TestObject tc; \ QTEST_SET_MAIN_SOURCE_PATH \ return QTest::qExec(&tc, argc, argv); \ } #endif