ffbb-data-client 2.0.0__py3-none-any.whl

ffbb_data_client/models/organismes_hit.py

@@ -0,0 +1,196 @@
+from __future__ import annotations
+
+from dataclasses import dataclass, field
+from datetime import datetime
+from typing import Any
+
+from ..utils.converter_utils import (
+    from_bool,
+    from_datetime,
+    from_list,
+    from_obj,
+    from_str,
+)
+from .cartographie import Cartographie
+from .commune import Commune
+from .geo import Geo
+from .hit import Hit
+from .logo import Logo
+from .organisme_id_pere import OrganismeIDPere
+from .type_association import TypeAssociation
+
+
+@dataclass
+class OrganismesHit(Hit):
+    nom_club_pro: str | None = None
+    nom: str | None = None
+    adresse: str | None = None
+    adresse_club_pro: str | None = None
+    code: str | None = None
+    id: str | None = None
+    engagements_noms: str | None = None
+    mail: str | None = None
+    telephone: str | None = None
+    type: str | None = None
+    url_site_web: str | None = None
+    nom_simple: str | None = None
+    date_affiliation: datetime | None = None
+    saison_en_cours: bool | None = None
+    offres_pratiques: list[str] | None = None
+    labellisation: list[str] | None = None
+    cartographie: Cartographie | None = None
+    organisme_id_pere: OrganismeIDPere | None = None
+    commune: Commune | None = None
+    commune_club_pro: Commune | None = None
+    type_association: TypeAssociation | None = None
+    logo: Logo | None = None
+    geo: Geo | None = None
+    thumbnail: str | None = None
+    lower_nom_club_pro: str | None = field(init=False, default=None, repr=False)
+    lower_nom: str | None = field(init=False, default=None, repr=False)
+    lower_engagements_noms: str | None = field(init=False, default=None, repr=False)
+
+    @property
+    def name(self) -> str | None:
+        """Alias for .nom — unified name accessor across all Hit types."""
+        return self.nom
+
+    def __post_init__(self) -> None:
+        self.lower_nom_club_pro = (
+            self.nom_club_pro.lower() if self.nom_club_pro else None
+        )
+        self.lower_nom = self.nom.lower() if self.nom else None
+        self.lower_engagements_noms = (
+            self.engagements_noms.lower() if self.engagements_noms else None
+        )
+
+    @staticmethod
+    def from_dict(obj: Any) -> OrganismesHit:
+        try:
+            assert isinstance(obj, dict)
+            nom_club_pro = from_str(obj, "nomClubPro")
+            nom = from_str(obj, "nom")
+            adresse = from_str(obj, "adresse")
+            adresse_club_pro = from_str(obj, "adresseClubPro")
+            code = from_str(obj, "code")
+            id = from_str(obj, "id")
+            engagements_noms = from_str(obj, "engagements_noms")
+            mail = from_str(obj, "mail")
+            telephone = from_str(obj, "telephone")
+            type = from_str(obj, "type")
+            url_site_web = from_str(obj, "urlSiteWeb")
+            nom_simple = from_str(obj, "nom_simple")
+            date_affiliation = from_datetime(obj, "dateAffiliation")
+            saison_en_cours = from_bool(obj, "saison_en_cours")
+            offres_pratiques = from_list(str, obj, "offresPratiques")
+            labellisation = from_list(str, obj, "labellisation")
+            cartographie = from_obj(Cartographie.from_dict, obj, "cartographie")
+            organisme_id_pere = from_obj(
+                OrganismeIDPere.from_dict, obj, "organisme_id_pere"
+            )
+            commune = from_obj(Commune.from_dict, obj, "commune")
+            commune_club_pro = from_obj(Commune.from_dict, obj, "communeClubPro")
+            type_association = from_obj(
+                TypeAssociation.from_dict, obj, "type_association"
+            )
+            logo = from_obj(Logo.from_dict, obj, "logo")
+            geo = from_obj(Geo.from_dict, obj, "_geo")
+            thumbnail = from_str(obj, "thumbnail")
+            return OrganismesHit(
+                nom_club_pro=nom_club_pro,
+                nom=nom,
+                adresse=adresse,
+                adresse_club_pro=adresse_club_pro,
+                code=code,
+                id=id,
+                engagements_noms=engagements_noms,
+                mail=mail,
+                telephone=telephone,
+                type=type,
+                url_site_web=url_site_web,
+                nom_simple=nom_simple,
+                date_affiliation=date_affiliation,
+                saison_en_cours=saison_en_cours,
+                offres_pratiques=offres_pratiques,
+                labellisation=labellisation,
+                cartographie=cartographie,
+                organisme_id_pere=organisme_id_pere,
+                commune=commune,
+                commune_club_pro=commune_club_pro,
+                type_association=type_association,
+                logo=logo,
+                geo=geo,
+                thumbnail=thumbnail,
+            )
+        except Exception as e:
+            raise ValueError(f"Invalid `OrganismesHit` object: {e}") from e
+
+    def to_dict(self) -> dict:
+        result: dict = {}
+        if self.nom_club_pro is not None:
+            result["nomClubPro"] = self.nom_club_pro
+        if self.nom is not None:
+            result["nom"] = self.nom
+        if self.adresse is not None:
+            result["adresse"] = self.adresse
+        if self.adresse_club_pro is not None:
+            result["adresseClubPro"] = self.adresse_club_pro
+        if self.code is not None:
+            result["code"] = self.code
+        if self.id is not None:
+            result["id"] = self.id
+        if self.engagements_noms is not None:
+            result["engagements_noms"] = self.engagements_noms
+        if self.mail is not None:
+            result["mail"] = self.mail
+        if self.telephone is not None:
+            result["telephone"] = self.telephone
+        if self.type is not None:
+            result["type"] = self.type
+        if self.url_site_web is not None:
+            result["urlSiteWeb"] = self.url_site_web
+        if self.nom_simple is not None:
+            result["nom_simple"] = self.nom_simple
+        if self.date_affiliation is not None:
+            result["dateAffiliation"] = self.date_affiliation.isoformat()
+        if self.saison_en_cours is not None:
+            result["saison_en_cours"] = self.saison_en_cours
+        if self.offres_pratiques is not None:
+            result["offresPratiques"] = self.offres_pratiques
+        if self.labellisation is not None:
+            result["labellisation"] = self.labellisation
+        if self.cartographie is not None:
+            result["cartographie"] = self.cartographie.to_dict()
+        if self.organisme_id_pere is not None:
+            result["organisme_id_pere"] = self.organisme_id_pere.to_dict()
+        if self.commune is not None:
+            result["commune"] = self.commune.to_dict()
+        if self.commune_club_pro is not None:
+            result["communeClubPro"] = self.commune_club_pro.to_dict()
+        if self.type_association is not None:
+            result["type_association"] = self.type_association.to_dict()
+        if self.logo is not None:
+            result["logo"] = self.logo.to_dict()
+        if self.geo is not None:
+            result["_geo"] = self.geo.to_dict()
+        if self.thumbnail is not None:
+            result["thumbnail"] = self.thumbnail
+        return result
+
+    def is_valid_for_query(self, query: str) -> bool:
+        return bool(
+            not query
+            or (self.lower_nom and query in self.lower_nom)
+            or (self.lower_nom_club_pro and query in self.lower_nom_club_pro)
+            or (self.lower_engagements_noms and query in self.lower_engagements_noms)
+            or (
+                self.commune
+                and (
+                    (self.commune.lower_libelle and query in self.commune.lower_libelle)
+                    or (
+                        self.commune.lower_departement
+                        and query in self.commune.lower_departement
+                    )
+                )
+            )
+        )

