This package contains a simple plugin for the pytest framework that provides a shortcut to testing all code and documentation for a given sub-package.

The pytest-filter-subpackage plugin can be installed using pip:

$ pip install pytest-filter-subpackage

It is also possible to install the latest development version from the source repository:

$ git clone https://github.com/astropy/pytest-filter-subpackage
$ cd pytest-filter-subpackage
$ pip install .

In either case, the plugin will automatically be registered for use with pytest.

This plugin provides a -P option which takes a comma-separated list of sub-package names (without the top-level package name):

pytest -P wcs,io.fits

which is equivalent to:

pytest **/wcs **/io/fits

When used in conjunction with pytest-doctestplus this will result in both the narrative documentation and code being tested for a given sub-package.

This plugin is licensed under a 3-clause BSD style license - see the LICENSE.rst file.