QTestLib Manual

Creating a test

To create a test, subclass QObject and add one or more private slots to it. Each private slot is a testfunction in your test. QTest::qExec() can be used to execute all testfunctions in the test object.

In addition, there are four private slots that are not treated as testfunctions. They will be executed by the testing framework and can be used to initialize and clean up either the entire test or the current test function.

• initTestCase() will be called before the first testfunction is executed.
• cleanupTestCase() will be called after the last testfunction was executed.
• init() will be called before each testfunction is executed.
• cleanup() will be called after every testfunction.

If initTestCase() fails, no testfunction will be executed. If init() fails, the following testfunction will not be executed, the test will proceed to the next testfunction.

Example:

    class MyFirstTest: public QObject
    {
        Q_OBJECT
    private slots:
        void initTestCase()
        { qDebug("called before everything else"); }
        void myFirstTest()
        { QVERIFY(1 == 1); }
        void mySecondTest()
        { QVERIFY(1 != 2); }
        void cleanupTestCase()
        { qDebug("called after myFirstTest and mySecondTest"); }
    };

For more examples, refer to the QTestLib Tutorial.

    CONFIG += qtestlib

    testname [options] [testfunctions[:testdata]]...

        /myTestDirectory$ testQString toUpper

        /myTestDirectory$ testQString toUpper toInt:zero

        /myTestDirectory$ testMyWidget -vs -eventdelay 500