[PPHA-186] Use ruff for linting

In order to allow linting inside the docker container, create a
"development" docker stage and run lint and test task via poetry.

The same command can be used between CI and local

Author: Themitchell

Dockerfile

@@ -11,7 +11,13 @@ RUN npm run compile
 FROM python:3.13.5-alpine3.21 AS python_base
 
 ENV PYTHONDONTWRITEBYTECODE=1 \
-    PYTHONUNBUFFERED=1
+    PYTHONUNBUFFERED=1 \
+    VIRTUAL_ENV=/app/.venv \
+    PATH="/app/.venv/bin:$PATH" \
+    USER=app
+
+RUN addgroup --gid 1000 --system ${USER} \
+    && adduser --uid 1000 --system ${USER} --ingroup ${USER}
 
 FROM python_base AS builder
 
@@ -26,15 +32,16 @@ COPY pyproject.toml poetry.lock ./
 RUN pip install poetry
 RUN poetry install --without dev --no-root && rm -rf $POETRY_CACHE_DIR
 
+FROM builder AS development
 
-FROM python_base
+RUN poetry install
 
-ENV VIRTUAL_ENV=/app/.venv \
-    PATH="/app/.venv/bin:$PATH" \
-    USER=app
+USER ${USER}
+WORKDIR /app
 
-RUN addgroup --gid 1000 --system ${USER} \
-    && adduser --uid 1000 --system ${USER} --ingroup ${USER}
+COPY --chown=${USER}:${USER} . .
+
+FROM python_base
 
 USER ${USER}
 WORKDIR /app

docker-compose.yml

@@ -2,7 +2,10 @@
 
 services:
   web:
-    build: .
+    build:
+      context: .
+      dockerfile: Dockerfile
+      target: development
     command: python manage.py runserver 0.0.0.0:8000
     ports:
       - "8000:8000"

poetry.lock

@@ -16,6 +16,9 @@ dependencies = [
 [tool.poetry]
 package-mode = false
 
+[tool.poetry.group.dev.dependencies]
+ruff = "^0.12.5"
+
 [build-system]
 requires = ["poetry-core>=2.0.0,<3.0.0"]
 build-backend = "poetry.core.masonry.api"

pyproject.toml

@@ -0,0 +1,20 @@
+#!/bin/bash
+
+set -euo pipefail
+
+cd "$(git rev-parse --show-toplevel)"
+
+# This file is for you! Edit it to call your unit test suite. Note that the same
+# file will be called if you run it locally as if you run it on CI.
+
+# Replace the following line with something like:
+#
+#   rubocop
+#   python manage.py lint
+#   npm run lint
+#
+# or whatever is appropriate to your project. You should *only* run your fast
+# tests from here. If you want to run other test suites, see the predefined
+# tasks in scripts/lint.mk.
+
+docker compose run --rm web poetry run ruff check lung_cancer_screening

scripts/tests/lint.sh

@@ -17,4 +17,4 @@ cd "$(git rev-parse --show-toplevel)"
 # tests from here. If you want to run other test suites, see the predefined
 # tasks in scripts/test.mk.
 
-docker compose run web python manage.py test
+docker compose run web poetry run python manage.py test