fix(tests): apply migrations before test session via conftest fixture (#2)

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: nanotaboada

CHANGELOG.md

@@ -53,6 +53,9 @@ This project uses famous football coaches as release codenames, following an A-Z
 - `alembic==1.18.4`, `asyncpg==0.31.0` added to dependencies (#2)
 - `tests/test_migrations.py`: integration tests for migration downgrade paths —
   verifies each step removes only its seeded rows and restores correctly (#2)
+- `tests/conftest.py`: session-scoped `apply_migrations` fixture runs
+  `alembic upgrade head` once before the test session, ensuring the database
+  exists and is at head in CI and local environments (#2)
 - `codecov.yaml`: excludes `alembic/env.py` from coverage (offline mode is
   tooling infrastructure, not application logic) (#2)
 - `.sonarcloud.properties`: SonarCloud Automatic Analysis configuration —

tests/conftest.py

@@ -1,14 +1,25 @@
 import warnings
+from pathlib import Path
 from typing import Any, Generator
 
 import pytest
+from alembic import command
+from alembic.config import Config
 from fastapi.testclient import TestClient
 from main import app
 from tests.player_fake import Player, nonexistent_player
 
 # Suppress the DeprecationWarning from httpx
 warnings.filterwarnings("ignore", category=DeprecationWarning)
 
+ALEMBIC_CONFIG = Config(str(Path(__file__).resolve().parent.parent / "alembic.ini"))
+
+
+@pytest.fixture(scope="session", autouse=True)
+def apply_migrations():
+    """Apply Alembic migrations once before the test session starts."""
+    command.upgrade(ALEMBIC_CONFIG, "head")
+
 
 @pytest.fixture(scope="function")
 def client():

tests/test_migrations.py

@@ -13,13 +13,12 @@
 
 import os
 import sqlite3
-from pathlib import Path
 
 from alembic import command
-from alembic.config import Config
+
+from tests.conftest import ALEMBIC_CONFIG
 
 DB_PATH = os.getenv("STORAGE_PATH", "./players-sqlite3.db")
-ALEMBIC_CONFIG = Config(str(Path(__file__).resolve().parent.parent / "alembic.ini"))
 
 
 def test_migration_downgrade_003_removes_substitutes_only():