PyQt5桌面应用开发(20):界面设计结果自动测试(一)

PyQt5桌面应用系列

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.KeyAction
    Release = ...  # type: QTest.KeyAction
    Click = ...  # type: QTest.KeyAction
    Shortcut = ...  # type: QTest.KeyAction

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

信号测试

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

class QSignalSpy(QtCore.QObject):

    @typing.overload
    def __init__(self, signal: pyqtBoundSignal) -> None: ...
    @typing.overload
    def __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 partial

from PyQt5 import QtTest
from PyQt5.QtCore import pyqtSignal, QObject, Qt
from PyQt5.QtTest import QSignalSpy
from PyQt5.QtWidgets import QApplication, QPushButton


class 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 unittest


class SmokeTest(unittest.TestCase):
    def setUp(self) -> None:
        pass

    def tearDown(self) -> None:
        pass

    def 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程序的测试驱动的开发。

  • 0
    点赞
  • 2
    收藏
    觉得还不错? 一键收藏
  • 打赏
    打赏
  • 0
    评论
手写数字识别是指通过计算机程序将手写的数字图像转化为对应的数字标识。PyQt5是一个用于创建图形用户界面(GUI)的Python库。下面是手写数字识别与PyQt5的介绍: 手写数字识别: 手写数字识别是一种常见的机器学习任务,它可以应用于许多领域,如自动化表单处理、手写输入、图像分类等。以下是手写数字识别的一般步骤: 1. 数据收集:收集包含手写数字图像和对应标签的数据集。 2. 数据预处理:对数据进行预处理,如图像灰度化、二值化、尺寸调整等。 3. 特征提取:从图像中提取有用的特征,如边缘、形状等。 4. 模型训练:使用机器学习算法或深度学习模型对数据进行训练,建立手写数字识别模型。 5. 模型评估:使用测试数据评估模型的准确性和性能。 6. 预测应用:使用训练好的模型对新的手写数字图像进行预测。 PyQt5PyQt5是一个基于Qt框架的Python库,用于创建图形用户界面(GUI)应用程序。它提供了丰富的GUI组件和功能,可以用于开发跨平台的桌面应用程序。以下是PyQt5的一些特点和使用方法: 1. 特点:PyQt5具有丰富的GUI组件、支持多种操作系统、易于学习和使用、提供了丰富的文档和示例等特点。 2. 安装:可以使用pip命令安装PyQt5库,如:pip install PyQt5。 3. 使用:通过导入PyQt5模块,可以创建窗口、添加控件、设置布局、处理事件等。可以使用Qt Designer工具进行可视化设计界面,然后使用PyQt5代码与之交互。

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

大福是小强

除非你钱多烧得慌……

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值