QTest ¶

概要 ¶

详细描述 ¶

见 Qt Test 概述 for information about how to write unit tests.

PySide2.QtTest.QTest. TestFailMode ¶

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

常量	描述
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.

另请参阅

QEXPECT_FAIL()

PySide2.QtTest.QTest. QBenchmarkMetric ¶

This enum lists all the things that can be benchmarked.

常量	描述
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

注意： 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 框架。

另请参阅

benchmarkMetricName() benchmarkMetricUnit()

static PySide2.QtTest.QTest. addColumnInternal ( id , name ) ¶

参数

• id – int

• name – str

static PySide2.QtTest.QTest. asciiToKey ( ascii ) ¶

参数

ascii – char

返回类型

Key

Convert an ascii char key value to a Qt Key value. If the key is unknown a 0 is returned.

Note: this may happen more than you like since not all known ascii keys _are_ converted already. So feel free to add all the keys you need.

static PySide2.QtTest.QTest. compare_ptr_helper ( t1 , t2 , actual , expected , file , line ) ¶

参数

• t1 – void

• t2 – void

• actual – str

• expected – str

• file – str

• line – int

返回类型

bool

static PySide2.QtTest.QTest. compare_string_helper ( t1 , t2 , actual , expected , file , line ) ¶

参数

• t1 – str

• t2 – str

• actual – str

• expected – str

• file – str

• line – int

返回类型

bool

static PySide2.QtTest.QTest. currentAppName ( ) ¶

返回类型

str

Returns the name of the binary that is currently executed.

static PySide2.QtTest.QTest. currentDataTag ( ) ¶

返回类型

str

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

static PySide2.QtTest.QTest. currentTestFailed ( ) ¶

返回类型

bool

返回 true if the current test function failed, otherwise false.

static PySide2.QtTest.QTest. currentTestFunction ( ) ¶

返回类型

str

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

范例：

void MyTestClass.cleanup()
{
    if (qstrcmp(currentTestFunction(), "myDatabaseTest") == 0) {
        // clean up all database connections
        closeAllDatabases()
    }
}
											

static PySide2.QtTest.QTest. ignoreMessage ( type , messagePattern ) ¶

参数

• type – QtMsgType

• messagePattern – QRegularExpression

static PySide2.QtTest.QTest. ignoreMessage ( type , message ) ¶

参数

• type – QtMsgType

• message – str

Ignores messages created by qDebug() , qInfo() or qWarning() 。若 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.

注意

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

范例：

QDir dir
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 PySide2.QtTest.QTest. keyToAscii ( key ) ¶

参数

key – Key

返回类型

char

Convert a Qt Key to an ascii char value. If the Qt key is unknown a 0 is returned.

Note: this may happen more than you like since not all known Qt keys _are_ converted already. So feel free to add all the keys you need.

static PySide2.QtTest.QTest. qCleanup ( ) ¶

static PySide2.QtTest.QTest. qElementData ( elementName , metaTypeId ) ¶

参数

• elementName – str

• metaTypeId – int

返回类型

void

static PySide2.QtTest.QTest. qExpectFail ( dataIndex , comment , mode , file , line ) ¶

参数

• dataIndex – str

• comment – str

• mode – TestFailMode

• file – str

• line – int

返回类型

bool

static PySide2.QtTest.QTest. qExtractTestData ( dirName ) ¶

参数

dirName – unicode

返回类型

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 PySide2.QtTest.QTest. qFindTestData ( basepath [ , file=None [ , line=0 [ , builddir=None ] ] ] ) ¶

参数

• basepath – unicode

• file – str

• line – int

• builddir – str

返回类型

unicode

static PySide2.QtTest.QTest. qFindTestData ( basepath [ , file=None [ , line=0 [ , builddir=None ] ] ] ) ¶

参数

• basepath – str

• file – str

• line – int

• builddir – str

返回类型

unicode

static PySide2.QtTest.QTest. qGlobalData ( tagName , typeId ) ¶

参数

• tagName – str

• typeId – int

返回类型

void

static PySide2.QtTest.QTest. qRun ( ) ¶

返回类型

int

static PySide2.QtTest.QTest. qSkip ( message , file , line ) ¶

参数

• message – str

• file – str

• line – int

static PySide2.QtTest.QTest. setBenchmarkResult ( result , metric ) ¶

参数

• result – qreal

• metric – QBenchmarkMetric

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 PySide2.QtTest.QTest. setMainSourcePath ( file [ , builddir=None ] ) ¶

参数

• file – str

• builddir – str

static PySide2.QtTest.QTest. testObject ( ) ¶

返回类型

QObject

static PySide2.QtTest.QTest. toPrettyCString ( unicode , length ) ¶

参数

• unicode – str

• length – int

返回类型

char

Returns the same QByteArray but with only the ASCII characters still shown; everything else is replaced with \xHH .