use pdoc to genrate markdown api docs

.gitignore

@@ -110,3 +110,4 @@ resources/_gen/
 # Misc
 .local/
 .corenetworks*
+docs/api/corenetworks/

Makefile

@@ -1,7 +1,9 @@
 export GEEKDOC_VERSION ?= latest
-BASE_DIR := docs
 THEME := hugo-geekdoc
-THEME_DIR := $(BASE_DIR)/themes
+BASEDIR := docs
+THEMEDIR := $(BASEDIR)/themes
+APIDIR := $(BASEDIR)/content/api
+PACKAGE := corenetworks
 
 .PHONY: all
 all: doc
@@ -11,16 +13,17 @@ doc: doc-assets doc-generate
 
 .PHONY: doc-assets
 doc-assets:
-	mkdir -p $(THEME_DIR)/$(THEME)/ ; \
+	mkdir -p $(THEMEDIR)/$(THEME)/ ; \
-	curl -sSL "https://github.com/xoxys/$(THEME)/releases/$${GEEKDOC_VERSION}/download/$(THEME).tar.gz" | tar -xz -C $(THEME_DIR)/$(THEME)/ --strip-components=1
+	curl -sSL "https://github.com/xoxys/$(THEME)/releases/$${GEEKDOC_VERSION}/download/$(THEME).tar.gz" | tar -xz -C $(THEMEDIR)/$(THEME)/ --strip-components=1
 
 .PHONY: doc-generate
 doc-generate:
-	cd $(BASE_DIR) ; \
+	pdoc --template-dir $(BASEDIR)/templates/ -o $(APIDIR) --force \
-	cp templates/usage_index.md content/usage/_index.md ; \
+		$(PACKAGE).authenticators \
-	pydocmd simple corenetworks.authenticators++ corenetworks.client++ corenetworks.exceptions++ >> content/usage/_index.md
+		$(PACKAGE).client \
+		$(PACKAGE).exceptions
 
 .PHONY: clean
 clean:
-	rm -rf $(THEME_DIR) && \
+	rm -rf $(THEMEDIR) && \
-	rm -f $(BASE_DIR)/content/usage/_index.md
+	rm -rf $(APIDIR)/$(PACKAGE)

dev-requirements.txt

@@ -18,4 +18,4 @@ pytest-cov
 bandit
 requests-mock
 yapf
-pydoc-markdown
+pdoc; python_version >= "3.6"

docs/data/menu/main.yml

@@ -2,5 +2,11 @@
 main:
   - name: Setup
     ref: "/setup"
-  - name: Usage
+  - name: API
-    ref: "/usage"
+    sub:
+      - name: corenetworks.authenticators
+        ref: "/api/corenetworks/authenticators"
+      - name: corenetworks.client
+        ref: "/api/corenetworks/client"
+      - name: corenetworks.exceptions
+        ref: "/api/corenetworks/exceptions"

docs/templates/usage_index.md

@@ -1,5 +0,0 @@
----
-title: Usage
----
-
-{{< toc >}}