docs: nicer types in docs (#688)

Signed-off-by: Henry Schreiner <[email protected]>

Author: henryiii

docs/conf.py

@@ -23,6 +23,7 @@
     "sphinx.ext.autodoc",
     "sphinx.ext.viewcode",
     "sphinx_design",
+    "sphinx_autodoc_typehints",
 ]
 
 # List of patterns, relative to source directory, that match files and
@@ -72,6 +73,7 @@
     ("py:class", klass)
     for klass in [
         "Path",
+        "pathlib._local.Path",
         "docutils.nodes.document",
         "docutils.nodes.Node",
         "docutils.nodes.Element",

pyproject.toml

@@ -86,6 +86,7 @@ rtd = [
     "sphinx-design",
     "sphinxcontrib-bibtex",
     "sympy",
+    "sphinx-autodoc-typehints",
 ]
 testing = [
     "coverage>=6.4",