QTest

The QTest namespace contains all the functions and declarations that are related to Qt Test. More…

Inheritance diagram of PySide6.QtTest.QTest

Synopsis

Static functions

Detailed Description

See the Qt Test Overview for information about how to write unit tests.

PySide6.QtTest.QTest.TestFailMode

This enum describes the modes for handling an expected failure of the QVERIFY() or QCOMPARE() macros.

Constant

Description

QTest.Abort

Aborts the execution of the test. Use this mode when it doesn’t make sense to execute the test any further after the expected failure.

QTest.Continue

Continues execution of the test after the expected failure.

See also

QEXPECT_FAIL()

PySide6.QtTest.QTest.QBenchmarkMetric

This enum lists all the things that can be benchmarked.

Constant

Description

QTest.FramesPerSecond

Frames per second

QTest.BitsPerSecond

Bits per second

QTest.BytesPerSecond

Bytes per second

QTest.WalltimeMilliseconds

Clock time in milliseconds

QTest.WalltimeNanoseconds

Clock time in nanoseconds

QTest.BytesAllocated

Memory usage in bytes

QTest.Events

Event count

QTest.CPUTicks

CPU time

QTest.CPUMigrations

Process migrations between CPUs

QTest.CPUCycles

CPU cycles

QTest.RefCPUCycles

Reference CPU cycles

QTest.BusCycles

Bus cycles

QTest.StalledCycles

Cycles stalled

QTest.InstructionReads

Instruction reads

QTest.Instructions

Instructions executed

QTest.BranchInstructions

Branch-type instructions

QTest.BranchMisses

Branch instructions that were mispredicted

QTest.CacheReferences

Cache accesses of any type

QTest.CacheMisses

Cache misses of any type

QTest.CacheReads

Cache reads / loads

QTest.CacheReadMisses

Cache read / load misses

QTest.CacheWrites

Cache writes / stores

QTest.CacheWriteMisses

Cache write / store misses

QTest.CachePrefetches

Cache prefetches

QTest.CachePrefetchMisses

Cache prefetch misses

QTest.ContextSwitches

Context switches

QTest.PageFaults

Page faults of any type

QTest.MinorPageFaults

Minor page faults

QTest.MajorPageFaults

Major page faults

QTest.AlignmentFaults

Faults caused due to misalignment

QTest.EmulationFaults

Faults that needed software emulation

Note that WalltimeNanoseconds and BytesAllocated are only provided for use via setBenchmarkResult() , and results in those metrics are not able to be provided automatically by the QTest framework.

See also

benchmarkMetricName() benchmarkMetricUnit()

New in version 4.7.

static PySide6.QtTest.QTest.addColumnInternal(id, name)
Parameters

  • id – int

  • name – str

static PySide6.QtTest.QTest.asciiToKey(ascii)
Parameters

ascii – char

Return type

Key

static PySide6.QtTest.QTest.compare_ptr_helper(t1, t2, actual, expected, file, line)
Parameters
Return type

bool

static PySide6.QtTest.QTest.compare_ptr_helper(t1, t2, actual, expected, file, line)
Parameters

  • t1 – void

  • t2 – void

  • actual – str

  • expected – str

  • file – str

  • line – int

Return type

bool

static PySide6.QtTest.QTest.compare_string_helper(t1, t2, actual, expected, file, line)
Parameters

  • t1 – str

  • t2 – str

  • actual – str

  • expected – str

  • file – str

  • line – int

Return type

bool

static PySide6.QtTest.QTest.currentAppName()
Return type

str

Returns the name of the binary that is currently executed.

static PySide6.QtTest.QTest.currentDataTag()
Return type

str

Returns the name of the current test data. If the test doesn’t have any assigned testdata, the function returns 0.

static PySide6.QtTest.QTest.currentTestFailed()
Return type

bool

Returns true if the current test function failed, otherwise false.

static PySide6.QtTest.QTest.currentTestFunction()
Return type

str

Returns the name of the test function that is currently executed.

Example:

