refactor: update Dockerfile and pyproject.toml to streamline test dependencies and ensure coverage is available in the backend container

Author: azzi2023

.github/workflows/test-docker-compose.yml

@@ -33,8 +33,8 @@ jobs:
 
       - name: Run tests with coverage
         run: |
-          # Bootstrap pip inside the backend container and install dev deps (coverage, pytest)
-          docker compose run --rm backend bash -lc "python - <<'PY'\nimport ensurepip, subprocess, sys\ntry:\n    ensurepip.bootstrap()\nexcept Exception:\n    pass\nsubprocess.check_call([sys.executable, '-m', 'pip', 'install', '--upgrade', 'pip'])\nsubprocess.check_call([sys.executable, '-m', 'pip', 'install', '--no-cache-dir', 'coverage', 'pytest', 'pytest-asyncio'])\nPY\npython -m coverage run -m pytest --maxfail=1 -q --disable-warnings && python -m coverage xml -o coverage.xml && python -m coverage html -d coverage_html"
+          # Bootstrap pip inside the backend container and install test/dev deps from pyproject (. [dev])
+          docker compose run --rm backend bash -lc "python - <<'PY'\nimport ensurepip, subprocess, sys\ntry:\n    ensurepip.bootstrap()\nexcept Exception:\n    pass\nsubprocess.check_call([sys.executable, '-m', 'pip', 'install', '--upgrade', 'pip', 'setuptools'])\nsubprocess.check_call([sys.executable, '-m', 'pip', 'install', '--no-cache-dir', '.[dev]'])\nPY\npython -m coverage run -m pytest --maxfail=1 -q --disable-warnings && python -m coverage xml -o coverage.xml && python -m coverage html -d coverage_html"
 
       - name: Upload coverage artifact
         uses: actions/upload-artifact@v4

backend/Dockerfile

@@ -41,8 +41,4 @@ COPY ./tests /app/tests
 RUN --mount=type=cache,target=/root/.cache/uv \
     uv sync
 
-# Ensure coverage is available inside the uv-created virtualenv so test
-# commands like `python -m coverage` work when running inside the container.
-RUN /app/.venv/bin/python -m pip install --no-cache-dir coverage
-
 CMD ["fastapi", "run", "--workers", "4", "app/main.py"]

backend/pyproject.toml

@@ -38,6 +38,13 @@ dev-dependencies = [
     "coverage<8.0.0,>=7.4.3",
 ]
 
+[project.optional-dependencies]
+dev = [
+    "pytest<8.0.0,>=7.4.3",
+    "pytest-asyncio",
+    "coverage<8.0.0,>=7.4.3",
+]
+
 [build-system]
 requires = ["hatchling"]
 build-backend = "hatchling.build"