Metadata-Version: 2.1
Name: pytest-mark-no-py3
Version: 0.1.0
Summary: pytest plugin and bowler codemod to help migrate tests to Python 3
Home-page: https://github.com/GoodRx/pytest-mark-no-py3
License: MIT
Description: pytest-mark-no-py3
        ==================
        
        This package provides a pytest plugin and a [Bowler](https://pybowler.io/)
        codemod to help migrate tests to Python 3.
        
        Any tests marked with `@pytest.mark.no_py3` will be expected to fail when
        running on Python 3 and will fail the test if they pass unexpectedly.
        
        Usage
        -----
        
        ### Adding `@pytest.mark.no_py3`
        
        1. Install this package in your test dependencies.
        
        2. Run your tests on Python 3, savings the results with pytest's `--result-log`
           option, e.g.:
        
           ```sh
           tox -e py37 -- --result-log=test-results.txt
           ```
        
        3. Install this package with the `bowler` extras in a Python 3 virtualenv:
        
           ```sh
           pip install pytest_mark_no_py3[bowler]
           ```
        
        4. Apply the marker to all of the tests that failed on Python 3, running from
           the same directory that you ran the tests from:
        
           ```sh
           python -m pytest_mark_no_py3.add --result-log=path/to/result-log.txt path/to/your/tests
           ```
        
           If you're feeling confident, you can also use the `--no-interactive` option
           to apply the codemod without prompting to accept changes.
        
        ### Removing `@pytest.mark.no_py3`
        
        1. Fix some code so that tests start passing on Python 3, violating the xfail.
        
        2. Run your tests on Python 3, savings the results with pytest's `--result-log`
           option, e.g.:
        
           ```sh
           tox -e py37 -- --result-log=test-results.txt
           ```
        
           **Warning:** The only failing tests should be the tests that you fixed and
           want the marker removed from!
        
        3. Install this package with the `bowler` extras in a Python 3 virtualenv:
        
           ```sh
           pip install pytest_mark_no_py3[bowler]
           ```
        
        4. Remove the marker from all of the tests that "failed" (i.e. were expected to
           fail but actually passed) on Python 3, running from the same directory that
           you ran the tests from:
        
           ```sh
           python -m pytest_mark_no_py3.remove --result-log=path/to/result-log.txt path/to/your/tests
           ```
        
           If you're feeling confident, you can also use the `--no-interactive` option
           to apply the codemod without prompting to accept changes.
        
        Running tests
        -------------
        
        Run `tox`.
        
Platform: UNKNOWN
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: License :: OSI Approved :: MIT License
Description-Content-Type: text/markdown
Provides-Extra: bowler
