EXP: Try using sphinx-autoapi instead of sphinx-automodapi

.gitignore

@@ -19,6 +19,7 @@ MANIFEST
 
 # Sphinx
 docs/api
+docs/autoapi
 docs/_build
 
 # Eclipse editor project files

docs/Makefile

@@ -38,6 +38,7 @@ help:
 clean:
 	-rm -rf $(BUILDDIR)
 	-rm -rf api
+	-rm -r autoapi
 	-rm -rf generated
 
 html:

docs/conf.py

@@ -10,6 +10,22 @@
     print("ERROR: the documentation requires the sphinx-astropy package to be installed")
     sys.exit(1)
 
+extensions.append("sphinx.ext.autodoc")
+extensions.append("autoapi.extension")
+
+autoapi_dirs = ["../reproject"]
+autoapi_options = [
+    "members",
+    "imported-members",
+    "inherited-members",
+    "show-inheritance",
+    "undoc-members",
+]
+autoapi_own_page_level = "function"
+autoapi_ignore = ["**/tests/**", "**/tests/", "**/conftest.py", "**/version.py"]
+
+suppress_warnings.append("autoapi.python_import_resolution")
+
 # -- General configuration ----------------------------------------------------
 
 # By default, highlight as Python 3.

docs/index.rst

@@ -156,15 +156,3 @@ that you want to reproject.
    mosaicking
    performance
    performance_mosaicking
-
-Reference/API
-=============
-
-.. automodapi:: reproject
-   :no-inheritance-diagram:
-
-.. automodapi:: reproject.hips
-   :no-inheritance-diagram:
-
-.. automodapi:: reproject.mosaicking
-   :no-inheritance-diagram:

pyproject.toml

@@ -44,6 +44,7 @@ testall = [
 ]
 docs = [
     "sphinx-astropy",
+    "sphinx-autoapi",
     "pyvo",
     "matplotlib",
     "tqdm",

reproject/hips/__init__.py

@@ -1,2 +1,8 @@
-from .high_level import *  # noqa
-from ._dask_array import hips_as_dask_array  # noqa
+from ._dask_array import hips_as_dask_array
+from .high_level import (
+    coadd_hips,
+    reproject_from_hips,
+    reproject_to_hips,
+)
+
+__all__ = ["reproject_from_hips", "reproject_to_hips", "coadd_hips", "hips_as_dask_array"]

reproject/mosaicking/__init__.py

@@ -1,2 +1,4 @@
-from .coadd import *  # noqa
-from .wcs_helpers import *  # noqa
+from .coadd import reproject_and_coadd
+from .wcs_helpers import find_optimal_celestial_wcs
+
+__all__ = ["reproject_and_coadd", "find_optimal_celestial_wcs"]