chore: using pdoc instead of pdoc3 for doc build

We cannot support repos that clearly engage into  backhanded tactics: pdoc3/pdoc#64

Author: kjczarne

kalash/__init__.py

@@ -10,5 +10,5 @@
 .. include:: ./pdoc/contributing.md
 .. include:: ./pdoc/trailer.md
 """
-
+__docformat__ = "restructuredtext"
 __version__ = "4.0.0"

kalash/run.py

@@ -378,7 +378,7 @@ def make_loader_and_trigger_object(
 def docs():
     """Open bundled documentation in the web browser."""
     base_dir = os.path.dirname(__file__)
-    rel_docpath = ['built_docs', 'html', 'kalash', 'index.html']
+    rel_docpath = ['built_docs', 'kalash.html']
     docpath = os.path.join(base_dir, *rel_docpath)
     _platform = platform.system()
     if _platform == "Darwin" or "Linux":

noxfile.py

@@ -26,7 +26,7 @@ class Tasks:
     coverage = lambda posargs: f'coverage {posargs}'
     build_wheel = 'python -m setup bdist_wheel'
     send = r'twine upload dist/*.whl -u __token__ -p'
-    docs = 'pdoc --html kalash --force'
+    docs = 'pdoc kalash -o .'
     quality = 'flake8'
 
 
@@ -100,7 +100,7 @@ def docs(session: nox.Session):
     if not os.path.exists(built_docs_dir):
         os.makedirs(built_docs_dir)
     _copy_and_sanitize_paths_for_pdoc3('kalash/doc', pdoc_dir)
-    session.install('pdoc3', '.')
+    session.install('pdoc', '.')
     cwd = os.getcwd()
     session.chdir(built_docs_dir)
     session.run(*split_cmd(Tasks.docs))