add justfile and python version file

Author: felixgwilliams

template/.python-version.jinja

@@ -0,0 +1 @@
+{{python_version}}

template/justfile

@@ -0,0 +1,27 @@
+default:
+  @just --list
+
+# setup for development
+setup: install git-setup
+
+# install the packages
+install:
+  {{if path_exists("uv.lock") != "true" {"uv sync --dev --all-extras --inexact"} else {"uv sync --dev --all-extras --locked --inexact"} }}
+
+# ensure code quality before git commit via pre-commit and nbwipers
+git-setup: install
+  uv run nbwipers install local
+  uv run pre-commit install --install-hooks
+
+# format and sort imports
+format:
+  uv run ruff check --fix --select=I001 .
+  uv run ruff format .
+
+# autofix with ruff
+autofix:
+  uv run ruff --fix --show-fixes .
+
+# lint with ruff
+lint:
+  uv run ruff check --output-format=full .

template/pyproject.toml.jinja

@@ -17,7 +17,7 @@ select = ["ALL"]
 ignore = ["COM", "ERA", "ISC001"]
 
 [tool.ruff.lint.per-file-ignores]
-"!{{module_name}}/**.py" = ["ANN", "D"]
+"!{{module_name}}/**.py" = ["ANN", "D", "S101", "PLR2004", "T20"]
 
 [tool.ruff.lint.isort]
 required-imports = ["from __future__ import annotations"]
@@ -33,5 +33,6 @@ dev-dependencies = [
     "nbwipers>=0.6.0",
     "ruff>=0.9.2",
     "pytest>=8",
-    "pytest-cov>=6.0.0"
+    "pytest-cov>=6.0.0",
+    "pre-commit>=4.1.0",
 ]

template/tests/__init__.py.jinja

@@ -1 +1 @@
-"""Tests for {{project_name}}"""
+"""Tests for {{project_name}}."""

template/{% if github_actions %}.github{% endif %}/workflows/ci.yml.jinja

@@ -25,7 +25,7 @@ jobs:
       - name: "Set up Python"
         uses: actions/setup-python@v5
         with:
-          python-version: "{{python_version}}"
+          python-version-file: ".python-version"
       - name: Install the project
         run: uv sync --all-extras --dev
       - name: check format
@@ -41,7 +41,7 @@ jobs:
       - name: "Set up Python"
         uses: actions/setup-python@v5
         with:
-          python-version: "{{python_version}}"
+          python-version-file: ".python-version"
       - name: Install the project
         run: uv sync --all-extras --dev
       - name: unit tests

template/{{module_name}}/__init__.py.jinja

@@ -1,3 +1,3 @@
-"""Module for {{project_name}}"""
+"""Module for {{project_name}}."""
 
 from __future__ import annotations