chore: update demo to the latest cookiecutter-robust-python

Author: 56kyle

.cookiecutter.json

@@ -1,5 +1,5 @@
 {
-  "_commit": "4b485513573db074f963642920993ad357792207",
+  "_commit": "9cc43c6456a28624d29b85487b7f974e8f196397",
   "_template": "C:\\Users\\56kyl\\source\\repos\\cookiecutter-robust-python",
   "add_rust_extension": false,
   "author": "Kyle Oliver",

.cruft.json

@@ -1,6 +1,6 @@
 {
   "template": "C:\\Users\\56kyl\\source\\repos\\cookiecutter-robust-python",
-  "commit": "4b485513573db074f963642920993ad357792207",
+  "commit": "9cc43c6456a28624d29b85487b7f974e8f196397",
   "checkout": null,
   "context": {
     "cookiecutter": {
@@ -20,7 +20,7 @@
       "license": "MIT",
       "development_status": "Development Status :: 1 - Planning",
       "_template": "C:\\Users\\56kyl\\source\\repos\\cookiecutter-robust-python",
-      "_commit": "4b485513573db074f963642920993ad357792207"
+      "_commit": "9cc43c6456a28624d29b85487b7f974e8f196397"
     }
   },
   "directory": null

noxfile.py

@@ -45,18 +45,18 @@
 QUALITY: str = "quality"
 
 
-@nox.session(python=False, name="setup-git", tags=[ENV])
-def setup_git(session: Session) -> None:
-    """Set up the git repo for the current project."""
-    session.run("python", SCRIPTS_FOLDER / "setup-git.py", REPO_ROOT, external=True)
-
-
 @nox.session(python=False, name="setup-venv", tags=[ENV])
 def setup_venv(session: Session) -> None:
     """Set up the virtual environment for the current project."""
     session.run("python", SCRIPTS_FOLDER / "setup-venv.py", REPO_ROOT, "-p", PYTHON_VERSIONS[0], external=True)
 
 
+@nox.session(python=False, name="setup-git", tags=[ENV])
+def setup_git(session: Session) -> None:
+    """Set up the git repo for the current project."""
+    session.run("python", SCRIPTS_FOLDER / "setup-git.py", REPO_ROOT, external=True)
+
+
 @nox.session(python=False, name="setup-remote")
 def setup_remote(session: Session) -> None:
     """Set up the remote repository for the current project."""
@@ -156,6 +156,21 @@ def docs_build(session: Session) -> None:
     session.log("Building documentation.")
     session.run("sphinx-build", "-b", "html", "docs", str(docs_build_dir), "-W")
 
+@nox.session(python=DEFAULT_PYTHON_VERSION, name="docs", tags=[DOCS, BUILD])
+def docs(session: Session) -> None:
+    """Build and serve the project documentation (Sphinx)."""
+    session.log("Installing documentation dependencies...")
+    session.install("-e", ".", "--group", "docs")
+
+    session.log(f"Building documentation with py{session.python}.")
+    docs_build_dir = Path("docs") / "_build" / "html"
+
+    session.log(f"Cleaning build directory: {docs_build_dir}")
+    session.run("sphinx-build", "-b", "html", "docs", str(docs_build_dir), "-E")
+
+    session.log("Building and serving documentation.")
+    session.run("sphinx-autobuild", "--open-browser", "docs", str(docs_build_dir))
+
 
 @nox.session(python=False, name="build-python", tags=[BUILD])
 def build_python(session: Session) -> None:

pyproject.toml

@@ -40,6 +40,7 @@ docs = [
     "furo>=2024.8.6",
     "myst-parser>=3.0.1",
     "sphinx>=7.4.7",
+    "sphinx-autobuild>=2024.10.3",
     "sphinx-autodoc-typehints>=2.3.0",
     "sphinx-copybutton>=0.5.2",
     "sphinx-tabs>=3.4.7",

scripts/setup-git.py

@@ -23,10 +23,9 @@ def setup_git(path: Path) -> None:
     commands: list[list[str]] = [
         ["git", "init"],
         ["git", "branch", "-m", "master", "main"],
-        ["git", "checkout", "main"],
-        ["git", "checkout", "-b", "develop", "main"],
         ["git", "add", "."],
         ["git", "commit", "-m", "feat: initial commit"],
+        ["git", "checkout", "-b", "develop", "main"],
     ]
     check_dependencies(path=path, dependencies=["git"])