From 6d4f2486d55d706863508fdcae9a5368692de494 Mon Sep 17 00:00:00 2001 From: Casper van Donderen Date: Tue, 8 May 2012 11:33:17 +0200 Subject: Doc: Modularize QtTest documentation. This change moves the snippets to the modularized directories. Change-Id: I917dd1dae5ee5d4b6bd5a0390783a8b9a99edc06 Reviewed-by: Marius Storm-Olsen --- doc/src/snippets/code/doc_src_qsignalspy.cpp | 81 -------- doc/src/snippets/code/doc_src_qtestevent.cpp | 51 ----- doc/src/snippets/code/src_qtestlib_qtestcase.cpp | 250 ----------------------- 3 files changed, 382 deletions(-) delete mode 100644 doc/src/snippets/code/doc_src_qsignalspy.cpp delete mode 100644 doc/src/snippets/code/doc_src_qtestevent.cpp delete mode 100644 doc/src/snippets/code/src_qtestlib_qtestcase.cpp (limited to 'doc/src') diff --git a/doc/src/snippets/code/doc_src_qsignalspy.cpp b/doc/src/snippets/code/doc_src_qsignalspy.cpp deleted file mode 100644 index a957285cea..0000000000 --- a/doc/src/snippets/code/doc_src_qsignalspy.cpp +++ /dev/null @@ -1,81 +0,0 @@ -/**************************************************************************** -** -** Copyright (C) 2012 Nokia Corporation and/or its subsidiary(-ies). -** Contact: http://www.qt-project.org/ -** -** This file is part of the documentation of the Qt Toolkit. -** -** $QT_BEGIN_LICENSE:BSD$ -** You may use this file under the terms of the BSD license as follows: -** -** "Redistribution and use in source and binary forms, with or without -** modification, are permitted provided that the following conditions are -** met: -** * Redistributions of source code must retain the above copyright -** notice, this list of conditions and the following disclaimer. -** * 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. -** * Neither the name of Nokia Corporation and its Subsidiary(-ies) nor -** the names of its contributors may be used to endorse or promote -** products derived from this software without specific prior written -** permission. -** -** THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS -** "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 COPYRIGHT -** OWNER OR CONTRIBUTORS 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." -** -** $QT_END_LICENSE$ -** -****************************************************************************/ - -//! [0] -QCheckBox *box = ...; -QSignalSpy spy(box, SIGNAL(clicked(bool))); - -// do something that triggers the signal -box->animateClick(); - -QCOMPARE(spy.count(), 1); // make sure the signal was emitted exactly one time -QList arguments = spy.takeFirst(); // take the first signal - -QVERIFY(arguments.at(0).toBool() == true); // verify the first argument -//! [0] - - -//! [1] -QSignalSpy spy(myCustomObject, SIGNAL(mySignal(int, QString, double))); - -myCustomObject->doSomething(); // trigger emission of the signal - -QList arguments = spy.takeFirst(); -QVERIFY(arguments.at(0).type() == QVariant::Int); -QVERIFY(arguments.at(1).type() == QVariant::QString); -QVERIFY(arguments.at(2).type() == QVariant::double); -//! [1] - - -//! [2] -qRegisterMetaType("QModelIndex"); -QSignalSpy spy(&model, SIGNAL(whatever(QModelIndex))); -//! [2] - - -//! [3] -// get the first argument from the first received signal: -QModelIndex result = qvariant_cast(spy.at(0).at(0)); -//! [3] - - -//! [4] -QSignalSpy spy(myPushButton, SIGNAL(clicked(bool))); -//! [4] diff --git a/doc/src/snippets/code/doc_src_qtestevent.cpp b/doc/src/snippets/code/doc_src_qtestevent.cpp deleted file mode 100644 index 787a8e666b..0000000000 --- a/doc/src/snippets/code/doc_src_qtestevent.cpp +++ /dev/null @@ -1,51 +0,0 @@ -/**************************************************************************** -** -** Copyright (C) 2012 Nokia Corporation and/or its subsidiary(-ies). -** Contact: http://www.qt-project.org/ -** -** This file is part of the documentation of the Qt Toolkit. -** -** $QT_BEGIN_LICENSE:BSD$ -** You may use this file under the terms of the BSD license as follows: -** -** "Redistribution and use in source and binary forms, with or without -** modification, are permitted provided that the following conditions are -** met: -** * Redistributions of source code must retain the above copyright -** notice, this list of conditions and the following disclaimer. -** * 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. -** * Neither the name of Nokia Corporation and its Subsidiary(-ies) nor -** the names of its contributors may be used to endorse or promote -** products derived from this software without specific prior written -** permission. -** -** THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS -** "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 COPYRIGHT -** OWNER OR CONTRIBUTORS 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." -** -** $QT_END_LICENSE$ -** -****************************************************************************/ - -//! [0] -QTestEventList events; -events.addKeyClick('a'); -events.addKeyClick(Qt::Key_Backspace); -events.addDelay(200); - -QLineEdit *lineEdit = new QLineEdit(myParent); -... -events.simulate(lineEdit); -events.simulate(lineEdit); -//! [0] diff --git a/doc/src/snippets/code/src_qtestlib_qtestcase.cpp b/doc/src/snippets/code/src_qtestlib_qtestcase.cpp deleted file mode 100644 index 2c6565edf5..0000000000 --- a/doc/src/snippets/code/src_qtestlib_qtestcase.cpp +++ /dev/null @@ -1,250 +0,0 @@ -/**************************************************************************** -** -** Copyright (C) 2012 Nokia Corporation and/or its subsidiary(-ies). -** Contact: http://www.qt-project.org/ -** -** This file is part of the documentation of the Qt Toolkit. -** -** $QT_BEGIN_LICENSE:BSD$ -** You may use this file under the terms of the BSD license as follows: -** -** "Redistribution and use in source and binary forms, with or without -** modification, are permitted provided that the following conditions are -** met: -** * Redistributions of source code must retain the above copyright -** notice, this list of conditions and the following disclaimer. -** * 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. -** * Neither the name of Nokia Corporation and its Subsidiary(-ies) nor -** the names of its contributors may be used to endorse or promote -** products derived from this software without specific prior written -** permission. -** -** THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS -** "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 COPYRIGHT -** OWNER OR CONTRIBUTORS 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." -** -** $QT_END_LICENSE$ -** -****************************************************************************/ - - -void wrapInFunction() -{ - -//! [0] -QVERIFY(1 + 1 == 2); -//! [0] - - -//! [1] -QVERIFY2(1 + 1 == 2, "A breach in basic arithmetic occurred."); -//! [1] - - -//! [2] -QCOMPARE(QString("hello").toUpper(), QString("HELLO")); -//! [2] - - -//! [3] -void TestQString::toInt_data() -{ - QTest::addColumn("aString"); - QTest::addColumn("expected"); - - QTest::newRow("positive value") << "42" << 42; - QTest::newRow("negative value") << "-42" << -42; - QTest::newRow("zero") << "0" << 0; -} -//! [3] - - -//! [4] -void TestQString::toInt() -{ - QFETCH(QString, aString); - QFETCH(int, expected); - - QCOMPARE(aString.toInt(), expected); -} -//! [4] - - -//! [5] -if (sizeof(int) != 4) - QFAIL("This test has not been ported to this platform yet."); -//! [5] - - -//! [6] -QFETCH(QString, myString); -QCOMPARE(QString("hello").toUpper(), myString); -//! [6] - - -//! [7] -QTEST(QString("hello").toUpper(), "myString"); -//! [7] - - -//! [8] -if (!QSqlDatabase::drivers().contains("SQLITE")) - QSKIP("This test requires the SQLITE database driver"); -//! [8] - - -//! [9] -QEXPECT_FAIL("", "Will fix in the next release", Continue); -QCOMPARE(i, 42); -QCOMPARE(j, 43); -//! [9] - - -//! [10] -QEXPECT_FAIL("data27", "Oh my, this is soooo broken", Abort); -QCOMPARE(i, 42); -//! [10] - - -//! [11] -class TestQString: public QObject { ... }; -QTEST_MAIN(TestQString) -//! [11] - - -//! [13] -QTest::keyClick(myWidget, 'a'); -//! [13] - - -//! [14] -QTest::keyClick(myWidget, Qt::Key_Escape); - -QTest::keyClick(myWidget, Qt::Key_Escape, Qt::ShiftModifier, 200); -//! [14] - - -//! [15] -QTest::keyClicks(myWidget, "hello world"); -//! [15] - - -//! [16] -namespace QTest { - template<> - char *toString(const MyPoint &point) - { - QByteArray ba = "MyPoint("; - ba += QByteArray::number(point.x()) + ", " + QByteArray::number(point.y()); - ba += ")"; - return qstrdup(ba.data()); - } -} -//! [16] - - -//! [17] -int i = 0; -while (myNetworkServerNotResponding() && i++ < 50) - QTest::qWait(250); -//! [17] - - -//! [18] -MyTestObject test1; -QTest::qExec(&test1); -//! [18] - - -//! [19] -QDir dir; - -QTest::ignoreMessage(QtWarningMsg, "QDir::mkdir: Empty or null file name(s)"); -dir.mkdir(""); -//! [19] - - -//! [20] -void myTestFunction_data() -{ - QTest::addColumn("aString"); - QTest::newRow("just hello") << QString("hello"); - QTest::newRow("a null string") << QString(); -} -//! [20] - - -//! [21] -void myTestFunction_data() { - QTest::addColumn("intval"); - QTest::addColumn("str"); - QTest::addColumn("dbl"); - - QTest::newRow("row1") << 1 << "hello" << 1.5; -} -//! [21] - - -//! [22] -void MyTestClass::cleanup() -{ - if (qstrcmp(currentTestFunction(), "myDatabaseTest") == 0) { - // clean up all database connections - closeAllDatabases(); - } -} -//! [22] - - -//! [23] -QTest::qSleep(250); -//! [23] - -//! [24] -QWidget widget; -widget.show(); -QTest::qWaitForWindowShown(&widget); -//! [24] - -//! [25] -QWidget widget; - -QTest::touchEvent(&widget) - .press(0, QPoint(10, 10)); -QTest::touchEvent(&widget) - .stationary(0) - .press(1, QPoint(40, 10)); -QTest::touchEvent(&widget) - .move(0, QPoint(12, 12)) - .move(1, QPoint(45, 5)); -QTest::touchEvent(&widget) - .release(0) - .release(1); -//! [25] - - -//! [26] -// Source: /home/user/sources/myxmlparser/tests/tst_myxmlparser/tst_myxmlparser.cpp -// Build: /home/user/build/myxmlparser/tests/tst_myxmlparser -// Qt: /usr/local/Qt-5.0.0 -void tst_MyXmlParser::parse() -{ - MyXmlParser parser; - QString input = QFINDTESTDATA("testxml/simple1.xml"); - QVERIFY(parser.parse(input)); -} -//! [26] - -} - -- cgit v1.2.3