ffbb_data_client/models/organismes_multi_search_query.py

@@ -0,0 +1,41 @@
+from __future__ import annotations
+
+from ..config import MEILISEARCH_FACETS_ORGANISMES, MEILISEARCH_INDEX_ORGANISMES
+from .multi_search_query import MultiSearchQuery
+from .multi_search_result_organismes import OrganismesMultiSearchResult
+from .multi_search_results import MultiSearchResult
+from .organismes_facet_distribution import OrganismesFacetDistribution
+from .organismes_facet_stats import OrganismesFacetStats
+
+
+class OrganismesMultiSearchQuery(MultiSearchQuery):
+    def __init__(
+        self,
+        q: str | None,
+        limit: int | None = 10,
+        offset: int | None = 0,
+        filter: list[str] | None = None,
+        sort: list[str] | None = None,
+    ):
+        super().__init__(
+            index_uid=MEILISEARCH_INDEX_ORGANISMES,
+            q=q,
+            facets=MEILISEARCH_FACETS_ORGANISMES,
+            limit=limit,
+            offset=offset,
+            filter=filter,
+            sort=sort,
+        )
+
+    def is_valid_result(self, result: MultiSearchResult):
+        return result and (
+            isinstance(result, OrganismesMultiSearchResult)
+            and (
+                result.facet_distribution is None
+                or isinstance(result.facet_distribution, OrganismesFacetDistribution)
+            )
+            and (
+                result.facet_stats is None
+                or isinstance(result.facet_stats, OrganismesFacetStats)
+            )
+        )

