Metadata-Version: 2.4
Name: pytest-astropy
Version: 0.11.0
Summary: Meta-package containing dependencies for testing
Home-page: https://github.com/astropy/pytest-astropy
Author: The Astropy Developers
Author-email: astropy.team@gmail.com
License: BSD
Keywords: pytest,remotedata,doctestplus,hypothesis,property-based testing
Classifier: Development Status :: 5 - Production/Stable
Classifier: Framework :: Pytest
Classifier: Framework :: Hypothesis
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Topic :: Software Development :: Testing
Classifier: Topic :: Utilities
Requires-Python: >=3.7
Description-Content-Type: text/x-rst
License-File: LICENSE.rst
Requires-Dist: pytest>=4.6
Requires-Dist: pytest-doctestplus>=1.0.0
Requires-Dist: pytest-remotedata>=0.4.1
Requires-Dist: pytest-astropy-header>=0.2.2
Requires-Dist: pytest-arraydiff>=0.5
Requires-Dist: pytest-filter-subpackage>=0.1.2
Requires-Dist: pytest-cov>=2.3.1
Requires-Dist: pytest-mock>=2.0
Requires-Dist: attrs>=19.2.0
Requires-Dist: hypothesis>=5.1
Dynamic: license-file

==============
pytest-astropy
==============

.. image:: https://zenodo.org/badge/104255122.svg
   :target: https://zenodo.org/badge/latestdoi/104255122
   :alt: Zenodo DOI

This is a meta-package that pulls in the dependencies that are used by
`astropy`_ and some `affiliated packages`_ for testing. It can also be used for
testing packages that are not affiliated with the Astropy project.

This package also provides pytest markers for cpu and memory intensive tests
(``pytest.mark.slow`` and ``pytest.mark.hugemem``). Tests marked with those
markers are not run by default, can be run with the other tests with
``--run-slow`` and ``--run-hugemem``, and can be run separately with ``-m slow``
and ``-m hugemem``.

The package also provides the short option ``-R`` for ``--remote-data``.

.. _astropy: https://docs.astropy.org/en/latest/
.. _affiliated packages: https://astropy.org/affiliated

Dependencies
------------

The following dependencies are installed by this package:

* The `pytest`_ testing framework for Python.
* `pytest-astropy-header`_, a ``pytest`` plugin used for custom test header.
* `pytest-remotedata`_, a ``pytest`` plugin used for controlling access to data
  files hosted online.
* `pytest-doctestplus`_, a ``pytest`` plugin that provides advanced features
  for testing example code in documentation.
* `pytest-arraydiff`_, a ``pytest`` plugin that enables the generation and
  comparison of data arrays produced during unit tests.
* `pytest-filter-subpackage`_, a ``pytest`` plugin that adds a ``-P`` option to
  pytest to filter by sub-package.
* `pytest-mock`_,  a thin-wrapper around the mock package for easier use
  with ``pytest``.
* `pytest-cov`_, a ``pytest`` plugin to measure test coverage.
* `hypothesis`_, a Python library for property based testing.

.. _pytest: https://doc.pytest.org
.. _pytest-astropy-header: https://github.com/astropy/pytest-astropy-header
.. _pytest-remotedata: https://github.com/astropy/pytest-remotedata
.. _pytest-doctestplus: https://github.com/astropy/pytest-doctestplus
.. _pytest-arraydiff: https://github.com/astropy/pytest-arraydiff
.. _pytest-filter-subpackage: https://github.com/astropy/pytest-filter-subpackage
.. _pytest-mock: https://github.com/pytest-dev/pytest-mock
.. _pytest-cov: https://github.com/pytest-dev/pytest-cov
.. _hypothesis: https://hypothesis.readthedocs.io

Installation
------------

The ``pytest-astropy`` plugin can be installed using ``pip``::

    $ pip install pytest-astropy

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

    $ git clone https://github.com/astropy/pytest-astropy
    $ cd pytest-astropy
    $ python ./setup.py install

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

Development Status
------------------

Questions, bug reports, and feature requests can be submitted on `github`_.

.. _github: https://github.com/astropy/pytest-astropy

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