Metadata-Version: 2.0
Name: pytest-skippy
Version: 0.1.1
Summary: Automatically skip tests that don't need to run!
Home-page: https://github.com/a-feld/pytest-skippy
Author: Allan Feldman
Author-email: allan.d.feldman@gmail.com
License: MIT
Description-Content-Type: UNKNOWN
Keywords: pytest incremental testing
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Testing
Classifier: Framework :: Pytest
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Environment :: Console
Requires-Dist: pytest (>=2.3.4)
Requires-Dist: stdlib-list (>=0.4.0)
Provides-Extra: dev
Requires-Dist: tox; extra == 'dev'
Requires-Dist: pytest; extra == 'dev'
Requires-Dist: pytest-git; extra == 'dev'
Requires-Dist: flake8; extra == 'dev'
Requires-Dist: coverage; extra == 'dev'
Requires-Dist: gitpython; extra == 'dev'
Requires-Dist: sphinx; extra == 'dev'
Requires-Dist: sphinx-rtd-theme; extra == 'dev'

.. image:: https://img.shields.io/pypi/v/pytest-skippy.svg
   :target: https://pypi.org/project/pytest-skippy/
.. image:: https://readthedocs.org/projects/pytest-skippy/badge/?version=latest
    :target: https://pytest-skippy.readthedocs.io/en/latest/?badge=latest
.. image:: https://travis-ci.org/a-feld/pytest-skippy.svg?branch=master
    :target: https://travis-ci.org/a-feld/pytest-skippy
.. image:: https://ci.appveyor.com/api/projects/status/github/a-feld/pytest-skippy?svg=true
    :target: https://ci.appveyor.com/project/a-feld/pytest-skippy/branch/master
.. image:: https://codecov.io/gh/a-feld/pytest-skippy/branch/master/graph/badge.svg
    :target: https://codecov.io/gh/a-feld/pytest-skippy

***************
pytest skippy
***************

Automatically skip tests that don't need to run!

Most tests that are run on a pull request don't actually exercise the changes
that are made. By running all tests (even if those tests are not relevant), the
test suite takes longer to complete and more machines may be needed to
parallelize tests to cut down on test time.

*pytest-skippy* detects which tests don't need to run by generating a
complete import graph for your tests. If nothing in the import graph has
changed (according to GIT), the test is skipped! This approach saves time
(getting you test results faster) and money (using less machines for parallel
builds)!

Installation
############

.. code:: bash

    pip install pytest-skippy

Usage
######

Add the ``--skippy`` option to your pytest command.

To specify a target branch, use the ``--skippy-target-branch`` option.

Example::

    py.test --skippy --skippy-target-branch origin/master

* docs: https://pytest-skippy.readthedocs.io
* repository: https://github.com/a-feld/pytest-skippy