ffbb_data_client/models/organismes_query.py

@@ -0,0 +1,8 @@
+from __future__ import annotations
+
+from dataclasses import dataclass, field
+
+
+@dataclass
+class OrganismesQuery:
+    fields_: list[str] | None = field(default=None)  # Original: fields[]

ffbb_data_client/models/phase_code.py

@@ -0,0 +1,23 @@
+from enum import Enum
+
+
+class PhaseCode(Enum):
+    B1 = "B1"
+    B2 = "B2"
+    F = "F"
+    J1 = "J1"
+    P1 = "P1"
+    P2 = "P2"
+    P3 = "P3"
+    P4 = "P4"
+    P5 = "P5"
+    T1 = "T1"
+    T2 = "T2"
+    T3 = "T3"
+    THE_116 = "1/16"
+    THE_12 = "1/2"
+    THE_132 = "1/32"
+    THE_14 = "1/4"
+    THE_164 = "1/64"
+    THE_18 = "1/8"
+    TP = "TP"

ffbb_data_client/models/poule.py

@@ -0,0 +1,35 @@
+from __future__ import annotations
+
+from dataclasses import dataclass
+from typing import Any
+
+from ..utils.converter_utils import (
+    from_list,
+    from_str,
+)
+from .rencontres_engagement import Engagement
+
+
+@dataclass
+class Poule:
+    nom: str | None = None
+    id: str | None = None
+    engagements: list[Engagement] | None = None
+
+    @staticmethod
+    def from_dict(obj: Any) -> Poule:
+        assert isinstance(obj, dict)
+        nom = from_str(obj, "nom")
+        id = from_str(obj, "id")
+        engagements = from_list(Engagement.from_dict, obj, "engagements")
+        return Poule(nom=nom, id=id, engagements=engagements)
+
+    def to_dict(self) -> dict:
+        result: dict = {}
+        if self.nom is not None:
+            result["nom"] = self.nom
+        if self.id is not None:
+            result["id"] = self.id
+        if self.engagements is not None:
+            result["engagements"] = [e.to_dict() for e in self.engagements]
+        return result

ffbb_data_client/models/poule_fields.py

