feat: adjust names of sessions in noxfile and various aspects of its functioning

Author: 56kyle

{{cookiecutter.project_name}}/noxfile.py

@@ -1,31 +1,28 @@
-# noxfile.py
-# See https://nox.thea.codes/en/stable/config.html
+"""Noxfile for the {{cookiecutter.project_name}} project."""
 
-from pathlib import Path # Use pathlib for path manipulation
-from typing import Any # Import Any for type hints
-from typing import List # Import List for type hints
-from typing import Optional # Import Optional for type hints
+from pathlib import Path
+from typing import List
 
 import nox
-from nox.sessions import Session # Import Session type for hinting
+from nox.command import CommandFailed
+from nox.sessions import Session
 
 nox.options.default_venv_backend = "uv"
-nox.options.sessions = ["default"]
 
 # Logic that helps avoid metaprogramming in cookiecutter-robust-python
-MIN_PYTHON_VERSION_SLUG: int = int({{ cookiecutter.min_python_version }} * 100)
-MAX_PYTHON_VERSION_SLUG: int = int({{ cookiecutter.max_python_version }} * 100)
+MIN_PYTHON_VERSION_SLUG: int = int("{{cookiecutter.min_python_version}}".lstrip("3."))
+MAX_PYTHON_VERSION_SLUG: int = int("{{cookiecutter.max_python_version}}".lstrip("3."))
 
-# Python versions to test against. As of April 2025, generally 3.9-3.13 are actively supported.
+# Python versions to test against. As of April {{cookiecutter.copyright_year}}, generally {{cookiecutter.min_python_version}}-{{cookiecutter.max_python_version}} are actively supported.
 # See: https://devguide.python.org/versions/ and https://endoflife.date/python
 PYTHON_VERSIONS: List[str] = [
-    str(VERSION_SLUG / 100) for VERSION_SLUG in range(MIN_PYTHON_VERSION_SLUG, MAX_PYTHON_VERSION_SLUG + 1)
+    f"3.{VERSION_SLUG}" for VERSION_SLUG in range(MIN_PYTHON_VERSION_SLUG, MAX_PYTHON_VERSION_SLUG + 1)
 ]
 DEFAULT_PYTHON_VERSION: str = PYTHON_VERSIONS[-1]
 
 REPO_ROOT: Path = Path(__file__).parent
 CRATES_FOLDER: Path = REPO_ROOT / "rust"
-PACKAGE_NAME: str = "{{ cookiecutter.package_name }}"
+PACKAGE_NAME: str = "{{cookiecutter.package_name}}"
 
 
 # --- GRANULAR TASK AUTOMATION SESSIONS ---
@@ -54,7 +51,7 @@ def lint_python(session: Session) -> None:
 
 
 @nox.session(python=PYTHON_VERSIONS)
-def typecheck_python(session: Session) -> None:
+def typecheck(session: Session) -> None:
     """Run static type checking (Pyright) on Python code."""
     session.log("Installing type checking dependencies...")
     session.run("uv", "sync", "--locked", "--clean", "--groups", "dev", "typecheck", external=True)
@@ -63,7 +60,7 @@ def typecheck_python(session: Session) -> None:
     session.run("uv", "run", "pyright", external=True)
 
 
-@nox.session(python=DEFAULT_PYTHON_VERSION)
+@nox.session(python=DEFAULT_PYTHON_VERSION, name="security-python")
 def security_python(session: Session) -> None:
     """Run code security checks (Bandit) on Python code."""
     session.log("Installing security dependencies...")
@@ -76,8 +73,8 @@ def security_python(session: Session) -> None:
     session.run("uv", "run", "pip-audit", "--python", str(Path(session.python)), external=True)
 
 
-@nox.session(python=PYTHON_VERSIONS)
-def test_python(session: Session) -> None:
+@nox.session(python=PYTHON_VERSIONS, name="tests-python")
+def tests_python(session: Session) -> None:
     """Run the Python test suite (pytest with coverage)."""
     session.log("Installing test dependencies...")
     session.run("uv", "sync", "--locked", "--clean", "--groups", "dev", "test", external=True)
@@ -97,16 +94,16 @@ def test_python(session: Session) -> None:
     )
 
 
