PyQt5桌面应用开发（20）：界面设计结果自动测试（一）

news/2025/1/15 16:02:02/

本文目录

  • PyQt5桌面应用系列
  • PyQt5的测试驱动开发（Test-Driven Development，TDD）
  • QTest
    • UI动作函数
    • 信号测试
  • 最平凡的例子
  • unittest框架
  • 总结

PyQt5桌面应用系列

  • PyQt5桌面应用开发（1）：需求分析
  • PyQt5桌面应用开发（2）：事件循环
  • PyQt5桌面应用开发（3）：并行设计
  • PyQt5桌面应用开发（4）：界面设计
  • PyQt5桌面应用开发（5）：对话框
  • PyQt5桌面应用开发（6）：文件对话框
  • PyQt5桌面应用开发（7）：文本编辑+语法高亮与行号
  • PyQt5桌面应用开发（8）：从QInputDialog转进到函数参数传递
  • PyQt5桌面应用开发（9）：经典布局QMainWindow
  • PyQt5桌面应用开发（10）：界面布局基本支持
  • PyQt5桌面应用开发（11）：摸鱼也要讲基本法，两个字，16
  • PyQt5桌面应用开发（12）：QFile与线程安全
  • PyQt5桌面应用开发（13）：QGraphicsView框架
  • PyQt5桌面应用开发（14）：数据库+ModelView+QCharts
  • PyQt5桌面应用开发（15）：界面动画
  • PyQt5桌面应用开发（16）：定制化控件-QPainter绘图
  • PyQt5桌面应用开发（17）：类结构+QWebEngineView
  • PyQt5桌面应用开发（18）：自定义控件界面设计与实现
  • PyQt5桌面应用开发（19）：事件过滤器
  • PyQt5桌面应用开发（20）：界面设计结果自动测试（一）

PyQt5的测试驱动开发（Test-Driven Development，TDD）

测试驱动开发（Test-Driven Development，TDD）是一种软件开发过程，它要求在编写功能代码之前，先编写单元测试用例代码，测试代码确定需要编写什么产品代码。测试驱动开发的目标是使代码更加简洁、可读和可维护。

测试驱动开发可以使程序员在编写代码之前思考软件设计。

测试驱动开发的步骤：

  1. 添加一个测试
  2. 运行所有测试，新添加的测试应该失败
  3. 编写实现代码
  4. 运行所有测试，若有测试失败，重复步骤3-4
  5. 重构代码
  6. 重复步骤1-5
  7. 完成

QTest

QTest是Qt提供的一个单元测试框架，它提供了一些宏，可以用来测试Qt程序的各个部分，包括GUI部分。
大概探索一下pyqt中实现的，QTest，包括几个部分，几个内置的类（大写开头），内置的枚举类（大写开头），内置的函数（小写开头）。
其中函数主要的作用就是模拟UI上的操作，比如键盘动作、鼠标动作、触控动作等。
下面总结了等待休眠函数（q打头）、键盘动作函数（key打头）、鼠标动作函数（mouse打头）、触控动作函数（touch打头）的函数名称和重载的参数。