@@ -0,0 +1,261 @@
+class PouleFields:
+    """Default fields for poule queries."""
+
+    # Basic fields
+    ID = "id"
+    NOM = "nom"
+    LOGO_ID = "logo.id"
+
+    # ID Competition fields
+    ID_COMPETITION_ORGANISATEUR_CODE = "id_competition.organisateur.code"
+    ID_COMPETITION_ORGANISATEUR_NOM = "id_competition.organisateur.nom"
+    ID_COMPETITION_ORGANISATEUR_SAISON = "id_competition.organisateur.saison"
+    ID_COMPETITION_ORGANISATEUR_COMMUNE_DEPARTEMENT_CODE = (
+        "id_competition.organisateur.commune.departement.code"
+    )
+    ID_COMPETITION_ORGANISATEUR_COMMUNE_DEPARTEMENT_CODE_INSEE = (
+        "id_competition.organisateur.commune.departement.codeInsee"
+    )
+    ID_COMPETITION_ORGANISATEUR_COMMUNE_DEPARTEMENT_LIBELLE = (
+        "id_competition.organisateur.commune.departement.libelle"
+    )
+
+    # Rencontres fields
+    RENCONTRES_ID = "rencontres.id"
+    RENCONTRES_NUMERO = "rencontres.numero"
+    RENCONTRES_NUMERO_JOURNEE = "rencontres.numeroJournee"
+    RENCONTRES_ID_POULE = "rencontres.idPoule"
+    RENCONTRES_COMPETITION_ID = "rencontres.competitionId"
+    RENCONTRES_RESULTAT_EQUIPE1 = "rencontres.resultatEquipe1"
+    RENCONTRES_RESULTAT_EQUIPE2 = "rencontres.resultatEquipe2"
+    RENCONTRES_JOUE = "rencontres.joue"
+    RENCONTRES_NOM_EQUIPE1 = "rencontres.nomEquipe1"
+    RENCONTRES_NOM_EQUIPE2 = "rencontres.nomEquipe2"
+    RENCONTRES_DATE_RENCONTRE = "rencontres.date_rencontre"
+
+    # GameStats fields (live match data)
+    RENCONTRES_GSID_MATCH_ID = "rencontres.gsId.matchId"
+    RENCONTRES_GSID_CURRENT_STATUS = "rencontres.gsId.currentStatus"
+    RENCONTRES_GSID_CURRENT_PERIOD = "rencontres.gsId.currentPeriod"
+    RENCONTRES_GSID_SCORE_Q1_HOME = "rencontres.gsId.score_q1_home"
+    RENCONTRES_GSID_SCORE_Q2_HOME = "rencontres.gsId.score_q2_home"
+    RENCONTRES_GSID_SCORE_Q3_HOME = "rencontres.gsId.score_q3_home"
+    RENCONTRES_GSID_SCORE_Q4_HOME = "rencontres.gsId.score_q4_home"
+    RENCONTRES_GSID_SCORE_OT1_HOME = "rencontres.gsId.score_ot1_home"
+    RENCONTRES_GSID_SCORE_OT2_HOME = "rencontres.gsId.score_ot2_home"
+    RENCONTRES_GSID_SCORE_Q1_OUT = "rencontres.gsId.score_q1_out"
+    RENCONTRES_GSID_SCORE_Q2_OUT = "rencontres.gsId.score_q2_out"
+    RENCONTRES_GSID_SCORE_Q3_OUT = "rencontres.gsId.score_q3_out"
+    RENCONTRES_GSID_SCORE_Q4_OUT = "rencontres.gsId.score_q4_out"
+    RENCONTRES_GSID_SCORE_OT1_OUT = "rencontres.gsId.score_ot1_out"
+    RENCONTRES_GSID_SCORE_OT2_OUT = "rencontres.gsId.score_ot2_out"
+
+    # Classements fields
+    CLASSEMENTS_ID = "classements.id"
+    CLASSEMENTS_ID_ENGAGEMENT_ID = "classements.idEngagement.id"
+    CLASSEMENTS_ID_ENGAGEMENT_NOM = "classements.idEngagement.nom"
+    CLASSEMENTS_ID_ENGAGEMENT_NOM_USUEL = "classements.idEngagement.nomUsuel"
+    CLASSEMENTS_ID_ENGAGEMENT_CODE_ABREGE = "classements.idEngagement.codeAbrege"
+    CLASSEMENTS_ID_ENGAGEMENT_NUMERO_EQU = "classements.idEngagement.numeroEqu"
+    CLASSEMENTS_ID_ENGAGEMENT_LOGO_ID = "classements.idEngagement.logo.id"
+    CLASSEMENTS_ID_ENGAGEMENT_LOGO_GRADIENT = (
+        "classements.idEngagement.logo.gradient_color"
+    )
+    CLASSEMENTS_ORGANISME_ID = "classements.organisme.id"
+    CLASSEMENTS_ORGANISME_NOM = "classements.organisme.nom"
+    CLASSEMENTS_ORGANISME_LOGO_ID = "classements.organisme.logo.id"
+    CLASSEMENTS_ORGANISME_NOM_SIMPLE = "classements.organisme_nom"
+    CLASSEMENTS_ID_COMPETITION = "classements.idCompetition"
+    CLASSEMENTS_ID_POULE = "classements.idPoule"
+    CLASSEMENTS_ID_POULE_ID = "classements.idPoule.id"
+    CLASSEMENTS_POSITION = "classements.position"
+    CLASSEMENTS_POINTS = "classements.points"
+    CLASSEMENTS_MATCH_JOUES = "classements.matchJoues"
+    CLASSEMENTS_GAGNES = "classements.gagnes"
+    CLASSEMENTS_PERDUS = "classements.perdus"
+    CLASSEMENTS_NULS = "classements.nuls"
+    CLASSEMENTS_NOMBRE_FORFAITS = "classements.nombreForfaits"
+    CLASSEMENTS_NOMBRE_DEFAUTS = "classements.nombreDefauts"
+    CLASSEMENTS_PANIERS_MARQUES = "classements.paniersMarques"
+    CLASSEMENTS_PANIERS_ENCAISSES = "classements.paniersEncaisses"
+    CLASSEMENTS_DIFFERENCE = "classements.difference"
+    CLASSEMENTS_QUOTIENT = "classements.quotient"
+    CLASSEMENTS_POINT_INITIAUX = "classements.pointInitiaux"
+    CLASSEMENTS_PENALITES_ARBITRAGE = "classements.penalitesArbitrage"
+    CLASSEMENTS_PENALITES_ENTRAINEUR = "classements.penalitesEntraineur"
+    CLASSEMENTS_PENALITES_DIVERSES = "classements.penalitesDiverses"
+    CLASSEMENTS_HORS_CLASSEMENT = "classements.horsClassement"
+
+    @classmethod
+    def get_default_fields(cls) -> list[str]:
+        """Get default fields for poule queries based on real API usage."""
+        return [
+            # Basic fields
+            cls.ID,
+            cls.NOM,
+            cls.LOGO_ID,
+            # ID Competition fields
+            cls.ID_COMPETITION_ORGANISATEUR_CODE,
+            cls.ID_COMPETITION_ORGANISATEUR_NOM,
+            cls.ID_COMPETITION_ORGANISATEUR_SAISON,
+            cls.ID_COMPETITION_ORGANISATEUR_COMMUNE_DEPARTEMENT_CODE,
+            cls.ID_COMPETITION_ORGANISATEUR_COMMUNE_DEPARTEMENT_CODE_INSEE,
+            cls.ID_COMPETITION_ORGANISATEUR_COMMUNE_DEPARTEMENT_LIBELLE,
+            # Rencontres - champs essentiels
+            cls.RENCONTRES_ID,
+            cls.RENCONTRES_NUMERO,
+            cls.RENCONTRES_NUMERO_JOURNEE,
+            cls.RENCONTRES_ID_POULE,
+            "rencontres.competitionId.id",
+            "rencontres.competitionId.competition_origine",
+            "rencontres.idOrganismeEquipe1.logo.id",
+            "rencontres.idOrganismeEquipe1.id",
+            "rencontres.idOrganismeEquipe2.logo.id",
+            "rencontres.idOrganismeEquipe2.id",
+            cls.RENCONTRES_RESULTAT_EQUIPE1,
+            cls.RENCONTRES_RESULTAT_EQUIPE2,
+            cls.RENCONTRES_JOUE,
+            cls.RENCONTRES_NOM_EQUIPE1,
+            cls.RENCONTRES_NOM_EQUIPE2,
+            cls.RENCONTRES_GSID_MATCH_ID,
+            cls.RENCONTRES_GSID_CURRENT_STATUS,
+            cls.RENCONTRES_GSID_SCORE_Q1_HOME,
+            cls.RENCONTRES_GSID_SCORE_Q2_HOME,
+            cls.RENCONTRES_GSID_SCORE_Q3_HOME,
+            cls.RENCONTRES_GSID_SCORE_Q4_HOME,
+            cls.RENCONTRES_GSID_SCORE_OT1_HOME,
+            cls.RENCONTRES_GSID_SCORE_OT2_HOME,
+            cls.RENCONTRES_GSID_SCORE_Q1_OUT,
+            cls.RENCONTRES_GSID_SCORE_Q2_OUT,
+            cls.RENCONTRES_GSID_SCORE_Q3_OUT,
+            cls.RENCONTRES_GSID_SCORE_Q4_OUT,
+            cls.RENCONTRES_GSID_SCORE_OT1_OUT,
+            cls.RENCONTRES_GSID_SCORE_OT2_OUT,
+            cls.RENCONTRES_GSID_CURRENT_PERIOD,
+            "rencontres.idEngagementEquipe1.id",
+            "rencontres.idEngagementEquipe1.nom",
+            "rencontres.idEngagementEquipe1.nomOfficiel",
+            "rencontres.idEngagementEquipe1.nomUsuel",
+            "rencontres.idEngagementEquipe1.logo.id",
+            "rencontres.idEngagementEquipe1.logo.gradient_color",
+            "rencontres.idEngagementEquipe1.codeAbrege",
+            "rencontres.idEngagementEquipe1.idOrganisme.code",
+            "rencontres.idEngagementEquipe1.numeroEquipe",
+            "rencontres.idEngagementEquipe2.id",
+            "rencontres.idEngagementEquipe2.nom",
+            "rencontres.idEngagementEquipe2.nomOfficiel",
+            "rencontres.idEngagementEquipe2.nomUsuel",
+            "rencontres.idEngagementEquipe2.logo.id",
+            "rencontres.idEngagementEquipe2.logo.gradient_color",
+            "rencontres.idEngagementEquipe2.codeAbrege",
+            "rencontres.idEngagementEquipe2.idOrganisme.code",
+            "rencontres.idEngagementEquipe2.numeroEquipe",
+            "rencontres.salle.id",
+            "rencontres.salle.numero",
+            "rencontres.salle.libelle",
+            "rencontres.salle.libelle2",
+            "rencontres.salle.adresse",
+            "rencontres.salle.adresseComplement",
+            "rencontres.salle.commune.codePostal",
+            "rencontres.salle.commune.libelle",
+            "rencontres.salle.cartographie.latitude",
+            "rencontres.salle.cartographie.longitude",
+            cls.RENCONTRES_DATE_RENCONTRE,
+            "rencontres.officiels.ordre",
+            "rencontres.officiels.fonction.libelle",
+            "rencontres.officiels.officiel.nom",
+            "rencontres.officiels.officiel.prenom",
+            # Classements - tous les champs
+            cls.CLASSEMENTS_ID,
+            cls.CLASSEMENTS_ID_ENGAGEMENT_NOM,
+            cls.CLASSEMENTS_ID_ENGAGEMENT_NOM_USUEL,
+            cls.CLASSEMENTS_ID_ENGAGEMENT_ID,
+            cls.CLASSEMENTS_ID_ENGAGEMENT_LOGO_ID,
+            cls.CLASSEMENTS_ID_ENGAGEMENT_LOGO_GRADIENT,
+            cls.CLASSEMENTS_ID_ENGAGEMENT_CODE_ABREGE,
+            "classements.idEngagement.numeroEquipe",
+            cls.CLASSEMENTS_ORGANISME_ID,
+            cls.CLASSEMENTS_ORGANISME_NOM,
+            cls.CLASSEMENTS_ORGANISME_LOGO_ID,
+            cls.CLASSEMENTS_ORGANISME_NOM_SIMPLE,
+            cls.CLASSEMENTS_ID_COMPETITION,
+            cls.CLASSEMENTS_ID_POULE,
+            cls.CLASSEMENTS_ID_POULE_ID,
+            cls.CLASSEMENTS_MATCH_JOUES,
+            cls.CLASSEMENTS_POINTS,
+            cls.CLASSEMENTS_POSITION,
+            cls.CLASSEMENTS_GAGNES,
+            cls.CLASSEMENTS_PERDUS,
+            cls.CLASSEMENTS_NULS,
+            cls.CLASSEMENTS_POINT_INITIAUX,
+            cls.CLASSEMENTS_PENALITES_ARBITRAGE,
+            cls.CLASSEMENTS_PENALITES_ENTRAINEUR,
+            cls.CLASSEMENTS_PENALITES_DIVERSES,
+            cls.CLASSEMENTS_NOMBRE_FORFAITS,
+            cls.CLASSEMENTS_NOMBRE_DEFAUTS,
+            cls.CLASSEMENTS_PANIERS_MARQUES,
+            cls.CLASSEMENTS_PANIERS_ENCAISSES,
+            cls.CLASSEMENTS_DIFFERENCE,
+            cls.CLASSEMENTS_QUOTIENT,
+            cls.CLASSEMENTS_HORS_CLASSEMENT,
+        ]
+
+    @classmethod
+    def get_detailed_fields(cls) -> list[str]:
+        """Get detailed fields (all fields now included in default)."""
+        return cls.get_default_fields()
+
+    @classmethod
+    def get_classement_fields(cls) -> list[str]:
+        """Get classement-only fields (no rencontres) for lightweight ranking queries."""
+        return [
+            # Basic fields
+            cls.ID,
+            cls.NOM,
+            cls.LOGO_ID,
+            # ID Competition fields
+            cls.ID_COMPETITION_ORGANISATEUR_CODE,
+            cls.ID_COMPETITION_ORGANISATEUR_NOM,
+            # Classements - all fields
+            cls.CLASSEMENTS_ID,
+            cls.CLASSEMENTS_ID_ENGAGEMENT_NOM,
+            cls.CLASSEMENTS_ID_ENGAGEMENT_NOM_USUEL,
+            cls.CLASSEMENTS_ID_ENGAGEMENT_ID,
+            cls.CLASSEMENTS_ID_ENGAGEMENT_LOGO_ID,
+            cls.CLASSEMENTS_ID_ENGAGEMENT_LOGO_GRADIENT,
+            cls.CLASSEMENTS_ID_ENGAGEMENT_CODE_ABREGE,
+            "classements.idEngagement.numeroEquipe",
+            cls.CLASSEMENTS_ORGANISME_ID,
+            cls.CLASSEMENTS_ORGANISME_NOM,
+            cls.CLASSEMENTS_ORGANISME_LOGO_ID,
+            cls.CLASSEMENTS_ORGANISME_NOM_SIMPLE,
+            cls.CLASSEMENTS_ID_COMPETITION,
+            cls.CLASSEMENTS_ID_POULE,
+            cls.CLASSEMENTS_ID_POULE_ID,
+            cls.CLASSEMENTS_MATCH_JOUES,
+            cls.CLASSEMENTS_POINTS,
+            cls.CLASSEMENTS_POSITION,
+            cls.CLASSEMENTS_GAGNES,
+            cls.CLASSEMENTS_PERDUS,
+            cls.CLASSEMENTS_NULS,
+            cls.CLASSEMENTS_POINT_INITIAUX,
+            cls.CLASSEMENTS_PENALITES_ARBITRAGE,
+            cls.CLASSEMENTS_PENALITES_ENTRAINEUR,
+            cls.CLASSEMENTS_PENALITES_DIVERSES,
+            cls.CLASSEMENTS_NOMBRE_FORFAITS,
+            cls.CLASSEMENTS_NOMBRE_DEFAUTS,
+            cls.CLASSEMENTS_PANIERS_MARQUES,
+            cls.CLASSEMENTS_PANIERS_ENCAISSES,
+            cls.CLASSEMENTS_DIFFERENCE,
+            cls.CLASSEMENTS_QUOTIENT,
+            cls.CLASSEMENTS_HORS_CLASSEMENT,
+        ]
+
+    @classmethod
+    def get_basic_fields(cls) -> list[str]:
+        """Get basic fields for simple poule queries."""
+        return [
+            cls.ID,
+            cls.NOM,
+            cls.RENCONTRES_ID,
+        ]

ffbb_data_client/models/poule_rencontre_item_model.py

@@ -0,0 +1,69 @@
+from __future__ import annotations
+
+from dataclasses import dataclass
+from datetime import datetime
+
+
+@dataclass
+class PouleRencontreItemModel:
+    id: str
+    numero: str
+    numeroJournee: str
+    idPoule: str
+    competitionId: str
+    resultatEquipe1: str
+    resultatEquipe2: str
+    joue: int
+    nomEquipe1: str
+    nomEquipe2: str
+    date_rencontre: datetime
+
+    @property
+    def team1_name(self) -> str:
+        """Alias for nomEquipe1."""
+        return self.nomEquipe1
+
+    @property
+    def equipe_locale(self) -> str:
+        """Alias for nomEquipe1."""
+        return self.nomEquipe1
+
+    @property
+    def team2_name(self) -> str:
+        """Alias for nomEquipe2."""
+        return self.nomEquipe2
+
+    @property
+    def equipe_visiteuse(self) -> str:
+        """Alias for nomEquipe2."""
+        return self.nomEquipe2
+
+    @property
+    def score1(self) -> str:
+        """Alias for resultatEquipe1."""
+        return self.resultatEquipe1
+
+    @property
+    def score2(self) -> str:
+        """Alias for resultatEquipe2."""
+        return self.resultatEquipe2
+
+    @property
+    def poule_id(self) -> str:
+        """Alias for idPoule."""
+        return self.idPoule
+
+    @property
+    def match_number(self) -> str:
+        """Alias for numero."""
+        return self.numero
+
+    @property
+    def round_number(self) -> str:
+        """Alias for numeroJournee."""
+        return self.numeroJournee
+
+    @property
+    def is_played(self) -> bool:
+        """Returns True if the match has been played."""
+        return bool(self.joue)

ffbb_data_client/models/poules_models.py

@@ -0,0 +1,6 @@
+"""Backward-compatibility re-export shim for poules models."""
+
+from .get_poule_response import GetPouleResponse
+from .poules_query import PoulesQuery
+
+__all__ = ["GetPouleResponse", "PoulesQuery"]

ffbb_data_client/models/poules_query.py

@@ -0,0 +1,9 @@
+from __future__ import annotations
+
+from dataclasses import dataclass, field
+
+
+@dataclass
+class PoulesQuery:
+    deep_rencontres__limit: str | None = "1000"  # Original: deep[rencontres][_limit]
+    fields_: list[str] | None = field(default=None)  # Original: fields[]

ffbb_data_client/models/pratique.py

@@ -0,0 +1,7 @@
+from enum import Enum
+
+
+class Pratique(Enum):
+    THE_3_X3 = "3x3"
+    THE_5_X5 = "5x5"
+    HANDISPORT = "Handisport"