pytest-qt

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

Requirements

Python 2.6 or later, including Python 3+.

Works with either PySide, PyQt (PyQt4 and PyQt5) picking whichever is available on the system, giving preference to the first one installed in this order:

PySide
PyQt4
PyQt5

To force a particular API, set the environment variable PYTEST_QT_API to pyside, pyqt4, pyqt4v2 or pyqt5. pyqt4v2 sets the PyQt4 API to version 2

Features

qtbot fixture to simulate user interaction with Qt widgets.
Automatic capture of qDebug, qWarning and qCritical messages;
waitSignal and waitSignals functions to block test execution until specific signals are emitted.
Exceptions in virtual methods and slots are automatically captured and fail tests accordingly.

Documentation

Full documentation and tutorial available at Read the Docs.

Change Log

Please consult the changelog page.

Bugs/Requests

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

Contributing

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

Pull requests 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. :)

Running tests

Tests are run using tox. The simplest way to test is with PySide, as it is available on pip and can be installed by tox automatically:

$ tox -e py34-pyside,py27-pyside,docs

If you want to test against PyQt, install it into your global python installation and use the py27-pyqt4, py34-pyqt4 or py34-pyqt5 testing environments, and tox will copy the appropriate files into its virtual environments to ensure isolation.

Contributors

Many thanks to:

Igor T. Ghisi (@itghisi);
John David Reaver (@jdreaver);
Benjamin Hedrich (@bh);
Benjamin Audren (@baudren);
Fabio Zadrozny (@fabioz);
Datalyze Solutions (@datalyze-solutions);
Florian Bruhin (@The-Compiler);
Guilherme Quentel Melo (@gqmelo);
Francesco Montesano (@montefra);

Powered by

Release files for pytest-qt 1.7.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for pytest-qt 1.7.0
File	Size	Uploaded
pytest-qt-1.7.0.zip	27.1 kB	Sep 16, 2015	Details

Built distribution (wheel)

Table of built distributions (wheels) for pytest-qt 1.7.0
File	Interpreter	ABI	Platform	Reset
pytest_qt-1.7.0-py2.py3-none-any.whl 20.3 kB Sep 16, 2015	Python 2, Python 3	none	any	Details

Total release size: 47.5 kB

Release files / pytest-qt-1.7.0.zip

Download URL	pytest-qt-1.7.0.zip
Size	27.1 kB
Tags	Source
SHA-256 checksum How to use checksums	`4d482e0d0d0601bdc2448655014fd35130203666d97b6319a812cd72fcfddaa9`
BLAKE2b-256 checksum How to use checksums	`1d6c4204e660760ebcca1e536685b25dcb6fbec6f85ee8c178cd22e27257fbcb`
Upload date	Sep 16, 2015
Uploaded using Trusted Publishing? What is trusted publishing?	No

Release files / pytest_qt-1.7.0-py2.py3-none-any.whl

Download URL	pytest_qt-1.7.0-py2.py3-none-any.whl
Size	20.3 kB
Tags	Python 2 Python 3
SHA-256 checksum How to use checksums	`9fafdfc89866207ed753e09d9cbbd103f11a67698b977b820efbc424ed3b2410`
BLAKE2b-256 checksum How to use checksums	`931655157eead97746512829aebc10d61c4256b06e286484d27583d4278ba474`
Upload date	Sep 16, 2015
Uploaded using Trusted Publishing? What is trusted publishing?	No