[doc] use sphinx-autoapi (tomplus#242)

Author: tomplus

doc/Makefile

@@ -2,7 +2,6 @@
 #
 
 # You can set these variables from the command line.
-SPHINXAPIDOC  = sphinx-apidoc
 SPHINXOPTS    = -c source
 SPHINXBUILD   = sphinx-build
 SPHINXPROJ    = kubernetes-client
@@ -17,7 +16,7 @@ help:
 
 # Catch-all target: route all unknown targets to Sphinx using the new
 # "make mode" option.  $(O) is meant as a shortcut for $(SPHINXOPTS).
+
 html:
-	$(SPHINXAPIDOC) -o "$(SOURCEDIR)" ../kubernetes_asyncio/ -e -f
 	$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
 	@echo "\nDocs rendered successfully, open _/build/html/index.html to view"

doc/source/conf.py

@@ -26,11 +26,15 @@
 # Add any Sphinx extension module names here, as strings. They can be
 # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom ones.
 extensions = [
+    'autoapi.extension',
     'sphinx.ext.autodoc',
     # 'myst_parser',
     # 'sphinx.ext.intersphinx',
 ]
 
+autoapi_type = 'python'
+autoapi_dirs = ['../../kubernetes_asyncio/']
+
 
 # autodoc generation is a bit aggressive and a nuisance when doing heavy
 # text edit cycles.

test-requirements.txt

@@ -11,3 +11,4 @@ pytest-xdist
 randomize>=0.13
 recommonmark
 sphinx>=1.2.1,!=1.3b1,<6.2 # BSD
+sphinx-autoapi