-@nox.session(venv=None)
-def test_rust(session: Session) -> None:
+@nox.session(python=None, name="tests-rust")
+def tests_rust(session: Session) -> None:
     """Test the project's rust crates."""
     crates: list[Path] = [cargo_toml.parent for cargo_toml in CRATES_FOLDER.glob("*/Cargo.toml")]
     crate_kwargs: list[str] = [f"-p {crate.name}" for crate in crates]
     session.run("cargo", "test", "--all-features", "--no-run", *crate_kwargs, external=True)
     session.run("cargo", "test", "--all-features", *crate_kwargs, external=True)
 
 
-@nox.session(python=DEFAULT_PYTHON_VERSION)
+@nox.session(python=DEFAULT_PYTHON_VERSION, name="docs-build")
 def docs_build(session: Session) -> None:
     """Build the project documentation (Sphinx)."""
     session.log("Installing documentation dependencies...")
@@ -157,7 +154,7 @@ def build_rust(session: Session) -> None:
 
 {% endif %}
 
-@nox.session(python=DEFAULT_PYTHON_VERSION)
+@nox.session(python=DEFAULT_PYTHON_VERSION, name="build-python")
 def build_python(session: Session) -> None:
     """Build sdist and wheel packages (uv build)."""
     session.log("Installing build dependencies...")
@@ -171,7 +168,7 @@ def build_python(session: Session) -> None:
     session.run("uv", "run", "ls", "-l", "dist/", external=True)
 
 
-@nox.session(python=DEFAULT_PYTHON_VERSION)
+@nox.session(python=DEFAULT_PYTHON_VERSION, name="build-container")
 def build_container(session: Session) -> None:
     """Build the Docker container image.
 
@@ -190,7 +187,6 @@ def build_container(session: Session) -> None:
         except nox.command.CommandFailed:
             session.log("Neither Docker nor Podman command found. Please install a container runtime.")
             session.skip("Container runtime not available.")
-            return
 
     current_dir = Path(".")
     session.log(f"Ensuring core dependencies are synced in {current_dir.resolve()} for build context...")
@@ -203,7 +199,7 @@ def build_container(session: Session) -> None:
     session.log(f"Container image {project_image_name}:latest built locally.")
 
 
-@nox.session(python=DEFAULT_PYTHON_VERSION)
+@nox.session(python=DEFAULT_PYTHON_VERSION, name="publish-python")
 def publish_python(session: Session) -> None:
     """Publish sdist and wheel packages to PyPI via uv publish.
 
@@ -217,7 +213,7 @@ def publish_python(session: Session) -> None:
     session.run("uv", "publish", "dist/*", external=True)
 
 
-@nox.session(python=None)
+@nox.session(python=None, name="publish-rust")
 def publish_rust(session: Session) -> None:
     """Publish built crates to crates.io."""
     session.log("Publishing crates to crates.io")
@@ -239,7 +235,6 @@ def release(session: Session) -> None:
     except nox.command.CommandFailed:
         session.log("Git command not found. Commitizen requires Git.")
         session.skip("Git not available.")
-        return
 
     session.log("Checking Commitizen availability via uvx.")
     session.run("uvx", "cz", "--version", success_codes=[0], external=True)
@@ -281,7 +276,6 @@ def tox(session: Session) -> None:
     if not tox_ini_path.exists():
         session.log("tox.ini file not found at %s. Tox requires this file.", str(tox_ini_path))
         session.skip("tox.ini not present.")
-        return
 
     session.log("Checking Tox availability via uvx.")
     session.run("uvx", "tox", "--version", success_codes=[0], external=True)
@@ -326,7 +320,7 @@ def check(session: Session) -> None:
     session.notify("security_deps")
 
 
-@nox.session(python=PYTHON_VERSIONS)
+@nox.session(python=PYTHON_VERSIONS, name="full-check")
 def full_check(session: Session) -> None:
    """Run all core quality checks and tests."""
    session.log(f"Queueing all check and test sessions for py{session.python} if applicable.")
@@ -359,7 +353,6 @@ def coverage(session: Session) -> None:
         else:
              session.error(f"Failed to combine coverage data: {e}")
         session.skip("Could not combine coverage data.")
-        return
 
     session.log("Generating HTML coverage report.")
     coverage_html_dir = Path("coverage-html")
@@ -369,4 +362,3 @@ def coverage(session: Session) -> None:
     session.run("uv", "run", "coverage", "report", external=True)
 
     session.log(f"Coverage reports generated in ./{str(coverage_html_dir)} and terminal.")
-