skip to navigation
skip to content

pytest-qt 1.2.0

pytest support for PyQt and PySide applications

Latest Version: 2.3.1

pytest-qt is a pytest plugin that allows programmers to 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()

    # 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.


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).


Full documentation and tutorial available at Read the Docs.

Change Log

Please consult the releases page.


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


Contributions are welcome, so feel free to submit a bug or feature request.

Pull requests for new features or bug fixes are highly appreciated! If you can, include some tests that exercise the new code or test that a bug has been fixed, and make sure to include yourself in the contributors list. :)


Many thanks to:

File Type Py Version Uploaded on Size (md5) Source 2014-07-05 18KB
pytest_qt-1.2.0-py2.py3-none-any.whl (md5) Python Wheel 2.7 2014-07-05 13KB