Metadata-Version: 1.1
Name: pytest-qt
Version: 1.9.0
Summary: pytest support for PyQt and PySide applications
Home-page: http://github.com/pytest-dev/pytest-qt
Author: Bruno Oliveira
Author-email: nicoddemus@gmail.com
License: LGPL
Description: =========
        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:
        
        
        .. code-block:: python
        
            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!'
        
        
        .. _PySide: https://pypi.python.org/pypi/PySide
        .. _PyQt: http://www.riverbankcomputing.com/software/pyqt
        .. _pytest: http://pytest.org
        
        This allows you to test and make sure your view layer is behaving the way you expect after each code change.
        
        .. Using PNG badges because PyPI doesn't support SVG
        
        .. |version| image:: http://img.shields.io/pypi/v/pytest-qt.png
          :target: https://pypi.python.org/pypi/pytest-qt
          
        .. |downloads| image:: http://img.shields.io/pypi/dm/pytest-qt.png
          :target: https://pypi.python.org/pypi/pytest-qt
          
        .. |ci| image:: http://img.shields.io/travis/pytest-dev/pytest-qt.png
          :target: https://travis-ci.org/pytest-dev/pytest-qt
        
        .. |coverage| image:: http://img.shields.io/coveralls/pytest-dev/pytest-qt.png
          :target: https://coveralls.io/r/pytest-dev/pytest-qt
        
        .. |docs| image:: https://readthedocs.org/projects/pytest-qt/badge/?version=latest
          :target: https://pytest-qt.readthedocs.org
        
        .. |appveyor| image:: https://ci.appveyor.com/api/projects/status/9s5jr17hxcxeo6yx/branch/master?svg=true
          :target: https://ci.appveyor.com/project/nicoddemus/pytest-qt
        
        .. pypip.in seems to be offline
          .. |python| image:: https://pypip.in/py_versions/pytest-qt/badge.png
          :target: https://pypi.python.org/pypi/pytest-qt/
          :alt: Supported Python versions
        
        |version| |downloads| |ci| |appveyor| |coverage| |docs|
        
        Requirements
        ============
        
        Python 2.6+ or 3.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 <version2>`_
        
        .. _version2: http://pyqt.sourceforge.net/Docs/PyQt4/incompatible_apis.html
        
        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.
        
        .. _qtbot: https://pytest-qt.readthedocs.org/en/latest/reference.html#module-pytestqt.qtbot
        .. _Automatic capture: https://pytest-qt.readthedocs.org/en/latest/logging.html
        .. _waitSignal: https://pytest-qt.readthedocs.org/en/latest/signals.html
        .. _waitSignals: https://pytest-qt.readthedocs.org/en/latest/signals.html
        .. _Exceptions in virtual methods and slots: https://pytest-qt.readthedocs.org/en/latest/virtual_methods.html
        
        Documentation
        =============
        
        Full documentation and tutorial available at `Read the Docs`_.
        
        .. _Read The Docs: https://pytest-qt.readthedocs.org
        
        Change Log
        ==========
        
        Please consult the `changelog page`_.
        
        .. _changelog page: https://github.com/pytest-dev/pytest-qt/blob/master/CHANGELOG.rst
        
        Bugs/Requests
        =============
        
        Please report any issues or feature requests in the `issue tracker`_.
        
        .. _issue tracker: https://github.com/pytest-dev/pytest-qt/issues
        
        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 <https://github.com/itghisi>`_);
        - John David Reaver (`@jdreaver <https://github.com/jdreaver>`_);
        - Benjamin Hedrich (`@bh <https://github.com/bh>`_);
        - Benjamin Audren (`@baudren <https://github.com/baudren>`_);
        - Fabio Zadrozny (`@fabioz <https://github.com/fabioz>`_);
        - Datalyze Solutions (`@datalyze-solutions <https://github.com/datalyze-solutions>`_);
        - Florian Bruhin (`@The-Compiler <https://github.com/The-Compiler>`_);
        - Guilherme Quentel Melo (`@gqmelo <https://github.com/gqmelo>`_);
        - Francesco Montesano (`@montefra <https://github.com/montefra>`_);
        
        **Powered by**
        
        .. |pycharm| image:: https://www.jetbrains.com/pycharm/docs/logo_pycharm.png
          :target: https://www.jetbrains.com/pycharm
          
        |pycharm|  
        
        .. _tox: http://tox.readthedocs.org
        
Keywords: pytest qt test unittest
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: GNU Lesser General Public License v3 (LGPLv3)
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Topic :: Desktop Environment :: Window Managers
Classifier: Topic :: Software Development :: Quality Assurance
Classifier: Topic :: Software Development :: Testing
Classifier: Topic :: Software Development :: User Interfaces
