From de2cfc1c210ce33f02c9aa917826a425f1d73b83 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?St=C3=A9phane=20Wirtel?= Date: Fri, 25 Sep 2026 08:25:29 +0200 Subject: [PATCH 1/9] chore(dev): add prek git hooks for Python, ruff, uv and Django Add prek (Rust reimplementation of pre-commit) to the dev dependency group and a .pre-commit-config.yaml with: - pre-commit-hooks: whitespace, EOF, line endings, YAML/TOML/JSON syntax, merge conflicts, large files, debug statements, private keys - uv-lock to keep uv.lock in sync with pyproject.toml - django-upgrade targeting Django 6.0 - local hooks running ruff check/format, `manage.py check` and a missing migrations check through `uv run`, so the versions come from uv.lock Vendored static assets (Bootstrap, Font Awesome, SmartMenus) are excluded. Co-Authored-By: Claude Opus 5.5 --- .pre-commit-config.yaml | 79 +++++++++++++++++++++++++++++++++++++++++ pyproject.toml | 1 + uv.lock | 18 ++++++++++ 3 files changed, 98 insertions(+) create mode 100644 .pre-commit-config.yaml diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml new file mode 100644 index 0000000..8e97b6d --- /dev/null +++ b/.pre-commit-config.yaml @@ -0,0 +1,79 @@ +# Git hooks, run with prek (https://github.com/j178/prek), a drop-in +# replacement for pre-commit that reads this same file. +# +# uv sync --all-groups # prek is part of the dev dependency group +# uv run prek install # install the git hook for this clone +# uv run prek run --all-files # run every hook on the whole repository +# +# Revisions are pinned to tags and kept up to date by Renovate. + +# Vendored third-party assets (Bootstrap, Font Awesome, SmartMenus) are kept +# byte-for-byte identical to upstream. +exclude: | + (?x)^( + pythonie/core/static/(css|fonts|js)/.* + )$ + +repos: + - repo: https://github.com/pre-commit/pre-commit-hooks + rev: v6.0.0 + hooks: + - id: trailing-whitespace + args: [--markdown-linebreak-ext=md] + - id: end-of-file-fixer + - id: mixed-line-ending + args: [--fix=lf] + - id: check-yaml + - id: check-toml + - id: check-json + - id: check-merge-conflict + - id: check-case-conflict + - id: check-added-large-files + args: [--maxkb=500] + - id: debug-statements + - id: detect-private-key + + # Keeps uv.lock in sync with pyproject.toml. The rev tracks the uv version + # pinned in mise.toml and the dev dependency group (Renovate "uv" group). + - repo: https://github.com/astral-sh/uv-pre-commit + rev: 0.12.19 + hooks: + - id: uv-lock + + - repo: https://github.com/adamchainz/django-upgrade + rev: 1.32.0 + hooks: + - id: django-upgrade + args: [--target-version, "6.0"] + + # Ruff and Django checks run through `uv run` so they use the exact versions + # locked in uv.lock (the same ones CI uses): there is no second ruff version + # to keep in sync with pyproject.toml. + # The Django hooks unset DATABASE_URL so they always run against the local + # SQLite database, never against a remote one exported in the shell. + - repo: local + hooks: + - id: ruff-check + name: ruff check + entry: uv run --frozen ruff check --fix --force-exclude + language: system + types_or: [python, pyi] + require_serial: true + - id: ruff-format + name: ruff format + entry: uv run --frozen ruff format --force-exclude + language: system + types_or: [python, pyi] + require_serial: true + - id: django-check + name: django system checks + entry: env -u DATABASE_URL uv run --frozen python pythonie/manage.py check --settings=pythonie.settings.tests + language: system + files: ^pythonie/.*\.py$ + pass_filenames: false + - id: django-missing-migrations + name: django missing migrations + entry: env -u DATABASE_URL uv run --frozen python pythonie/manage.py makemigrations --check --dry-run --settings=pythonie.settings.tests + language: system + files: ^pythonie/.*\.py$ + pass_filenames: false diff --git a/pyproject.toml b/pyproject.toml index bd82add..412c3b2 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -39,6 +39,7 @@ dev = [ "model_mommy>=2.0.0", "pip-audit>=2.10.1", "pipdeptree>=4.2.5", + "prek>=0.5.3", "ruff==0.16.9", # pinned: ruff minor releases change the default lint rule set "uv>=0.12.19", "wagtail-factories>=4.5.0", diff --git a/uv.lock b/uv.lock index 8021321..4795151 100644 --- a/uv.lock +++ b/uv.lock @@ -1013,6 +1013,22 @@ wheels = [ { url = "https://files.pythonhosted.org/packages/ec/2b/69de6317fbf48865bb12aa56c9cfcfff46b3add0cd45250725d96146dce0/platformdirs-4.11.12-py3-none-any.whl", hash = "sha256:b1ba966ac76153d9985a0787ffab951e7c18416189873d4e4ddb2c8a04a0a254", size = 24976, upload-time = "2026-09-22T01:02:35.742Z" }, ] +[[package]] +name = "prek" +version = "0.5.3" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/54/93/d1e5afc996b9fde04d71c37fd28bdd404e54daf1da6c76b883c5cdbdb411/prek-0.5.3.tar.gz", hash = "sha256:06d88bed9a5b2886cd3796957e4cecf05fa9b06724b625df31dbf0a48ff2330c", size = 551929, upload-time = "2026-09-13T08:38:37.823Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/db/5d/8731dc49cb5424d37424db3ea2f3ff6a0b20caa971db72796e822ce48b24/prek-0.5.3-py3-none-macosx_10_12_x86_64.whl", hash = "sha256:2d7240c5e6a996ef5bebe5d57d43049803e41c225b343681c020bf0c87dab2b2", size = 6003518, upload-time = "2026-09-13T08:38:20.584Z" }, + { url = "https://files.pythonhosted.org/packages/51/45/ca413aefb3ea2411bbf0adb6eebfac1e9bfc5ac7679dbe26336fc651c347/prek-0.5.3-py3-none-macosx_11_0_arm64.whl", hash = "sha256:1dd6df8235ca361dbbeec89c305ccb41a138088a2fc548484b4cb89f66a80d20", size = 5538754, upload-time = "2026-09-13T08:38:23.004Z" }, + { url = "https://files.pythonhosted.org/packages/dc/92/874d58ba40d2fe7cfec2789ae8bf415f3751666ad5c59928821fe53c3c01/prek-0.5.3-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.musllinux_1_1_aarch64.whl", hash = "sha256:61ff791bb850ba52cc0d86576498df7e1bd1e9ed20df63dae113a4a6aa495e19", size = 5841568, upload-time = "2026-09-13T08:38:25.008Z" }, + { url = "https://files.pythonhosted.org/packages/8f/40/167037b8eef75f6f036c60ff7e93f42defebb7c3733677e2f30e5a479257/prek-0.5.3-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:a863379a2668c4ef079d820ffd5b14073145380dfbe0e70fef498dc73c568f86", size = 6226960, upload-time = "2026-09-13T08:38:26.788Z" }, + { url = "https://files.pythonhosted.org/packages/42/9a/bfcd3c1fe1fdefee8dc144a92c4b0b93b59f31c7df60ee1720c49223a90a/prek-0.5.3-py3-none-manylinux_2_28_aarch64.whl", hash = "sha256:086d1b77557f0a089568dc5b93c22ccd793351524f3eeb29d36781421a350e72", size = 5854832, upload-time = "2026-09-13T08:38:28.954Z" }, + { url = "https://files.pythonhosted.org/packages/15/41/1450b995b18bbf0d8ab65016860198052baad5c79c231151fa1dcca4a2de/prek-0.5.3-py3-none-musllinux_1_1_x86_64.whl", hash = "sha256:4f09b947255124e9591a7f7ef16eb5340a36ba94a275d788d7ea804fab35f0e2", size = 6343055, upload-time = "2026-09-13T08:38:30.96Z" }, + { url = "https://files.pythonhosted.org/packages/9c/e8/8f45950b8a8ddcf22efc7183e9d6b1d7e30373229ff7d9e56f918a55922c/prek-0.5.3-py3-none-win_amd64.whl", hash = "sha256:5b74a9742c3e8f8688d5dad1439688f112e2e1746fcb91016015dae38df3eb42", size = 5744293, upload-time = "2026-09-13T08:38:33.104Z" }, + { url = "https://files.pythonhosted.org/packages/24/cd/ce637f4b6cc6c583516dc16b539408dab593672f7c6fe7723a37caf378ff/prek-0.5.3-py3-none-win_arm64.whl", hash = "sha256:20d92aef53a5e237f4659ecc6669c0fbc98a1b83f0e2476530400a72d42ca390", size = 5512958, upload-time = "2026-09-13T08:38:36.123Z" }, +] + [[package]] name = "psycopg" version = "3.3.6" @@ -1180,6 +1196,7 @@ dev = [ { name = "model-mommy" }, { name = "pip-audit" }, { name = "pipdeptree" }, + { name = "prek" }, { name = "ruff" }, { name = "uv" }, { name = "wagtail-factories" }, @@ -1222,6 +1239,7 @@ dev = [ { name = "model-mommy", specifier = ">=2.0.0" }, { name = "pip-audit", specifier = ">=2.10.1" }, { name = "pipdeptree", specifier = ">=4.2.5" }, + { name = "prek", specifier = ">=0.5.3" }, { name = "ruff", specifier = "==0.16.9" }, { name = "uv", specifier = ">=0.12.19" }, { name = "wagtail-factories", specifier = ">=4.5.0" }, From bfc05073c87c03822583a0c7c7d872ffc2c2a7df Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?St=C3=A9phane=20Wirtel?= Date: Fri, 25 Sep 2026 08:25:35 +0200 Subject: [PATCH 2/9] style: fix trailing whitespace and end of file newlines Mass fixes from the trailing-whitespace and end-of-file-fixer hooks on the first `prek run --all-files`. Whitespace only, no behavior change. Co-Authored-By: Claude Opus 5.5 --- .coveragerc | 1 - CLAUDE.md | 2 +- development.env | 1 - pythonie/core/templates/base.html | 4 ++-- pythonie/core/templates/core/meetup.html | 2 +- pythonie/core/templates/core/segment.html | 2 +- pythonie/core/templates/navbar_tree.html | 8 +++----- 7 files changed, 8 insertions(+), 12 deletions(-) diff --git a/.coveragerc b/.coveragerc index 86a32ae..e914860 100644 --- a/.coveragerc +++ b/.coveragerc @@ -1,4 +1,3 @@ [run] branch = True source = pythonie - diff --git a/CLAUDE.md b/CLAUDE.md index fc0b6b3..4ff5c34 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -270,4 +270,4 @@ All documentation and code comments must be written in English to ensure all con ### Git Commits -When creating git commits, do not include any mention of Claude, Claude Code, or AI assistance in commit messages. Commit messages should focus solely on describing the changes made, without attribution to the tool used to make them. \ No newline at end of file +When creating git commits, do not include any mention of Claude, Claude Code, or AI assistance in commit messages. Commit messages should focus solely on describing the changes made, without attribution to the tool used to make them. diff --git a/development.env b/development.env index 94ad002..f0c13cb 100644 --- a/development.env +++ b/development.env @@ -4,4 +4,3 @@ PGUSER=postgres PGPASSWORD=pythonie PGHOST=postgres REDISCLOUD_URL=redis://redis:6379 - diff --git a/pythonie/core/templates/base.html b/pythonie/core/templates/base.html index dbc01c2..073a166 100644 --- a/pythonie/core/templates/base.html +++ b/pythonie/core/templates/base.html @@ -46,10 +46,10 @@ {% compress css %} - + - + diff --git a/pythonie/core/templates/core/meetup.html b/pythonie/core/templates/core/meetup.html index 7366501..e157bbf 100644 --- a/pythonie/core/templates/core/meetup.html +++ b/pythonie/core/templates/core/meetup.html @@ -17,7 +17,7 @@
Sponsors:
diff --git a/pythonie/core/templates/navbar_tree.html b/pythonie/core/templates/navbar_tree.html index 9b1f0fc..1a4cb29 100644 --- a/pythonie/core/templates/navbar_tree.html +++ b/pythonie/core/templates/navbar_tree.html @@ -10,9 +10,9 @@
    • @@ -27,5 +27,3 @@ {% else %}
    • {{ page }}
      • {% endif %} - - From 15ba9c486884e210795eaf5317b642e212f58af9 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?St=C3=A9phane=20Wirtel?= Date: Fri, 25 Sep 2026 08:25:35 +0200 Subject: [PATCH 3/9] refactor: apply django-upgrade fixes for Django 6.0 Mass fixes from the django-upgrade hook (--target-version 6.0), followed by ruff merging the resulting imports: - drop USE_L10N, removed in Django 5.0 (localization is always on) - import include from django.urls instead of django.conf.urls - use path() instead of re_path() for the plain admin/ and documents/ prefixes - register sponsors admin classes with the @admin.register decorator No behavior change. Co-Authored-By: Claude Opus 5.5 --- pythonie/pythonie/settings/base.py | 1 - pythonie/pythonie/urls.py | 7 +++---- pythonie/sponsors/admin.py | 8 ++------ 3 files changed, 5 insertions(+), 11 deletions(-) diff --git a/pythonie/pythonie/settings/base.py b/pythonie/pythonie/settings/base.py index 4f19bed..cb4766e 100644 --- a/pythonie/pythonie/settings/base.py +++ b/pythonie/pythonie/settings/base.py @@ -151,7 +151,6 @@ LANGUAGE_CODE = "en-gb" TIME_ZONE = "UTC" USE_I18N = True -USE_L10N = True USE_TZ = True # Static files (CSS, JavaScript, Images) diff --git a/pythonie/pythonie/urls.py b/pythonie/pythonie/urls.py index a78678f..fe0be1e 100644 --- a/pythonie/pythonie/urls.py +++ b/pythonie/pythonie/urls.py @@ -1,10 +1,9 @@ import os from django.conf import settings -from django.conf.urls import include from django.conf.urls.static import static from django.contrib import admin -from django.urls import path, re_path +from django.urls import include, path, re_path from wagtail import urls as wagtail_urls from wagtail.admin import urls as wagtailadmin_urls @@ -13,9 +12,9 @@ urlpatterns = [ re_path(r"^django-admin/", admin.site.urls), - re_path(r"^admin/", include(wagtailadmin_urls)), + path("admin/", include(wagtailadmin_urls)), # url(r'^search/', include(wagtailsearch_urls)), - re_path(r"^documents/", include(wagtaildocs_urls)), + path("documents/", include(wagtaildocs_urls)), path(r"", include(wagtail_urls)), ] diff --git a/pythonie/sponsors/admin.py b/pythonie/sponsors/admin.py index 2e45524..720dbf0 100644 --- a/pythonie/sponsors/admin.py +++ b/pythonie/sponsors/admin.py @@ -3,6 +3,7 @@ from sponsors.models import Sponsor, SponsorshipLevel +@admin.register(SponsorshipLevel) class SponsorshipLevelAdmin(admin.ModelAdmin): list_display = ( "name", @@ -10,14 +11,9 @@ class SponsorshipLevelAdmin(admin.ModelAdmin): ) -admin.site.register(SponsorshipLevel, SponsorshipLevelAdmin) - - +@admin.register(Sponsor) class SponsorAdmin(admin.ModelAdmin): list_display = ( "name", "logo", ) - - -admin.site.register(Sponsor, SponsorAdmin) From 6c7249d7af73c4b2e3071fbbf5249484de126e8a Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?St=C3=A9phane=20Wirtel?= Date: Fri, 25 Sep 2026 08:26:08 +0200 Subject: [PATCH 4/9] ci: run prek hooks on all files Add a dedicated prek job, in parallel with the test job, running every hook with the versions locked in uv.lock. Hook environments are cached per .pre-commit-config.yaml hash. The existing ruff, pip-audit and test steps are kept unchanged. Co-Authored-By: Claude Opus 5.5 --- .github/workflows/test.yml | 28 ++++++++++++++++++++++++++++ 1 file changed, 28 insertions(+) diff --git a/.github/workflows/test.yml b/.github/workflows/test.yml index c8a348d..45f4ad1 100644 --- a/.github/workflows/test.yml +++ b/.github/workflows/test.yml @@ -2,6 +2,34 @@ name: Test packages on: [push, pull_request, workflow_dispatch] jobs: + prek: + name: Run prek hooks + runs-on: ubuntu-latest + + steps: + - uses: actions/checkout@v7.0.1 + + - name: Install uv + uses: astral-sh/setup-uv@v10.2.0 + with: + python-version: "3.13" + enable-cache: true + cache-dependency-glob: "uv.lock" + + # prek, ruff and Django come from the dev group: the hooks run with the + # versions locked in uv.lock, exactly as on a developer machine. + - name: Install dependencies + run: uv sync --all-groups + + - name: Cache prek hook environments + uses: actions/cache@v6.1.0 + with: + path: ~/.cache/prek + key: prek-${{ runner.os }}-${{ hashFiles('.pre-commit-config.yaml') }} + + - name: Run prek on all files + run: uv run prek run --all-files --show-diff-on-failure + test: name: Run code quality checks and tests runs-on: ubuntu-latest From 3d58b12d5d66ccb4d78e3aede3c6657e3e805b78 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?St=C3=A9phane=20Wirtel?= Date: Fri, 25 Sep 2026 08:26:09 +0200 Subject: [PATCH 5/9] chore(renovate): update .pre-commit-config.yaml revisions Enable the pre-commit manager (disabled by default in Renovate), group hook revision bumps in a weekly PR and keep the uv-lock hook in the uv group so it moves together with the uv dev dependency, Dockerfile and mise.toml. Co-Authored-By: Claude Opus 5.5 --- renovate.json | 14 ++++++++++++-- 1 file changed, 12 insertions(+), 2 deletions(-) diff --git a/renovate.json b/renovate.json index 574080e..b602e42 100644 --- a/renovate.json +++ b/renovate.json @@ -2,6 +2,9 @@ "$schema": "https://docs.renovatebot.com/renovate-schema.json", "extends": ["config:recommended"], "description": "Renovate configuration for Python Ireland website - pyproject.toml + uv.lock (pep621 manager) with Heroku deployment", + "pre-commit": { + "enabled": true + }, "constraints": { "python": "3.13" }, @@ -42,9 +45,16 @@ "automergeType": "pr" }, { - "description": "Keep uv in sync: one PR for the dev dependency (pep621), the Docker image (Dockerfile) and the mise tool", + "description": "Keep uv in sync: one PR for the dev dependency (pep621), the Docker image (Dockerfile), the mise tool and the uv-lock hook (pre-commit)", "groupName": "uv", - "matchPackageNames": ["uv", "ghcr.io/astral-sh/uv", "astral-sh/uv"] + "matchPackageNames": ["uv", "ghcr.io/astral-sh/uv", "astral-sh/uv", "astral-sh/uv-pre-commit"] + }, + { + "description": "Group prek hook revisions (.pre-commit-config.yaml) together", + "groupName": "pre-commit hooks", + "matchManagers": ["pre-commit"], + "matchPackageNames": ["!astral-sh/uv-pre-commit"], + "schedule": ["before 9am on monday"] }, { "description": "Python is pinned to 3.13.x: only allow 3.13 for the Docker base image, mise and .python-version", From 3e5e19b29ce8ffabd1d2a3f10fd5d7d30f917873 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?St=C3=A9phane=20Wirtel?= Date: Fri, 25 Sep 2026 08:26:38 +0200 Subject: [PATCH 6/9] docs: document prek git hooks installation and usage Co-Authored-By: Claude Opus 5.5 --- CLAUDE.md | 18 +++++++++++++++++ CONTRIBUTING.md | 52 ++++++++++++++++++++++++++++++++++++++++++++++++- DEVELOPMENT.md | 9 +++++++++ 3 files changed, 78 insertions(+), 1 deletion(-) diff --git a/CLAUDE.md b/CLAUDE.md index 4ff5c34..f5047d7 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -123,6 +123,24 @@ task code:check # or: toast code:check ``` +### Git Hooks (prek) + +[prek](https://github.com/j178/prek) (a Rust drop-in replacement for pre-commit) runs the hooks defined in `.pre-commit-config.yaml`. It is part of the `dev` dependency group, so its version comes from `uv.lock`. + +```bash +# Install the git hook (once per clone) +uv run prek install + +# Run every hook on the whole repository (also run by the CI prek job) +uv run prek run --all-files + +# Emergency bypass: skip one hook, or all of them +SKIP=django-missing-migrations git commit -m "..." +git commit --no-verify -m "..." +``` + +Hooks: pre-commit-hooks (whitespace, EOF, YAML/TOML/JSON, merge conflicts, large files, debug statements, private keys), uv-lock, django-upgrade (`--target-version 6.0`), and local hooks for ruff check/format, `manage.py check` and missing migrations. The ruff and Django hooks are `local` hooks running `uv run --frozen`, so ruff is pinned in one place only (`pyproject.toml`); there is no `ruff-pre-commit` rev to keep aligned. The Django hooks unset `DATABASE_URL` so they never reach a remote database. Vendored assets under `pythonie/core/static/{css,fonts,js}` are excluded. Renovate updates the hook revisions (`pre-commit` manager, enabled in `renovate.json`). + ### Dependency Management Uses `uv` for fast Python package management. Dependencies are declared in `pyproject.toml` (`[project.dependencies]` + `[dependency-groups]`) and locked in `uv.lock` (committed). Heroku's Python buildpack detects `uv.lock` and installs natively via `uv sync` against the slug's system Python — **never add a `requirements.txt` at the repo root**, the buildpack aborts the build if it finds more than one package-manager file (`requirements.txt`, `poetry.lock`, `uv.lock`) at once. `.python-version` (not `runtime.txt`, which is deprecated) pins the Python version for the buildpack. diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 1bd5f33..001614d 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -83,6 +83,9 @@ python3 --version # Should show 3.13.x # Install dependencies (creates and populates a .venv automatically) uv sync --all-groups +# Install the git hooks (see "Git Hooks (prek)" below) +uv run prek install + # Run migrations uv run python pythonie/manage.py migrate --settings=pythonie.settings.dev @@ -137,7 +140,8 @@ refactor/simplify-sponsor-model # or: python -m ruff format pythonie ``` -5. **Commit your changes** with clear messages: +5. **Commit your changes** with clear messages (the prek git hooks run + automatically on the staged files, see [Git Hooks (prek)](#git-hooks-prek)): ```bash git add . git commit -m "Add dark mode toggle feature" @@ -174,6 +178,52 @@ task code:lint task code:check ``` +### Git Hooks (prek) + +The repository uses [prek](https://github.com/j178/prek), a fast drop-in +replacement for [pre-commit](https://pre-commit.com/) that reads the same +`.pre-commit-config.yaml`. prek is part of the `dev` dependency group, so +`uv sync --all-groups` installs it in the project `.venv` at the version locked +in `uv.lock`. + +```bash +# Install the git hook once per clone +uv run prek install + +# Run every hook on the whole repository +uv run prek run --all-files + +# Run a single hook +uv run prek run ruff-check --all-files +``` + +The hooks run on every `git commit`, on the staged files only: + +- **Generic checks** (pre-commit-hooks): trailing whitespace, end of file + newline, line endings, YAML/TOML/JSON syntax, merge conflict markers, large + files, leftover debugger imports, private keys +- **uv-lock**: keeps `uv.lock` in sync with `pyproject.toml` +- **django-upgrade**: rewrites deprecated Django idioms (target: Django 6.0) +- **ruff check / ruff format**: run through `uv run`, with the same ruff version + as CI +- **Django system checks and missing migrations**: `manage.py check` and + `manage.py makemigrations --check --dry-run`, always against the local SQLite + database (`DATABASE_URL` is ignored) + +When a hook fixes files, the commit is aborted: review the changes, `git add` +them and commit again. CI runs `prek run --all-files` on every push and pull +request. + +To bypass the hooks in an emergency (CI will still run them): + +```bash +# Skip one or more hooks by id +SKIP=django-missing-migrations git commit -m "..." + +# Skip all hooks +git commit --no-verify -m "..." +``` + ### Django/Wagtail Conventions 1. **Models**: Place in `models.py`, use explicit `Meta` classes diff --git a/DEVELOPMENT.md b/DEVELOPMENT.md index 73007fd..408e35a 100644 --- a/DEVELOPMENT.md +++ b/DEVELOPMENT.md @@ -137,6 +137,9 @@ task run # 1. Install dependencies (ensure Python 3.13; creates and populates a .venv automatically) uv sync --all-groups +# Install the prek git hooks (ruff, django-upgrade, missing migrations, ...) +uv run prek install + # 2. Migrate database uv run python pythonie/manage.py migrate --settings=pythonie.settings.dev @@ -1004,8 +1007,14 @@ task code:format # Format code with ruff task code:lint # Lint code and fix issues task code:check # Check without changes task dependencies:security # Check for security vulnerabilities +uv run prek run --all-files # Run every git hook (same as the CI prek job) ``` +The prek git hooks (`uv run prek install`, see CONTRIBUTING.md) run ruff, +django-upgrade, the Django system checks and the missing migrations check on +every commit. Use `SKIP= git commit` or `git commit --no-verify` only +in an emergency: CI runs the same hooks. + ### 4. Create Atomic Migrations ```bash From 101a0f2667a2a62433676136255590969c197cf3 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?St=C3=A9phane=20Wirtel?= Date: Fri, 25 Sep 2026 08:32:33 +0200 Subject: [PATCH 7/9] chore(dev): use a preinstalled prek instead of a dev dependency prek is a developer tool installed once per machine (mise, Homebrew or uv tool), not a project dependency: drop it from the dev group and uv.lock. CI installs it with j178/prek-action, which also caches the hook environments. Docs now use `prek` directly instead of `uv run prek`. Co-Authored-By: Claude Opus 5.5 --- .github/workflows/test.yml | 12 ++++-------- .pre-commit-config.yaml | 9 ++++++--- CLAUDE.md | 6 +++--- CONTRIBUTING.md | 24 ++++++++++++++++-------- DEVELOPMENT.md | 7 ++++--- pyproject.toml | 1 - uv.lock | 18 ------------------ 7 files changed, 33 insertions(+), 44 deletions(-) diff --git a/.github/workflows/test.yml b/.github/workflows/test.yml index 45f4ad1..cbb7ce5 100644 --- a/.github/workflows/test.yml +++ b/.github/workflows/test.yml @@ -16,19 +16,15 @@ jobs: enable-cache: true cache-dependency-glob: "uv.lock" - # prek, ruff and Django come from the dev group: the hooks run with the + # The local hooks (ruff, Django checks) run through `uv run`, with the # versions locked in uv.lock, exactly as on a developer machine. - name: Install dependencies run: uv sync --all-groups - - name: Cache prek hook environments - uses: actions/cache@v6.1.0 - with: - path: ~/.cache/prek - key: prek-${{ runner.os }}-${{ hashFiles('.pre-commit-config.yaml') }} - + # Installs prek, caches the hook environments and runs + # `prek run --show-diff-on-failure --all-files`. - name: Run prek on all files - run: uv run prek run --all-files --show-diff-on-failure + uses: j178/prek-action@v3.0.0 test: name: Run code quality checks and tests diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml index 8e97b6d..e72fc86 100644 --- a/.pre-commit-config.yaml +++ b/.pre-commit-config.yaml @@ -1,9 +1,12 @@ # Git hooks, run with prek (https://github.com/j178/prek), a drop-in # replacement for pre-commit that reads this same file. # -# uv sync --all-groups # prek is part of the dev dependency group -# uv run prek install # install the git hook for this clone -# uv run prek run --all-files # run every hook on the whole repository +# prek must be installed on the machine (e.g. `mise use -g prek`, +# `brew install prek` or `uv tool install prek`); the local hooks also need +# the project environment (`uv sync --all-groups`). +# +# prek install # install the git hook for this clone +# prek run --all-files # run every hook on the whole repository # # Revisions are pinned to tags and kept up to date by Renovate. diff --git a/CLAUDE.md b/CLAUDE.md index f5047d7..14f5ab6 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -125,14 +125,14 @@ task code:check ### Git Hooks (prek) -[prek](https://github.com/j178/prek) (a Rust drop-in replacement for pre-commit) runs the hooks defined in `.pre-commit-config.yaml`. It is part of the `dev` dependency group, so its version comes from `uv.lock`. +[prek](https://github.com/j178/prek) (a Rust drop-in replacement for pre-commit) runs the hooks defined in `.pre-commit-config.yaml`. It is **not** a project dependency: it must already be installed on the machine (`mise use -g prek`, `brew install prek` or `uv tool install prek`). CI installs it with `j178/prek-action`. ```bash # Install the git hook (once per clone) -uv run prek install +prek install # Run every hook on the whole repository (also run by the CI prek job) -uv run prek run --all-files +prek run --all-files # Emergency bypass: skip one hook, or all of them SKIP=django-missing-migrations git commit -m "..." diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 001614d..e0d1442 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -83,8 +83,8 @@ python3 --version # Should show 3.13.x # Install dependencies (creates and populates a .venv automatically) uv sync --all-groups -# Install the git hooks (see "Git Hooks (prek)" below) -uv run prek install +# Install the git hooks (requires prek, see "Git Hooks (prek)" below) +prek install # Run migrations uv run python pythonie/manage.py migrate --settings=pythonie.settings.dev @@ -182,19 +182,27 @@ task code:check The repository uses [prek](https://github.com/j178/prek), a fast drop-in replacement for [pre-commit](https://pre-commit.com/) that reads the same -`.pre-commit-config.yaml`. prek is part of the `dev` dependency group, so -`uv sync --all-groups` installs it in the project `.venv` at the version locked -in `uv.lock`. +`.pre-commit-config.yaml`. prek is not a project dependency: install it once +on your machine, with one of: + +```bash +mise use -g prek # mise +brew install prek # Homebrew +uv tool install prek # uv +``` + +The ruff and Django hooks run through `uv run`, so they also need the project +environment (`uv sync --all-groups`). ```bash # Install the git hook once per clone -uv run prek install +prek install # Run every hook on the whole repository -uv run prek run --all-files +prek run --all-files # Run a single hook -uv run prek run ruff-check --all-files +prek run ruff-check --all-files ``` The hooks run on every `git commit`, on the staged files only: diff --git a/DEVELOPMENT.md b/DEVELOPMENT.md index 408e35a..b67af9a 100644 --- a/DEVELOPMENT.md +++ b/DEVELOPMENT.md @@ -138,7 +138,8 @@ task run uv sync --all-groups # Install the prek git hooks (ruff, django-upgrade, missing migrations, ...) -uv run prek install +# prek must be installed on the machine, see CONTRIBUTING.md +prek install # 2. Migrate database uv run python pythonie/manage.py migrate --settings=pythonie.settings.dev @@ -1007,10 +1008,10 @@ task code:format # Format code with ruff task code:lint # Lint code and fix issues task code:check # Check without changes task dependencies:security # Check for security vulnerabilities -uv run prek run --all-files # Run every git hook (same as the CI prek job) +prek run --all-files # Run every git hook (same as the CI prek job) ``` -The prek git hooks (`uv run prek install`, see CONTRIBUTING.md) run ruff, +The prek git hooks (`prek install`, see CONTRIBUTING.md) run ruff, django-upgrade, the Django system checks and the missing migrations check on every commit. Use `SKIP= git commit` or `git commit --no-verify` only in an emergency: CI runs the same hooks. diff --git a/pyproject.toml b/pyproject.toml index 412c3b2..bd82add 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -39,7 +39,6 @@ dev = [ "model_mommy>=2.0.0", "pip-audit>=2.10.1", "pipdeptree>=4.2.5", - "prek>=0.5.3", "ruff==0.16.9", # pinned: ruff minor releases change the default lint rule set "uv>=0.12.19", "wagtail-factories>=4.5.0", diff --git a/uv.lock b/uv.lock index 4795151..8021321 100644 --- a/uv.lock +++ b/uv.lock @@ -1013,22 +1013,6 @@ wheels = [ { url = "https://files.pythonhosted.org/packages/ec/2b/69de6317fbf48865bb12aa56c9cfcfff46b3add0cd45250725d96146dce0/platformdirs-4.11.12-py3-none-any.whl", hash = "sha256:b1ba966ac76153d9985a0787ffab951e7c18416189873d4e4ddb2c8a04a0a254", size = 24976, upload-time = "2026-09-22T01:02:35.742Z" }, ] -[[package]] -name = "prek" -version = "0.5.3" -source = { registry = "https://pypi.org/simple" } -sdist = { url = "https://files.pythonhosted.org/packages/54/93/d1e5afc996b9fde04d71c37fd28bdd404e54daf1da6c76b883c5cdbdb411/prek-0.5.3.tar.gz", hash = "sha256:06d88bed9a5b2886cd3796957e4cecf05fa9b06724b625df31dbf0a48ff2330c", size = 551929, upload-time = "2026-09-13T08:38:37.823Z" } -wheels = [ - { url = "https://files.pythonhosted.org/packages/db/5d/8731dc49cb5424d37424db3ea2f3ff6a0b20caa971db72796e822ce48b24/prek-0.5.3-py3-none-macosx_10_12_x86_64.whl", hash = "sha256:2d7240c5e6a996ef5bebe5d57d43049803e41c225b343681c020bf0c87dab2b2", size = 6003518, upload-time = "2026-09-13T08:38:20.584Z" }, - { url = "https://files.pythonhosted.org/packages/51/45/ca413aefb3ea2411bbf0adb6eebfac1e9bfc5ac7679dbe26336fc651c347/prek-0.5.3-py3-none-macosx_11_0_arm64.whl", hash = "sha256:1dd6df8235ca361dbbeec89c305ccb41a138088a2fc548484b4cb89f66a80d20", size = 5538754, upload-time = "2026-09-13T08:38:23.004Z" }, - { url = "https://files.pythonhosted.org/packages/dc/92/874d58ba40d2fe7cfec2789ae8bf415f3751666ad5c59928821fe53c3c01/prek-0.5.3-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.musllinux_1_1_aarch64.whl", hash = "sha256:61ff791bb850ba52cc0d86576498df7e1bd1e9ed20df63dae113a4a6aa495e19", size = 5841568, upload-time = "2026-09-13T08:38:25.008Z" }, - { url = "https://files.pythonhosted.org/packages/8f/40/167037b8eef75f6f036c60ff7e93f42defebb7c3733677e2f30e5a479257/prek-0.5.3-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:a863379a2668c4ef079d820ffd5b14073145380dfbe0e70fef498dc73c568f86", size = 6226960, upload-time = "2026-09-13T08:38:26.788Z" }, - { url = "https://files.pythonhosted.org/packages/42/9a/bfcd3c1fe1fdefee8dc144a92c4b0b93b59f31c7df60ee1720c49223a90a/prek-0.5.3-py3-none-manylinux_2_28_aarch64.whl", hash = "sha256:086d1b77557f0a089568dc5b93c22ccd793351524f3eeb29d36781421a350e72", size = 5854832, upload-time = "2026-09-13T08:38:28.954Z" }, - { url = "https://files.pythonhosted.org/packages/15/41/1450b995b18bbf0d8ab65016860198052baad5c79c231151fa1dcca4a2de/prek-0.5.3-py3-none-musllinux_1_1_x86_64.whl", hash = "sha256:4f09b947255124e9591a7f7ef16eb5340a36ba94a275d788d7ea804fab35f0e2", size = 6343055, upload-time = "2026-09-13T08:38:30.96Z" }, - { url = "https://files.pythonhosted.org/packages/9c/e8/8f45950b8a8ddcf22efc7183e9d6b1d7e30373229ff7d9e56f918a55922c/prek-0.5.3-py3-none-win_amd64.whl", hash = "sha256:5b74a9742c3e8f8688d5dad1439688f112e2e1746fcb91016015dae38df3eb42", size = 5744293, upload-time = "2026-09-13T08:38:33.104Z" }, - { url = "https://files.pythonhosted.org/packages/24/cd/ce637f4b6cc6c583516dc16b539408dab593672f7c6fe7723a37caf378ff/prek-0.5.3-py3-none-win_arm64.whl", hash = "sha256:20d92aef53a5e237f4659ecc6669c0fbc98a1b83f0e2476530400a72d42ca390", size = 5512958, upload-time = "2026-09-13T08:38:36.123Z" }, -] - [[package]] name = "psycopg" version = "3.3.6" @@ -1196,7 +1180,6 @@ dev = [ { name = "model-mommy" }, { name = "pip-audit" }, { name = "pipdeptree" }, - { name = "prek" }, { name = "ruff" }, { name = "uv" }, { name = "wagtail-factories" }, @@ -1239,7 +1222,6 @@ dev = [ { name = "model-mommy", specifier = ">=2.0.0" }, { name = "pip-audit", specifier = ">=2.10.1" }, { name = "pipdeptree", specifier = ">=4.2.5" }, - { name = "prek", specifier = ">=0.5.3" }, { name = "ruff", specifier = "==0.16.9" }, { name = "uv", specifier = ">=0.12.19" }, { name = "wagtail-factories", specifier = ">=4.5.0" }, From cd58a454303e3aa2c3dccd825ced1bcb0fabb726 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?St=C3=A9phane=20Wirtel?= Date: Fri, 25 Sep 2026 08:43:16 +0200 Subject: [PATCH 8/9] chore(dev): pin prek in mise.toml alongside uv prek is a machine tool like uv: pin it in mise.toml so `mise install` provides it, and document mise as the default way to get it. Co-Authored-By: Claude Opus 5.5 --- .pre-commit-config.yaml | 7 ++++--- CLAUDE.md | 2 +- CONTRIBUTING.md | 7 ++++--- mise.toml | 1 + 4 files changed, 10 insertions(+), 7 deletions(-) diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml index e72fc86..c8bdd67 100644 --- a/.pre-commit-config.yaml +++ b/.pre-commit-config.yaml @@ -1,9 +1,10 @@ # Git hooks, run with prek (https://github.com/j178/prek), a drop-in # replacement for pre-commit that reads this same file. # -# prek must be installed on the machine (e.g. `mise use -g prek`, -# `brew install prek` or `uv tool install prek`); the local hooks also need -# the project environment (`uv sync --all-groups`). +# Like uv, prek is a machine tool, not a project dependency: it is pinned in +# mise.toml (`mise install`), or install it with `brew install prek` or +# `uv tool install prek`. The local hooks also need the project environment +# (`uv sync --all-groups`). # # prek install # install the git hook for this clone # prek run --all-files # run every hook on the whole repository diff --git a/CLAUDE.md b/CLAUDE.md index 14f5ab6..f6ee050 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -125,7 +125,7 @@ task code:check ### Git Hooks (prek) -[prek](https://github.com/j178/prek) (a Rust drop-in replacement for pre-commit) runs the hooks defined in `.pre-commit-config.yaml`. It is **not** a project dependency: it must already be installed on the machine (`mise use -g prek`, `brew install prek` or `uv tool install prek`). CI installs it with `j178/prek-action`. +[prek](https://github.com/j178/prek) (a Rust drop-in replacement for pre-commit) runs the hooks defined in `.pre-commit-config.yaml`. It is **not** a project dependency: like uv, it must already be installed on the machine. It is pinned in `mise.toml` (`mise install`); without mise, use `brew install prek` or `uv tool install prek`. CI installs it with `j178/prek-action`. ```bash # Install the git hook (once per clone) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index e0d1442..1db878d 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -182,11 +182,12 @@ task code:check The repository uses [prek](https://github.com/j178/prek), a fast drop-in replacement for [pre-commit](https://pre-commit.com/) that reads the same -`.pre-commit-config.yaml`. prek is not a project dependency: install it once -on your machine, with one of: +`.pre-commit-config.yaml`. Like uv, prek is not a project dependency: it must +be installed on your machine. It is pinned in `mise.toml`, or install it +another way: ```bash -mise use -g prek # mise +mise install # mise: installs the versions pinned in mise.toml brew install prek # Homebrew uv tool install prek # uv ``` diff --git a/mise.toml b/mise.toml index d0daeac..389e5f8 100644 --- a/mise.toml +++ b/mise.toml @@ -1,4 +1,5 @@ [tools] +prek = "0.5.3" python = "3.13" task = "3.53.1" uv = "0.12.19" From 5e079e6585c2e7926efe2dc8cb7d507c204d3752 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?St=C3=A9phane=20Wirtel?= Date: Fri, 25 Sep 2026 08:50:16 +0200 Subject: [PATCH 9/9] docs: add prek installation and hook setup to every setup guide List uv and prek as prerequisites (pinned in mise.toml) and add the `uv sync --all-groups && prek install` step to the Docker and local setup guides in README.md, CONTRIBUTING.md and DEVELOPMENT.md: the hooks run on the host even when developing with Docker. README.md gets a Git Hooks section. Co-Authored-By: Claude Opus 5.5 --- CONTRIBUTING.md | 8 +++++++ DEVELOPMENT.md | 6 +++++ README.md | 61 +++++++++++++++++++++++++++++++++++-------------- 3 files changed, 58 insertions(+), 17 deletions(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 1db878d..a09587d 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -29,6 +29,7 @@ This project follows the [Python Community Code of Conduct](https://www.python.o - **Docker** and **docker-compose** (recommended) - **Git** - **Task** (optional, for running predefined commands) +- **uv** and **prek** (git hooks), pinned in `mise.toml` (`mise install`), see [Git Hooks (prek)](#git-hooks-prek) ### Repository Structure @@ -57,6 +58,11 @@ website/ git clone cd website +# Install the git hooks (requires uv and prek, see "Git Hooks (prek)" below; +# the ruff and Django hooks run on the host through `uv run`) +uv sync --all-groups +prek install + # Build Docker image task docker:build # or: make docker-build @@ -195,6 +201,8 @@ uv tool install prek # uv The ruff and Django hooks run through `uv run`, so they also need the project environment (`uv sync --all-groups`). +Then enable the hooks, once per clone (whether you develop with Docker or not): + ```bash # Install the git hook once per clone prek install diff --git a/DEVELOPMENT.md b/DEVELOPMENT.md index b67af9a..74c7b5f 100644 --- a/DEVELOPMENT.md +++ b/DEVELOPMENT.md @@ -101,6 +101,7 @@ pythonie/ - Docker + docker-compose - Task (or Make) - Git +- uv and prek (git hooks), pinned in `mise.toml` (`mise install`); see CONTRIBUTING.md for other ways to install prek ### Initial Setup (Docker - Recommended) @@ -109,6 +110,11 @@ pythonie/ git clone cd website +# Install the prek git hooks (they run on the host: the ruff and Django hooks +# use `uv run`, so the host environment is needed too) +uv sync --all-groups +prek install + # 2. Build Docker image task docker:build diff --git a/README.md b/README.md index 61d2681..cb6da3f 100644 --- a/README.md +++ b/README.md @@ -4,7 +4,7 @@ Website for Python Ireland (python.ie / pycon.ie) community, built with Django 6 ## Prerequisites -- Python 3.13 (see `mise.toml`) +- Python 3.13, [uv](https://docs.astral.sh/uv/) and [prek](https://github.com/j178/prek) (git hooks), all pinned in `mise.toml`: run `mise install`, or see [Git Hooks](#git-hooks-prek) for other ways to install prek - Docker & Docker Compose (for containerized development - recommended) - [Task](https://taskfile.dev/) (optional but recommended) - Redis (only for local non-Docker development) @@ -12,41 +12,47 @@ Website for Python Ireland (python.ie / pycon.ie) community, built with Django 6 ## Quick Start (Docker - Recommended) -1. Build the Docker image: +1. Install the git hooks (the ruff and Django hooks run on the host through `uv run`): + ```bash + uv sync --all-groups + prek install + ``` + +2. Build the Docker image: ```bash task docker:build # or: make docker-build ``` -2. Start supporting services: +3. Start supporting services: ```bash docker compose up -d postgres redis ``` -3. Run database migrations: +4. Run database migrations: ```bash task django:migrate ``` -4. Generate sample data (creates pages, navigation, meetups): +5. Generate sample data (creates pages, navigation, meetups): ```bash task django:generate-sample-data # or: docker compose run --rm web python pythonie/manage.py generate_sample_data --settings=pythonie.settings.dev ``` -5. Create a superuser: +6. Create a superuser: ```bash docker compose run --rm web python pythonie/manage.py createsuperuser --settings=pythonie.settings.dev ``` -6. Start the development server: +7. Start the development server: ```bash task run # or: docker compose run --rm --service-ports web python pythonie/manage.py runserver 0.0.0.0:8000 ``` -7. Visit http://127.0.0.1:8000/ to see the site with sample content -8. Access Wagtail admin at http://127.0.0.1:8000/admin/ +8. Visit http://127.0.0.1:8000/ to see the site with sample content +9. Access Wagtail admin at http://127.0.0.1:8000/admin/ ## Local Setup (Without Docker) @@ -56,14 +62,15 @@ If you prefer to develop without Docker: 2. Clone your fork: `git clone git@github.com:YourGitHubName/website.git` 3. Ensure you are running Python 3.13: `python -V` should output `Python 3.13.x` 4. Install dependencies: `uv sync --all-groups` (creates and populates a `.venv` automatically) -5. Set up the database: `uv run python pythonie/manage.py migrate --settings=pythonie.settings.dev` -6. Generate sample data: `task django:generate-sample-data` (or `uv run python pythonie/manage.py generate_sample_data --settings=pythonie.settings.dev`) -7. Create a superuser: `uv run python pythonie/manage.py createsuperuser --settings=pythonie.settings.dev` -8. Install and run Redis server locally: `redis-server` -9. Set Redis environment variable: `export REDISCLOUD_URL=127.0.0.1:6379` -10. Run the server: `uv run python pythonie/manage.py runserver --settings=pythonie.settings.dev` -11. Visit http://127.0.0.1:8000/ to see the site with sample content -12. Visit http://127.0.0.1:8000/admin/ to log in to Wagtail admin +5. Install the git hooks: `prek install` (see [Git Hooks](#git-hooks-prek)) +6. Set up the database: `uv run python pythonie/manage.py migrate --settings=pythonie.settings.dev` +7. Generate sample data: `task django:generate-sample-data` (or `uv run python pythonie/manage.py generate_sample_data --settings=pythonie.settings.dev`) +8. Create a superuser: `uv run python pythonie/manage.py createsuperuser --settings=pythonie.settings.dev` +9. Install and run Redis server locally: `redis-server` +10. Set Redis environment variable: `export REDISCLOUD_URL=127.0.0.1:6379` +11. Run the server: `uv run python pythonie/manage.py runserver --settings=pythonie.settings.dev` +12. Visit http://127.0.0.1:8000/ to see the site with sample content +13. Visit http://127.0.0.1:8000/admin/ to log in to Wagtail admin ## Project Structure @@ -185,6 +192,26 @@ task code:lint task code:check ``` +### Git Hooks (prek) + +The repository uses [prek](https://github.com/j178/prek), a fast drop-in replacement for pre-commit, to run ruff, django-upgrade, the Django system checks, the missing migrations check and generic file checks on every commit. Like uv, prek is not a project dependency: install it on your machine, then enable the hooks in your clone. + +```bash +# 1. Install prek (once per machine), with one of: +mise install # installs the versions pinned in mise.toml +brew install prek +uv tool install prek + +# 2. Enable the git hooks (once per clone) +uv sync --all-groups # the ruff and Django hooks run through `uv run` +prek install + +# Run every hook on the whole repository (same as CI) +prek run --all-files +``` + +See [CONTRIBUTING.md](CONTRIBUTING.md#git-hooks-prek) for the list of hooks and how to skip one in an emergency. + ## Environment Variables For Docker development, create/edit `development.env`: