Skip to main content

pytest support for PyQt and PySide applications

Project description

pytest-qt is a pytest plugin to allow programmers write tests for PySide and PyQt applications.

The main usage is to use the qtbot fixture, responsible for handling qApp creation as needed and provides methods to simulate user interaction, like key presses and mouse clicks:

def test_hello(qtbot):
    widget = HelloWidget()
    qtbot.addWidget(widget)

    # click in the Greet button and make sure it updates the appropriate label
    qtbot.mouseClick(window.button_greet, QtCore.Qt.LeftButton)

    assert window.greet_label.text() == 'Hello!'

This allows you to test and make sure your view layer is behaving the way you expect after each code change.

version downloads ci

Requirements

Python 2.6 or later, including Python 3+.

Works with either PySide or PyQt picking whichever is available on the system, giving preference to PySide if both are installed (to force it to use PyQt, set the environment variable PYTEST_QT_FORCE_PYQT=true).

Documentation

Full documentation and tutorial available at Read the Docs.

Change Log

Please consult the releases page.

Bugs/Requests

Please report any issues or feature requests in the issue tracker.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pytest-qt-1.1.1.zip (18.9 kB view hashes)

Uploaded Source

Built Distribution

pytest_qt-1.1.1-py2.py3-none-any.whl (9.3 kB view hashes)

Uploaded Python 2 Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page