update template

Author: zigai

template/.editorconfig

@@ -6,6 +6,7 @@ indent_size = 4
 charset = utf-8
 trim_trailing_whitespace = true
 insert_final_newline = true
+end_of_line = lf
 
 [{*.yaml, *.yml}]
 indent_size = 2

template/.github/workflows/tests.yml.jinja

@@ -1,25 +1,32 @@
 name: Tests
 on: [push, pull_request]
+
 jobs:
   tests:
-    runs-on: ubuntu-latest
     strategy:
       fail-fast: false
       matrix:
+        os: [ubuntu-latest, macos-latest, windows-latest]
         python-version: [
         {%- for version in py_versions_range(python_min_version, python_max_version) %}
           "{{ version }}"{{ "," if not loop.last }}
         {%- endfor %}
         ]
+    runs-on: {% raw %}${{ matrix.os }}{% endraw %}
+
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
+
       - name: Install uv
-        uses: astral-sh/setup-uv@v3
+        uses: astral-sh/setup-uv@v7
+
       {% raw %}
       - name: Set up Python ${{ matrix.python-version }}
         run: uv python install ${{ matrix.python-version }}
+
       - name: Install dependencies
         run: uv sync --extra test --python ${{ matrix.python-version }}
+
       - name: Run pytest
         run: uv run --python ${{ matrix.python-version }} pytest -v
       {% endraw %}

template/.pre-commit-config.yaml

@@ -8,8 +8,8 @@ repos:
       - id: check-toml
 
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: v0.8.4
+    rev: v0.14.2
     hooks:
-      - id: ruff
-        args: [--fix, --exit-non-zero-on-fix]
+      - id: ruff-check
+        args: [--fix]
       - id: ruff-format

template/Justfile

@@ -1,41 +1,53 @@
 @_:
-   just --list
+  just --list
 
 _require-uv:
-   @uv --version > /dev/null || (echo "Please install uv: https://docs.astral.sh/uv/" && exit 1)
+  @uv --version > /dev/null || (echo "Please install uv: https://docs.astral.sh/uv/" && exit 1)
 
 _require-hatch:
   @hatch --version > /dev/null || (echo "Please install hatch: uv tool install hatch" && exit 1)
 
 # check code style and potential issues
 lint:
-   ruff check
-
-# fix automatically fixable linting issues
-fix:
-   ruff check --fix
+  ruff check
 
 # format code
 format:
-   ruff format
+  ruff format
+
+# fix automatically fixable linting issues
+fix:
+  ruff check --fix
 
 # run tests across all supported Python versions
 test: _require-hatch
-   hatch run test:test
+  hatch run -m test:test
 
 # run all quality checks
 check: format lint test
 
 # build the package
 build: _require-uv
-   uv build
+  uv build
 
-# setup development environment
+# setup or update local dev environment, keeps previously installed extras
 dev: _require-uv
-   uv sync --extra dev
-   uv run pre-commit install
+  uv sync --inexact --extra dev
+  uv run pre-commit install
+
+# run tests with coverage and show a coverage report
+coverage:
+  coverage run -m pytest
+  coverage report
 
 # clean build artifacts and caches
 clean:
-   rm -rf .venv .pytest_cache .mypy_cache .ruff_cache
-   find . -type d -name "__pycache__" -exec rm -r {} +
+  rm -rf .venv .pytest_cache .mypy_cache .ruff_cache
+  find . -type d -name "__pycache__" -exec rm -r {} +
+
+# list available recipes
+help:
+    just --list
+
+alias fmt := format
+alias cov := coverage

template/pyproject.toml.jinja

@@ -60,10 +60,9 @@ keywords = [
     "{{ package_name }}"
 ]
 
-
 [project.optional-dependencies]
 test = ["pytest"]
-dev = ["pytest", "black", "ruff", "pre-commit"]
+dev = ["pytest", "ruff", "pre-commit", "coverage"]
 
 [project.urls]
 Repository = "{{ repository_url }}"
@@ -74,17 +73,25 @@ Homepage = "{{ repository_url }}"
 requires = ["hatchling"]
 build-backend = "hatchling.build"
 
-[tool.hatch.build.targets.wheel]
-packages = ["{{ package_name }}"]
+[tool.hatch.envs.test]
+features = ["test"]
+installer = "uv"
 
-[tool.black]
-line-length = 100
-target-version = [
-{%- for target in black_target_versions(python_min_version, python_max_version) %}
-    '{{ target }}',
+[[tool.hatch.envs.test.matrix]]
+python = [
+{%- for version in py_versions_range(python_min_version, python_max_version) %}
+    "{{ version }}",
 {%- endfor %}
 ]
 
+[tool.hatch.envs.test.scripts]
+test = "pytest {args}"
+coverage = "coverage run -m pytest {args}"
+
+
+[tool.hatch.build.targets.wheel]
+packages = ["{{ package_name }}"]
+
 [tool.ruff]
 line-length = 100
 
@@ -158,32 +165,9 @@ ignore = [
     "UP007",
     "UP038",
 ]
-isort = { known-first-party = ["{{ package_name }}", 'tests'] }
-pydocstyle = { convention = 'google' }
-
 exclude = [
-    ".bzr",
-    ".direnv",
-    ".eggs",
-    ".git",
-    ".hg",
-    ".mypy_cache",
-    ".nox",
-    ".pants.d",
-    ".pytype",
-    ".ruff_cache",
-    ".svn",
-    ".tox",
-    ".venv",
-    "__pypackages__",
-    "_build",
-    "buck-out",
     "build",
-    "dist",
-    "node_modules",
-    "venv",
-    "tests/*",
-    "tests/**/*",
+    "tests/**",
 ]
 
 [tool.ruff.lint.per-file-ignores]
@@ -196,18 +180,20 @@ exclude = [
 quote-style = "double"
 indent-style = "space"
 skip-magic-trailing-comma = false
-line-ending = "auto"
+line-ending = "lf"
 
-[tool.hatch.envs.test]
-features = ["test"]
-installer = "uv"
+[tool.ruff.lint.isort]
+known-first-party = ["{{ package_name }}", "tests"]
 
-[[tool.hatch.envs.test.matrix]]
-python = [
-{%- for version in py_versions_range(python_min_version, python_max_version) %}
-    "{{ version }}",
-{%- endfor %}
-]
+[tool.ruff.lint.pydocstyle]
+convention = "google"
 
-[tool.hatch.envs.test.scripts]
-test = "pytest -v"
+[tool.coverage.run]
+source = ["{{ package_name }}"]
+branch = true
+
+[tool.coverage.report]
+omit = [
+    "tests/*",
+    "tests/**",
+]