Editing Development/Testing (section)

== Fixtures ==

=== Factory fixtures for data objects ===

When tests need multiple instances with variations, use factory fixtures:

<syntaxhighlight lang="python">
@pytest.fixture
def make_legislation_article():
    """Factory: creates LegislationArticle instances with sensible defaults."""
    def _make(
        article_id: str = "fr.legiarti000006436298",
        article_number: str = "1240",
        code_name: str = "code civil",
        is_in_force: bool = True,
        **overrides,
    ) -> LegislationArticle:
        defaults = {
            "article_id": article_id,
            "article_number": article_number,
            "code_name": code_name,
            "is_in_force": is_in_force,
            "html_content": "<p>Tout fait quelconque de l'homme...</p>",
            "plain_text_content": "Tout fait quelconque de l'homme...",
        }
        defaults.update(overrides)
        return LegislationArticle(**defaults)
    return _make
</syntaxhighlight>

=== Real data fixtures ===

Test fixtures use '''real files''' from public institutional data sources (DILA, Judilibre, EUR-Lex). Not invented mocks. This is consistent with the project's commitment to transparency and auditability.

<syntaxhighlight lang="python">
FIXTURES_DIR = Path(__file__).parent / "fixtures"

@pytest.fixture
def sample_legi_article_path() -> Path:
    """Real LEGI XML article: article 1240 du code civil."""
    return FIXTURES_DIR / "fr.legiarti000006436298.xml"

@pytest.fixture
def sample_jade_decision_path() -> Path:
    """Real JADE XML decision: CE, 13 dec 2022, n 462274."""
    return FIXTURES_DIR / "fr.cetatext000046783006.xml"
</syntaxhighlight>

=== Session-scoped fixtures for expensive resources ===

<syntaxhighlight lang="python">
@pytest.fixture(scope="session")
def database_connection():
    """PostgreSQL connection via testcontainers. Shared across all tests in session."""
    with PostgresContainer("postgres:17") as postgres:
        pool = ConnectionPool(postgres.get_connection_url())
        yield pool
        pool.close()
</syntaxhighlight>