Add a docs-live nox session

pypa · Feb 4, 2021 · a4557fe · a4557fe
1 parent 8d055b5
commit a4557fe
Showing 1 changed file with 14 additions and 0 deletions.
diff --git a/noxfile.py b/noxfile.py
@@ -139,6 +139,20 @@ 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/html",
+        "-b=dirhtml",
+        "docs/html",
+        "docs/build/html",
+    )
+
+
 @nox.session
 def lint(session):
     session.install("pre-commit")