pytest support for PyQt and PySide 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(widget.button_greet, QtCore.Qt.LeftButton) assert widget.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.
- 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.
To force a particular API, set the configuration variable qt_api in your pytest.ini file to pyqt5, pyside, pyside2, pyqt4 or pyqt4v2. pyqt4v2 sets the PyQt4 API to version 2.
Alternatively, you can set the PYTEST_QT_API environment variable to the same values described above (the environment variable wins over the configuration if both are set).
Full documentation and tutorial available at Read the Docs.
Please consult the changelog 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 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. :)
Tests are run using tox. It is recommended to develop locally on Python 3 because PyQt5 and PySide2 are easily installable using pip:
$ tox -e py37-pyside2,py37-pyqt5
$ pip install pre-commit $ pre-commit install
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);
- Roman Yurchak (@rth)
Release history Release notifications
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
|Filename, size & hash SHA256 hash help||File type||Python version||Upload date|
|pytest_qt-3.2.2-py2.py3-none-any.whl (34.9 kB) Copy SHA256 hash SHA256||Wheel||py2.py3|
|pytest-qt-3.2.2.tar.gz (114.6 kB) Copy SHA256 hash SHA256||Source||None|