Metadata-Version: 2.4
Name: sphinx-automodapi
Version: 0.22.0
Summary: Sphinx extension for auto-generating API documentation for entire modules
Home-page: https://github.com/astropy/sphinx-automodapi
Author: The Astropy Developers
Author-email: astropy.team@gmail.com
License: BSD-3-Clause
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Requires-Python: >=3.10
Description-Content-Type: text/x-rst
License-File: LICENSE.rst
Requires-Dist: packaging
Requires-Dist: sphinx>=5
Provides-Extra: test
Requires-Dist: pytest; extra == "test"
Requires-Dist: pytest-cov; extra == "test"
Requires-Dist: cython; extra == "test"
Requires-Dist: coverage; extra == "test"
Requires-Dist: setuptools; python_version >= "3.12" and extra == "test"
Provides-Extra: rtd
Requires-Dist: sphinx-rtd-theme; extra == "rtd"
Dynamic: license-file

|DOI| |PyPI| |Docs| |CI Status| |Coverage Status|

About
=====

This is a Sphinx extension to automatically generate API pages for whole
modules. It was originally developed for the Astropy project but is now
available as a standalone package since it can be used for any other
package. The documentation can be found on
`ReadTheDocs <http://sphinx-automodapi.readthedocs.io/en/latest/>`_.

Running tests
-------------

To run the tests, you can either do::

    pytest sphinx_automodapi

or if you have `tox <https://tox.readthedocs.io/en/latest/>`_ installed::

    tox -e test

.. |DOI| image:: https://zenodo.org/badge/DOI/10.5281/zenodo.5799977.svg
  :target: https://doi.org/10.5281/zenodo.5799977
.. |PyPI| image:: https://img.shields.io/pypi/v/sphinx-automodapi.svg
  :target: https://pypi.python.org/pypi/sphinx-automodapi
.. |Docs| image:: https://readthedocs.org/projects/sphinx-automodapi/badge/?version=latest
    :target: https://sphinx-automodapi.readthedocs.io/en/latest/?badge=latest
.. |CI Status| image:: https://github.com/astropy/sphinx-automodapi/workflows/CI/badge.svg
  :target: https://github.com/astropy/sphinx-automodapi/actions
.. |Coverage Status| image:: https://codecov.io/gh/astropy/sphinx-automodapi/branch/main/graph/badge.svg
  :target: https://codecov.io/gh/astropy/sphinx-automodapi

Development status
------------------

Due to the limitations of FOSS development model, the Astropy Project
does not have enough bandwidth to add new features or fixes to this
package beyond what is necessary for the project itself. Therefore,
we apologize for any inconvenience caused by unresolved open issues
and unmerged stale pull requests. If you have any questions or concerns,
please contact the project via https://www.astropy.org/help .
Thank you for your interest in this package!
