Add a docs-live nox session

pypa · Feb 21, 2021 · 2f9593f · 2f9593f
1 parent af788cc
commit 2f9593f
Showing 1 changed file with 15 additions and 0 deletions.
diff --git a/noxfile.py b/noxfile.py
@@ -143,6 +143,21 @@ def get_sphinx_build_command(kind):
     session.run(*get_sphinx_build_command("man"))
 
 
+@nox.session(name="docs-live")
+def docs_live(session):
+    session.install("-e", ".")
+    session.install("-r", REQUIREMENTS["docs"], "sphinx-autobuild")
+
+    session.run(
+        "sphinx-autobuild",
+        "-d=docs/build/doctrees/livehtml",
+        "-b=dirhtml",
+        "docs/html",
+        "docs/build/livehtml",
+        *session.posargs,
+    )
+
+
 @nox.session
 def lint(session):
     # type: (nox.Session) -> None