UI动作函数

  1. 小写字母q打头的函数，测试UI的控制函数，包括睡眠、等待、等待窗口激活、等待窗口暴露。

    1. qSleep
      1. qSleep(ms: int)
    2. qWait
      1. qWait(ms: int)
    3. qWaitForWindowActive
      1. qWaitForWindowActive(window: QWindow, timeout: int = 5000) -> bool
      2. qWaitForWindowActive(widget: QWidget, timeout: int = 5000) -> bool
    4. qWaitForWindowExposed
      1. qWaitForWindowExposed(window: QWindow, timeout: int = 5000) -> bool
      2. qWaitForWindowExposed(widget: QWidget, timeout: int = 5000) -> bool

  2. key开头的函数

    1. keyClick

      1. keyClick(widget: QWidget, key: Qt.Key, modifier: Union[Qt.KeyboardModifiers, Qt.KeyboardModifier] =
        Qt.NoModifier,
        delay: int = -1)
      2. keyClick(widget: QWidget, key: str, modifier: Union[Qt.KeyboardModifiers, Qt.KeyboardModifier] =
        Qt.NoModifier, delay:
        int = -1)
      3. keyClick(window: QWindow, key: Qt.Key, modifier: Union[Qt.KeyboardModifiers, Qt.KeyboardModifier] =
        Qt.NoModifier,
        delay: int = -1)
      4. keyClick(window: QWindow, key: str, modifier: Union[Qt.KeyboardModifiers, Qt.KeyboardModifier] =
        Qt.NoModifier, delay:
        int = -1)

    2. keyClicks

      1. keyClicks(widget: QWidget, sequence: str, modifier: Union[Qt.KeyboardModifiers, Qt.KeyboardModifier] =
        Qt.NoModifier,
        delay: int = -1)

    3. keyEvent

      1. keyEvent(action: QTest.KeyAction, widget: QWidget, key: Qt.Key, modifier:
        Union[Qt.KeyboardModifiers, Qt.KeyboardModifier] = Qt.NoModifier, delay: int = -1)
      2. keyEvent(action: QTest.KeyAction, widget: QWidget, ascii: str, modifier:
        Union[Qt.KeyboardModifiers, Qt.KeyboardModifier] = Qt.NoModifier, delay: int = -1)
      3. keyEvent(action: QTest.KeyAction, window: QWindow, key: Qt.Key, modifier:
        Union[Qt.KeyboardModifiers, Qt.KeyboardModifier] = Qt.NoModifier, delay: int = -1)
      4. keyEvent(action: QTest.KeyAction, window: QWindow, ascii: str, modifier:
        Union[Qt.KeyboardModifiers, Qt.KeyboardModifier] = Qt.NoModifier, delay: int = -1)

    4. keyPress

      1. keyPress(widget: QWidget, key: Qt.Key, modifier: Union[Qt.KeyboardModifiers, Qt.KeyboardModifier] =
        Qt.NoModifier, delay: int = -1)
      2. keyPress(widget: QWidget, key: str, modifier: Union[Qt.KeyboardModifiers, Qt.KeyboardModifier] =
        Qt.NoModifier, delay: int = -1)
      3. keyPress(window: QWindow, key: Qt.Key, modifier: Union[Qt.KeyboardModifiers, Qt.KeyboardModifier] =
        Qt.NoModifier, delay: int = -1)
      4. keyPress(window: QWindow, key: str, modifier: Union[Qt.KeyboardModifiers, Qt.KeyboardModifier] =
        Qt.NoModifier, delay: int = -1)

    5. keyRelease

      1. keyRelease(widget: QWidget, key: Qt.Key, modifier: Union[Qt.KeyboardModifiers, Qt.KeyboardModifier] =
        Qt.NoModifier, delay: int = -1)
      2. keyRelease(widget: QWidget, key: str, modifier: Union[Qt.KeyboardModifiers, Qt.KeyboardModifier] =
        Qt.NoModifier, delay: int = -1)
      3. keyRelease(window: QWindow, key: Qt.Key, modifier: Union[Qt.KeyboardModifiers, Qt.KeyboardModifier] =
        Qt.NoModifier, delay: int = -1)
      4. keyRelease(window: QWindow, key: str, modifier: Union[Qt.KeyboardModifiers, Qt.KeyboardModifier] =
        Qt.NoModifier, delay: int = -1)

    6. keySequence

      1. keySequence(widget: QWidget, keySequence: Union[QKeySequence, QKeySequence.StandardKey, str, int])
      2. keySequence(window: QWindow, keySequence: Union[QKeySequence, QKeySequence.StandardKey, str, int])

  3. mouse开头的函数

    1. mouseClick

      1. mouseClick(widget: QWidget, button: Qt.MouseButton, modifier:
        Union[Qt.KeyboardModifiers, Qt.KeyboardModifier] = Qt.KeyboardModifiers(), pos: QPoint = QPoint(), delay:
        int = -1)
      2. mouseClick(window: QWindow, button: Qt.MouseButton, modifier:
        Union[Qt.KeyboardModifiers, Qt.KeyboardModifier] = Qt.KeyboardModifiers(), pos: QPoint = QPoint(), delay:
        int = -1)

    2. mouseDClick

      1. mouseDClick(widget: QWidget, button: Qt.MouseButton, modifier:
        Union[Qt.KeyboardModifiers, Qt.KeyboardModifier] = Qt.KeyboardModifiers(), pos: QPoint = QPoint(), delay:
        int = -1)
      2. mouseDClick(window: QWindow, button: Qt.MouseButton, modifier:
        Union[Qt.KeyboardModifiers, Qt.KeyboardModifier] = Qt.KeyboardModifiers(), pos: QPoint = QPoint(), delay:
        int = -1)

    3. mouseMove

      1. mouseMove(widget: QWidget, pos: QPoint = QPoint(), delay: int = -1)
      2. mouseMove(window: QWindow, pos: QPoint = QPoint(), delay: int = -1)

    4. mousePress

      1. mousePress(widget: QWidget, button: Qt.MouseButton, modifier:
        Union[Qt.KeyboardModifiers, Qt.KeyboardModifier] = Qt.KeyboardModifiers(), pos: QPoint = QPoint(), delay:
        int = -1)
      2. mousePress(window: QWindow, button: Qt.MouseButton, modifier:
        Union[Qt.KeyboardModifiers, Qt.KeyboardModifier] = Qt.KeyboardModifiers(), pos: QPoint = QPoint(), delay:
        int = -1)

    5. mouseRelease

      1. mouseRelease(widget: QWidget, button: Qt.MouseButton, modifier:
        Union[Qt.KeyboardModifiers, Qt.KeyboardModifier] = Qt.KeyboardModifiers(), pos: QPoint = QPoint(), delay:
        int = -1)
      2. mouseRelease(window: QWindow, button: Qt.MouseButton, modifier:
        Union[Qt.KeyboardModifiers, Qt.KeyboardModifier] = Qt.KeyboardModifiers(), pos: QPoint = QPoint(), delay:
        int = -1)

  4. touch开头的函数

    1. touchEvent
      1. touchEvent(widget: QWidget, device: QTouchDevice) -> QTest.QTouchEventSequence
      2. touchEvent(window: QWindow, device: QTouchDevice) -> QTest.QTouchEventSequence

