infra: api docs autoapi experimenting

docs/api_reference/conf.py

@@ -88,16 +88,20 @@ html_last_updated_fmt = "%b %d, %Y"
 # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
 # ones.
 extensions = [
-    "sphinx.ext.autodoc",
+    "autoapi.extension"
-    "sphinx.ext.autodoc.typehints",
+    # "sphinx.ext.autodoc",
-    "sphinx.ext.autosummary",
+    # "sphinx.ext.autodoc.typehints",
-    "sphinx.ext.napoleon",
+    # "sphinx.ext.autosummary",
-    "sphinx.ext.viewcode",
+    # "sphinx.ext.napoleon",
-    "sphinxcontrib.autodoc_pydantic",
+    # "sphinx.ext.viewcode",
-    "sphinx_copybutton",
+    # "sphinxcontrib.autodoc_pydantic",
-    "sphinx_panels",
+    # "sphinx_copybutton",
-    "IPython.sphinxext.ipython_console_highlighting",
+    # "sphinx_panels",
+    # "IPython.sphinxext.ipython_console_highlighting",
 ]
+autoapi_dirs = ["/Users/erickfriis/langchain/oss-py/libs/core/langchain_core"]
+autoapi_python_use_implicit_namespaces = True
+
 source_suffix = [".rst"]
 
 # some autodoc pydantic options are repeated in the actual template.

docs/api_reference/requirements.txt

@@ -6,9 +6,9 @@ pydantic<2
 autodoc_pydantic==1.8.0
 myst_parser
 nbsphinx==0.8.9
-sphinx>=5
+sphinx>=7
 sphinx-autobuild==2021.3.14
-sphinx_rtd_theme==1.0.0
+sphinx_rtd_theme==2.0.0
 sphinx-typlog-theme==0.8.0
 sphinx-panels
 toml

pyproject.toml

@@ -10,20 +10,15 @@ repository = "https://www.github.com/langchain-ai/langchain"
 
 [tool.poetry.dependencies]
 python = ">=3.8.1,<4.0"
+sphinx = "^7"
 
 [tool.poetry.group.docs.dependencies]
 langchain = { path = "libs/langchain/", develop = true }
 autodoc_pydantic = "^1.8.0"
-myst_parser = "^0.18.1"
 nbsphinx = "^0.8.9"
-sphinx = "^4.5.0"
+sphinx = "^7"
-sphinx-autobuild = "^2021.3.14"
+sphinx_rtd_theme = "^2.0.0"
-sphinx_book_theme = "^0.3.3"
-sphinx_rtd_theme = "^1.0.0"
-sphinx-typlog-theme = "^0.8.0"
-sphinx-panels = "^0.6.0"
 toml = "^0.10.2"
-myst-nb = "^0.17.1"
 linkchecker = "^10.2.1"
 sphinx-copybutton = "^0.5.1"
 nbdoc = "^0.0.82"