Metadata-Version: 2.1
Name: pytest-reverse
Version: 1.1.0
Summary: Pytest plugin to reverse test order.
Home-page: https://github.com/adamchainz/pytest-reverse
Author: Adam Johnson
Author-email: me@adamj.eu
License: MIT
Project-URL: Changelog, https://github.com/adamchainz/pytest-reverse/blob/master/HISTORY.rst
Project-URL: Twitter, https://twitter.com/adamchainz
Description: ==============
        pytest-reverse
        ==============
        
        .. image:: https://img.shields.io/github/workflow/status/adamchainz/pytest-reverse/CI/master?style=for-the-badge
           :target: https://github.com/adamchainz/pytest-reverse/actions?workflow=CI
        
        .. image:: https://img.shields.io/pypi/v/pytest-reverse.svg?style=for-the-badge
           :target: https://pypi.org/project/pytest-reverse/
        
        .. image:: https://img.shields.io/badge/code%20style-black-000000.svg?style=for-the-badge
           :target: https://github.com/psf/black
        
        .. image:: https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit&logoColor=white&style=for-the-badge
           :target: https://github.com/pre-commit/pre-commit
           :alt: pre-commit
        
        Pytest plugin to reverse test order.
        
        Installation
        ============
        
        Install from pip with:
        
        .. code-block:: bash
        
            python -m pip install pytest-reverse
        
        Python 3.6 to 3.9 supported.
        
        ----
        
        **Testing a Django project?**
        Check out my book `Speed Up Your Django Tests <https://gumroad.com/l/suydt>`__ which covers loads of best practices so you can write faster, more accurate tests.
        
        ----
        
        Usage
        =====
        
        Pytest will automatically find the plugin and use it when you run ``pytest``.
        You can reverse test order by passing the ``--reverse`` flag:
        
        .. code-block:: bash
        
            pytest --reverse
        
        You can make this always apply by adding it to the ``addopts`` setting in your
        ``pytest.ini`` (or `other configuration
        file <https://docs.pytest.org/en/latest/customize.html#adding-default-options>`__):
        
        .. code-block:: ini
        
            [pytest]
            addopts = --reverse
        
        History
        =======
        
        I'm the creator and maintainer of
        `pytest-randomly <https://github.com/pytest-dev/pytest-randomly>`__, a plugin
        for randomly ordering tests. @thbde opened an issue there pointing to the paper
        `Empirically revisiting the test independence
        assumption <https://dl.acm.org/doi/10.1145/2610384.2610404>`__, which covers
        test reordering techniques. It turns out that reversal is nearly as effective
        as randomization.
        
        Test reversal is available `in Django's test
        runner <https://docs.djangoproject.com/en/dev/ref/django-admin/#cmdoption-test-reverse>`__.
        I figured such an option or plugin would exist for pytest already, but it
        didn't, so I made it here.
        
Keywords: pytest,reverse
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Framework :: Pytest
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Requires-Python: >=3.6
Description-Content-Type: text/x-rst