内置的枚举类， KeyAction代表了按键的动作类型。

class KeyAction(int):Press = ...  # type: QTest.KeyActionRelease = ...  # type: QTest.KeyActionClick = ...  # type: QTest.KeyActionShortcut = ...  # type: QTest.KeyAction

QTouchEventSequence是触控板事件，这里不做详细介绍。

信号测试

QtTest还提供了一个信号测试的类， QTest.SignalSpy，它可以用来测试信号的触发情况。

class QSignalSpy(QtCore.QObject):@typing.overloaddef __init__(self, signal: pyqtBoundSignal) -> None: ...@typing.overloaddef __init__(self, obj: QtCore.QObject, signal: QtCore.QMetaMethod) -> None: ...def __delitem__(self, i: int) -> None: ...def __setitem__(self, i: int, value: typing.Iterable[typing.Any]) -> None: ...def __getitem__(self, i: int) -> typing.List[typing.Any]: ...def __len__(self) -> int: ...def wait(self, timeout: int = ...) -> bool: ...def signal(self) -> QtCore.QByteArray: ...def isValid(self) -> bool: ...

这个类跟Qt5中的实现由一些不同。因为在Python中，列表的接口是很容易通过魔术函数实现的，所以这里的QSignalSpy类就是一个两层列表，它的元素本身也是一个列表。

这个类有两个构造函数，一个是传入一个信号，一个是传入一个QObject和信号的元方法。这两个构造函数都会返回一个QSignalSpy对象。第一个就是用于通过@pyqtSignal定义的信号，这个信号必须与一个对象绑定。

第二个构造函数也挺有意思，把绑定的对象与信号分开，在PyQt5中要获得这个QMetaMethod对象，需要通过QMetaObject类的方法来获取元对象，然后在元对象中查找信号的元方法。这里的QMetaMethod对象是通过信号的元方法来获取的。

最平凡的例子

这里用一个很无趣的例子来说明QtTest的使用方法。

