Include category, query modules in generated docs

Move README contents to package __init__: this is the index.
lukasschwab · Aug 31, 2021 · 10c3469 · 10c3469
1 parent 6c07450
commit 10c3469
Show file tree

Hide file tree

Showing 10 changed files with 7,680 additions and 3,508 deletions.
diff --git a/Makefile b/Makefile
@@ -13,10 +13,7 @@ test: $(source) $(tests)
 
 docs: docs/index.html
 docs/index.html: $(source) README.md
-	pdoc --docformat "restructuredtext" ./arxiv/arxiv.py -o docs
-	mv docs/arxiv/arxiv.html docs/index.html
-	rmdir docs/arxiv
-	rm docs/search.json
+	pdoc --docformat "restructuredtext" ./arxiv -o docs
 
 clean:
 	rm -rf build dist

diff --git a/arxiv/__init__.py b/arxiv/__init__.py
@@ -1,3 +1,4 @@
+""".. include:: ../README.md"""
 # flake8: noqa
 from .arxiv import *
 from .query import *
diff --git a/arxiv/arxiv.py b/arxiv/arxiv.py
@@ -1,4 +1,3 @@
-""".. include:: ../README.md"""
 import logging
 import time
 import feedparser

diff --git a/arxiv/query.py b/arxiv/query.py
@@ -9,7 +9,7 @@ def __init__(self, query_string: str = ""):
         self._query_string = query_string
 
     # FIXME: check if value is a Category?
-    def attribute(attribute: "Query.Attribute", value: str) -> "Query":
+    def attribute(attribute: "Attribute", value: str) -> "Query":
         return Query('{}:"{}"'.format(attribute.value, value))
 
     def __compose(self, other: "Query", operator: "Query.Operator"):

diff --git a/docs/arxiv.html b/docs/arxiv.html
diff --git a/docs/arxiv/arxiv.html b/docs/arxiv/arxiv.html
diff --git a/docs/arxiv/category.html b/docs/arxiv/category.html
diff --git a/docs/arxiv/query.html b/docs/arxiv/query.html
diff --git a/docs/index.html b/docs/index.html
diff --git a/docs/search.json b/docs/search.json