Skip to content

pytest plugin for Qt (PyQt4, PyQt5 and PySide) application testing

License

Notifications You must be signed in to change notification settings

billyshambrook/pytest-qt

 
 

Repository files navigation

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.

version downloads ci coverage docs

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 or pyqt5.

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.

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

Contributors

Many thanks to:

Powered by

pycharm

About

pytest plugin for Qt (PyQt4, PyQt5 and PySide) application testing

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Python 100.0%