import sys
from functools import partialfrom PyQt5 import QtTest
from PyQt5.QtCore import pyqtSignal, QObject, Qt
from PyQt5.QtTest import QSignalSpy
from PyQt5.QtWidgets import QApplication, QPushButtonclass SmokeQtTest(QObject):smoke = pyqtSignal(str)def dump_signal(spy: QSignalSpy):print(spy.signal(), ' signal count:', len(spy))for i in range(len(spy)):print("\t", spy[i])if __name__ == '__main__':app = QApplication(sys.argv)smoke_test = SmokeQtTest()spy = QtTest.QSignalSpy(smoke_test.smoke)smoke_test.smoke.connect(print)smoke_test.smoke.emit('Hello, World!')widget = QPushButton('Click me')widget.clicked.connect(partial(dump_signal, spy))# 直接用第一种方法就行，实在是Copilot很无聊，自动生成了第二种方法# button_spy = QSignalSpy(widget.clicked)button_spy = QSignalSpy(widget,widget.metaObject().method(widget.metaObject().indexOfSignal("clicked(bool)")))widget.clicked.connect(partial(dump_signal, button_spy))widget.show()QtTest.QTest.qWaitForWindowExposed(widget)QtTest.QTest.mouseClick(widget, Qt.LeftButton)sys.exit(app.exec_())

程序运行后，会弹出一个按钮，点击按钮后，会打印出信号的内容。

Hello, World!
b'smoke(QString)'  signal count: 1['Hello, World!']
b'clicked(bool)'  signal count: 1[False]

这里有两个SigalSpy，一个监听自定义的信号，一个监听clicked信号。后面用QTest来模拟点击按钮的事件。

unittest框架

unittest框架是Python自带的一个单元测试框架，它的使用方法跟QtTest类似，也是通过继承TestCase类来实现的。它的使用方法也是通过assertEqual、assertTrue等来实现的。

import unittestclass SmokeTest(unittest.TestCase):def setUp(self) -> None:passdef tearDown(self) -> None:passdef test_equal(self):self.assertEqual(1, 1)def test_true(self):self.assertTrue(True)

TestCase类的setUp和tearDown方法分别是在每个测试用例开始和结束时调用的。这两个方法可以用来做一些初始化和清理工作。以及测试用例的方法必须以test开头，否则unittest框架不会执行。TestCase提供了很多的断言方法，例如assertEqual、assertTrue、assertIn等，这些方法都是用来判断测试结果是否符合预期的。

运行测试用例的方法有两种，一种是通过unittest.main()来运行，另一种是通过TestSuite来运行。

if __name__ == '__main__':unittest.main()

这种方法会运行所有的测试用例，如果想要运行指定的测试用例，可以通过TestSuite来实现。

if __name__ == '__main__':suite = unittest.TestSuite()suite.addTest(SmokeTest('test_equal'))suite.addTest(SmokeTest('test_true'))runner = unittest.TextTestRunner()runner.run(suite)

这里是手动添加了两个测试用例，然后通过TextTestRunner来运行。TextTestRunner是一个文本运行器，它会将测试结果输出到控制台。除了这个运行器，还有HTMLTestRunner、XMLTestRunner等，它们会将测试结果输出到HTML或者XML文件中。

还可以通过suite = unittest.TestLoader().loadTestsFromTestCase(SmokeTest)来加载测试用例，这样就不需要手动添加了。

以HTMLTestRunner为例，它的使用方法如下：

    # HTMLTestRunner = __import__('HTMLTestRunner')
runner = HTMLTestRunner(output='report', report_name='report', add_timestamp=True, combine_reports=True)
# unittest.TextTestRunner(verbosity=2).run(suite)
runner.run(suite)

当然首先要通过pip install html-testRunner
安装这个库。这里的output是输出的目录，report_name是报告的名称，add_timestamp是是否添加时间戳，combine_reports是是否合并报告。

然后运行python unittest_smoke.py，就会在当前目录下生成一个report目录，里面有一个report-xxxxxxxx.html文件，打开这个文件就可以看到测试结果了。

在这里插入图片描述

注意这里不要运行python -m unittest unittest_smoke.py，unittest会采用默认的运行期来运行默认的测试用例。