def cleanup(self):

    if (qstrcmp(QTest.currentTestFunction(), "myDatabaseTest") == 0) {
        # clean up all database connections
        closeAllDatabases()
static PySide6.QtTest.QTest.formatString(prefix, suffix, numArguments)
Parameters

  • prefix – str

  • suffix – str

  • numArguments – int

Return type

char

static PySide6.QtTest.QTest.ignoreMessage(type, messagePattern)
Parameters

This is an overloaded function.

Ignores messages created by qDebug() , qInfo() or qWarning() . If the message matching messagePattern with the corresponding type is outputted, it will be removed from the test log. If the test finished and the message was not outputted, a test failure is appended to the test log.

Note

Invoking this function will only ignore one message. If the message you want to ignore is outputted twice, you have to call ignoreMessage() twice, too.

static PySide6.QtTest.QTest.ignoreMessage(type, message)
Parameters

  • type – QtMsgType

  • message – str

Ignores messages created by qDebug() , qInfo() or qWarning() . If the message with the corresponding type is outputted, it will be removed from the test log. If the test finished and the message was not outputted, a test failure is appended to the test log.

Note

Invoking this function will only ignore one message. If the message you want to ignore is outputted twice, you have to call twice, too.

Example:

dir = QDir()
QTest.ignoreMessage(QtWarningMsg, "QDir.mkdir: Empty or null file name(s)")
dir.mkdir("")

The example above tests that mkdir() outputs the right warning when invoked with an invalid file name.

static PySide6.QtTest.QTest.keyToAscii(key)
Parameters

key – Key

Return type

char

static PySide6.QtTest.QTest.qCleanup()
static PySide6.QtTest.QTest.qElementData(elementName, metaTypeId)
Parameters

  • elementName – str

  • metaTypeId – int

Return type

void

static PySide6.QtTest.QTest.qExpectFail(dataIndex, comment, mode, file, line)
Parameters

  • dataIndex – str

  • comment – str

  • mode – TestFailMode

  • file – str

  • line – int

Return type

bool

static PySide6.QtTest.QTest.qExtractTestData(dirName)
Parameters

dirName – str

Return type

QSharedPointer

Extracts a directory from resources to disk. The content is extracted recursively to a temporary folder. The extracted content is removed automatically once the last reference to the return value goes out of scope.

dirName is the name of the directory to extract from resources.

Returns the temporary directory where the data was extracted or null in case of errors.

static PySide6.QtTest.QTest.qFindTestData(basepath[, file=None[, line=0[, builddir=None[, sourcedir=None]]]])
Parameters

  • basepath – str

  • file – str

  • line – int

  • builddir – str

  • sourcedir – str

Return type

str

static PySide6.QtTest.QTest.qFindTestData(basepath[, file=None[, line=0[, builddir=None[, sourcedir=None]]]])
Parameters

  • basepath – str

  • file – str

  • line – int

  • builddir – str

  • sourcedir – str

Return type

str

static PySide6.QtTest.QTest.qGlobalData(tagName, typeId)
Parameters

  • tagName – str

  • typeId – int

Return type

void

static PySide6.QtTest.QTest.qRun()
Return type

int

static PySide6.QtTest.QTest.qSkip(message, file, line)
Parameters

  • message – str

  • file – str

  • line – int

static PySide6.QtTest.QTest.setBenchmarkResult(result, metric)
Parameters

Sets the benchmark result for this test function to result.

Use this function if you want to report benchmark results without using the QBENCHMARK macro. Use metric to specify how Qt Test should interpret the results.

The context for the result will be the test function name and any data tag from the _data function. This function can only be called once in each test function, subsequent calls will replace the earlier reported results.

Note that the -iterations command line argument has no effect on test functions without the QBENCHMARK macro.

static PySide6.QtTest.QTest.setMainSourcePath(file[, builddir=None])
Parameters

  • file – str

  • builddir – str

static PySide6.QtTest.QTest.testObject()
Return type

PySide6.QtCore.QObject

static PySide6.QtTest.QTest.toPrettyCString(unicode, length)
Parameters

  • unicode – str

  • length – int

Return type

char