Skip to content
PyLegifrance

Search in legal codes

The Code class exposes a fluent builder — see the pattern.

Article by number

Section titled “Article by number”
from pylegifrance import LegifranceClient
from pylegifrance.fonds.code import Code
from pylegifrance.models.code.enum import NomCode


client = LegifranceClient()
code = Code(client)


results = (
    code.search()
        .in_code(NomCode.CC)
        .article_number("7")
        .execute()
)

With formatting

Section titled “With formatting”
results = (
    code.search()
        .in_code(NomCode.CC)
        .article_number("7")
        .with_formatter()
        .execute()
)

Whole code

Section titled “Whole code”
results = (
    code.search()
        .in_code(NomCode.CC)
        .execute()
)

Keyword search in article text

Section titled “Keyword search in article text”
from pylegifrance.models.code.enum import TypeChampCode


results = (
    code.search()
        .in_code(NomCode.CC)
        .text("responsabilité", in_field=TypeChampCode.TEXT)
        .paginate(page_size=20)
        .execute()
)
Section titled “Historical search”
# Code civil as of January 1st, 2000
results = (
    code.search()
        .in_code(NomCode.CC)
        .at_date("2000-01-01")
        .execute()
)

By default the search targets the current state. For a historical view, initialize with Code(client, fond="CODE_DATE") or use .at_date().

Pagination

Section titled “Pagination”
results = (
    code.search()
        .in_code(NomCode.CC)
        .text("contrat")
        .paginate(page_number=1, page_size=20)
        .execute()
)

Return shape

Section titled “Return shape”

execute() returns a list[Article] (Pydantic model). See /en/entities/article for available fields. Access example:

for article in results:
    print(article.id, article.num, article.title)

See also

Section titled “See also”