总结

  1. QTest的职责是模拟UI中的事件，例如鼠标点击、键盘输入等。
  2. QSignalSpy可用于监听信号的发射，然后获取信号的参数。
  3. unittest测试框架组织自动化测试。
  4. HTMLTestRunner将测试结果输出到HTML文件中。

下一章将完整编写一个PyQt5程序的测试驱动的开发。


http://www.ppmy.cn/news/326129.html

相关文章

DPDK系列之十九DPDK内存管理介绍

DPDK系列之十九DPDK内存管理介绍

一、DPDK中的内存介绍 一般来说，做为软件平台或者框架，要么直接应用OS（或者一些公认的标准库）的内存管理，简单方便，但可能不太尽如人意；要么就得自己搞一套内存管理系统。而自己搞内存管理系统…
阅读更多...
5.部署LVS-DR群集

5.部署LVS-DR群集

文章目录 部署LVS-DR群集LVS-DR数据包流向分析LVS-DR中的ARP问题问题一问题二 LVS-DR部署调度器配置节点服务器配置NFS服务器配置 ipvsadm 部署LVS-DR群集 LVS-DR数据包流向分析 为方便进行原理分析，将Client与群集机器放在同一网络中，数据包流经的路线…
阅读更多...
android手机nfc功能安装,小米6怎么使用NFC功能？小米手机NFC功能使用教程

android手机nfc功能安装,小米6怎么使用NFC功能？小米手机NFC功能使用教程

NFC设置 在手机中找到设置-更多连接方式-打开NFC 在默认钱包中，默认为使用小米钱包，可以使用MI pay，小米公交卡 当然，你也可以选择其他的：使用HCE钱包、使用SIM卡钱包 NFC共享 在更多连接方式中，开启Androi…
阅读更多...
线上问题记录20230610-NGINX代理大文件下载问题

线上问题记录20230610-NGINX代理大文件下载问题

线上问题记录20230610-NGINX代理大文件下载问题 问题描述 我们有一个在线项目：是一个对象文件存储服务，是用来给用户提供文件对象存储的。今天用户在使用的时候发现超过1G的文件无法进行下载。幸好今天是星期六，使用的人并不是特别多&#…
阅读更多...
苹果手机NFC取电 苹果手机亮屏取电方案 IOS NFC取电 苹果手机壳无源方案 iphone来电显示 苹果手机NFC无源方案

苹果手机NFC取电 苹果手机亮屏取电方案 IOS NFC取电 苹果手机壳无源方案 iphone来电显示 苹果手机NFC无源方案

NFC是Near Field Communication英文缩写，也就是近距离无线通信技术。由飞利浦和索尼公司共同研发的。NFC属于一种非接触式识别和互联通信技术，通常在移动设备、消费类电子产品、智能硬件工具间进行近距离无线通信。 NFC只是提供了一种简单、触控式的解决…
阅读更多...
手机NFC可以复制小区用的门禁卡吗？

手机NFC可以复制小区用的门禁卡吗？

答案是肯定的，可以复制，复制后的门卡甚至比物业发的卡还要好用。我试过几个品牌的手机都可以，不过具体是不是每个小区的卡都支持复制，答案就不一定了。 如何用手机复制门卡 首先我们要明白，手机必须要支持NFC功能才可以…
阅读更多...
android nfc 鸡肋,手机NFC真的鸡肋吗？这些功能很实用

android nfc 鸡肋,手机NFC真的鸡肋吗？这些功能很实用

随着智能手机功能的逐渐强大，NFC功能已经出现在了很多手机中，今天老瓦就和大家聊聊手机NFC的那些事儿。 NFC又称近场通信，即近距离无线通讯技术。在单一的芯片上结合读卡器、点对点的功能，可以实现近距离的数据交换。这项技术最早…
阅读更多...
ID卡（工卡）复制到手机NFC

ID卡（工卡）复制到手机NFC

1.很多单位的工卡都是ID卡，而读卡机，一般是多频的，支持多种卡，那么如何把ID卡写到手机NFC中，实现“忘带卡自由”呢？ 2.前提条件：用手机NFC，在单位的刷卡机上刷卡，提示“…
阅读更多...
最新文章

Copyright @ 2022~2023