build: add the ability to specify where generated demos are stored and also some light refactoring of the noxfile.py

Author: 56kyle

noxfile.py

@@ -1,5 +1,5 @@
 """Noxfile for the cookiecutter-robust-python template."""
-
+import os
 import shutil
 import tempfile
 from pathlib import Path
@@ -15,6 +15,7 @@
 DEFAULT_TEMPLATE_PYTHON_VERSION = "3.9"
 
 REPO_ROOT: Path = Path(__file__).parent.resolve()
+SCRIPTS_FOLDER: Path = REPO_ROOT / "scripts"
 TEMPLATE_FOLDER: Path = REPO_ROOT / "{{cookiecutter.project_name}}"
 
 
@@ -26,16 +27,21 @@
     )
 ).resolve()
 
-PROJECT_DEMOS_FOLDER: Path = COOKIECUTTER_ROBUST_PYTHON_CACHE_FOLDER / "project_demos"
-DEFAULT_DEMO_NAME: str = "demo-project"
+DEFAULT_PROJECT_DEMOS_FOLDER = COOKIECUTTER_ROBUST_PYTHON_CACHE_FOLDER / "project_demos"
+PROJECT_DEMOS_FOLDER: Path = os.environ.get(
+    "COOKIECUTTER_ROBUST_PYTHON_PROJECT_DEMOS_FOLDER", default=DEFAULT_PROJECT_DEMOS_FOLDER
+)
+DEFAULT_DEMO_NAME: str = "robust-python-demo"
 DEMO_ROOT_FOLDER: Path = PROJECT_DEMOS_FOLDER / DEFAULT_DEMO_NAME
 
+GENERATE_DEMO_PROJECT_SCRIPT: Path = SCRIPTS_FOLDER / "generate-demo-project.py"
 GENERATE_DEMO_PROJECT_OPTIONS: tuple[str, ...] = (
     *("--repo-folder", REPO_ROOT),
     *("--demos-cache-folder", PROJECT_DEMOS_FOLDER),
     *("--demo-name", DEFAULT_DEMO_NAME),
 )
 
+SYNC_UV_WITH_DEMO_SCRIPT: Path = SCRIPTS_FOLDER / "sync-uv-with-demo.py"
 SYNC_UV_WITH_DEMO_OPTIONS: tuple[str, ...] = (
     *("--template-folder", TEMPLATE_FOLDER),
     *("--demos-cache-folder", PROJECT_DEMOS_FOLDER),
@@ -48,9 +54,8 @@ def generate_demo_project(session: Session) -> None:
     session.install("cookiecutter", "platformdirs", "loguru", "typer")
     session.run(
         "python",
-        "scripts/generate-demo-project.py",
+        GENERATE_DEMO_PROJECT_SCRIPT,
         *GENERATE_DEMO_PROJECT_OPTIONS,
-        external=True,
     )
 
 
@@ -59,9 +64,8 @@ def sync_uv_with_demo(session: Session) -> None:
     session.install("cookiecutter", "platformdirs", "loguru", "typer")
     session.run(
         "python",
-        "scripts/sync-uv-with-demo.py",
+        SYNC_UV_WITH_DEMO_SCRIPT,
         *SYNC_UV_WITH_DEMO_OPTIONS,
-        external=True,
     )
 
 
@@ -70,17 +74,15 @@ def uv_in_demo(session: Session) -> None:
     session.install("cookiecutter", "platformdirs", "loguru", "typer")
     session.run(
         "python",
-        "scripts/generate-demo-project.py",
+        GENERATE_DEMO_PROJECT_SCRIPT,
         *GENERATE_DEMO_PROJECT_OPTIONS,
-        external=True,
     )
     original_dir: Path = Path.cwd()
     session.cd(DEMO_ROOT_FOLDER)
     session.run("uv", *session.posargs)
     session.cd(original_dir)
     session.run(
-        "python",
-        "scripts/sync-uv-with-demo.py",
+        SYNC_UV_WITH_DEMO_SCRIPT,
         *SYNC_UV_WITH_DEMO_OPTIONS,
         external=True,
     )
@@ -91,7 +93,7 @@ def in_demo(session: Session) -> None:
     session.install("cookiecutter", "platformdirs", "loguru", "typer")
     session.run(
         "python",
-        "scripts/generate-demo-project.py",
+        GENERATE_DEMO_PROJECT_SCRIPT,
         *GENERATE_DEMO_PROJECT_OPTIONS,
     )
     original_dir: Path = Path.cwd()
@@ -124,13 +126,14 @@ def lint(session: Session):
     session.run("ruff", "check", "--verbose", "--fix")
 
 
-@nox.session(python=DEFAULT_TEMPLATE_PYTHON_VERSION)
+@nox.session(python=None)
 def lint_generated_project(session: Session):
     """Lint the generated project's Python files and configurations."""
     session.log("Installing linting dependencies for the generated project...")
-    session.install("-e", ".", "--group", "dev", "--group", "lint")
-    session.notify("in-demo", ["nox", "-s", "pre-commit"])
-    session.notify("in-demo", )
+    session.install("-e", ".", "--group", "dev")
+    session._runner.posargs = ["nox", "-s", "pre-commit"]
+    in_demo(session)
+    session._runner.posargs = [""]
     session.run("retrocookie")