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

ffbb_data_client/models/club_contacts.py

@@ -0,0 +1,77 @@
+from __future__ import annotations
+
+from collections.abc import Iterable
+from dataclasses import dataclass, field
+
+from .contact_info import ContactInfo
+from .get_organisme_response import GetOrganismeResponse
+
+
+def _normalize_phone(raw: str | None) -> str | None:
+    if not raw:
+        return None
+    return str(raw).strip()
+
+
+def _sanitize_name(name: str | None) -> str | None:
+    return name.strip().title() if name else None
+
+
+@dataclass
+class ClubContacts:
+    """Contacts for a club: extracted club-level contact + members (dirigeants).
+
+    `organisme` is kept for callers who want the original source object.
+    """
+
+    organisme: GetOrganismeResponse
+    club_contact: ContactInfo | None
+    membres: list[ContactInfo] = field(default_factory=list)
+
+
+def extract_club_info(organisme: GetOrganismeResponse) -> ContactInfo | None:
+    """Extract club-level contact info (phone / mail) from an organisme."""
+    phone = _normalize_phone(getattr(organisme, "telephone", None))
+    email = getattr(organisme, "mail", None) or None
+    if not phone and not email:
+        return None
+    return ContactInfo(
+        nom=getattr(organisme, "nom", None),
+        prenom=None,
+        telephone=phone,
+        email=email,
+        role="club",
+    )
+
+
+def extract_membres_contacts(organisme: GetOrganismeResponse) -> list[ContactInfo]:
+    """Extract contacts from the `membres` list on an organisme.
+
+    This is defensive: it accepts multiple possible attribute names used by
+    different model versions (camelCase or snake_case) and falls back to
+    reasonable defaults.
+    """
+    contacts: list[ContactInfo] = []
+    membres: Iterable = getattr(organisme, "membres", []) or []
+    for membre in membres:
+        phone = _normalize_phone(
+            getattr(membre, "telephonePortable", None)
+            or getattr(membre, "telephone_portable", None)
+            or getattr(membre, "telephoneFixe", None)
+            or getattr(membre, "telephone_fixe", None)
+        )
+        email = getattr(membre, "mail", None) or None
+        if not phone and not email:
+            continue
+        contacts.append(
+            ContactInfo(
+                nom=_sanitize_name(getattr(membre, "nom", None)),
+                prenom=_sanitize_name(getattr(membre, "prenom", None)),
+                telephone=phone,
+                email=email,
+                role=getattr(membre, "codeFonction", None)
+                or getattr(membre, "code_fonction", None)
+                or "membre",
+            )
+        )
+    return contacts

ffbb_data_client/models/code.py

@@ -0,0 +1,7 @@
+from enum import Enum
+
+
+class Code(Enum):
+    BIT = "BIT"
+    BT = "BT"
+    SS = "SS"

ffbb_data_client/models/commune.py

@@ -0,0 +1,66 @@
+from __future__ import annotations
+
+from dataclasses import dataclass, field
+from datetime import datetime
+from typing import Any
+
+from ..utils.converter_utils import (
+    from_datetime,
+    from_int,
+    from_str,
+)
+
+
+@dataclass
+class Commune:
+    code_insee: str | None = None
+    code_postal: str | None = None
+    date_created: datetime | None = None
+    date_updated: datetime | None = None
+    commune_id: str | None = None
+    libelle: str | None = None
+    departement: str | None = None
+    lower_libelle: str | None = field(init=False, default=None, repr=False)
+    lower_departement: str | None = field(init=False, default=None, repr=False)
+
+    def __post_init__(self) -> None:
+        self.lower_libelle = self.libelle.lower() if self.libelle else None
+        self.lower_departement = self.departement.lower() if self.departement else None
+
+    @staticmethod
+    def from_dict(obj: Any) -> Commune:
+        assert isinstance(obj, dict)
+        code_insee = from_str(obj, "codeInsee")
+        code_postal = from_str(obj, "codePostal")
+        date_created = from_datetime(obj, "date_created")
+        date_updated = from_datetime(obj, "date_updated")
+        commune_id = from_int(obj, "id")
+        libelle = from_str(obj, "libelle")
+        departement = from_str(obj, "departement")
+        return Commune(
+            code_insee=code_insee,
+            code_postal=code_postal,
+            date_created=date_created,
+            date_updated=date_updated,
+            commune_id=commune_id,
+            libelle=libelle,
+            departement=departement,
+        )
+
+    def to_dict(self) -> dict:
+        result: dict = {}
+        if self.code_insee is not None:
+            result["codeInsee"] = self.code_insee
+        if self.code_postal is not None:
+            result["codePostal"] = self.code_postal
+        if self.date_created is not None:
+            result["date_created"] = self.date_created.isoformat()
+        if self.date_updated is not None:
+            result["date_updated"] = self.date_updated.isoformat()
+        if self.commune_id is not None:
+            result["id"] = str(self.commune_id)
+        if self.libelle is not None:
+            result["libelle"] = self.libelle
+        if self.departement is not None:
+            result["departement"] = self.departement
+        return result

ffbb_data_client/models/competition_fields.py

@@ -0,0 +1,309 @@
+class CompetitionFields:
+    """Default fields for competition queries."""
+
+    # Basic fields
+    ID = "id"
+    NOM = "nom"
+    SEXE = "sexe"
+    SAISON = "saison"
+    CODE = "code"
+    TYPE_COMPETITION = "typeCompetition"
+    LIVE_STAT = "liveStat"
+    COMPETITION_ORIGINE = "competition_origine"
+    COMPETITION_ORIGINE_NOM = "competition_origine_nom"
+
+    # Categorie fields
+    CATEGORIE_CODE = "categorie.code"
+    CATEGORIE_ORDRE = "categorie.ordre"
+
+    # Logo fields
+    LOGO_ID = "logo.id"
+    LOGO_GRADIENT_COLOR = "logo.gradient_color"
+    TYPE_COMPETITION_GENERIQUE_LOGO_ID = "typeCompetitionGenerique.logo.id"
+    TYPE_COMPETITION_GENERIQUE_LOGO_GRADIENT_COLOR = (
+        "typeCompetitionGenerique.logo.gradient_color"
+    )
+
+    # Other fields
+    PUBLICATION_INTERNET = "publicationInternet"
+    POULES_ID = "poules.id"
+    POULES_NOM = "poules.nom"
+
+    # Phases fields (additional)
+    PHASES_LIVE_STAT = "phases.liveStat"
+    PHASES_PHASE_CODE = "phases.phase_code"
+
+    # Additional rencontres fields
+    PHASES_POULES_RENCONTRES_NUMERO_JOURNEE = "phases.poules.rencontres.numeroJournee"
+    PHASES_POULES_RENCONTRES_ID_POULE = "phases.poules.rencontres.idPoule"
+    PHASES_POULES_RENCONTRES_COMPETITION_ID = "phases.poules.rencontres.competitionId"
+    PHASES_POULES_RENCONTRES_RESULTAT_EQUIPE1 = (
+        "phases.poules.rencontres.resultatEquipe1"
+    )
+    PHASES_POULES_RENCONTRES_RESULTAT_EQUIPE2 = (
+        "phases.poules.rencontres.resultatEquipe2"
+    )
+    PHASES_POULES_RENCONTRES_JOUE = "phases.poules.rencontres.joue"
+    PHASES_POULES_RENCONTRES_NOM_EQUIPE1 = "phases.poules.rencontres.nomEquipe1"
+    PHASES_POULES_RENCONTRES_NOM_EQUIPE2 = "phases.poules.rencontres.nomEquipe2"
+
+    # Engagements fields
+    PHASES_POULES_ENGAGEMENTS_ID = "phases.poules.engagements.id"
+    PHASES_POULES_ENGAGEMENTS_ID_ORGANISME_ID = (
+        "phases.poules.engagements.idOrganisme.id"
+    )
+
+    # Phases fields
+    PHASES_ID = "phases.id"
+    PHASES_NOM = "phases.nom"
+
+    # Poules fields (nested in phases)
+    PHASES_POULES_ID = "phases.poules.id"
+    PHASES_POULES_NOM = "phases.poules.nom"
+
+    # Rencontres fields (nested in poules)
+    PHASES_POULES_RENCONTRES_ID = "phases.poules.rencontres.id"
+    PHASES_POULES_RENCONTRES_NUMERO = "phases.poules.rencontres.numero"
+    PHASES_POULES_RENCONTRES_DATE = "phases.poules.rencontres.date_rencontre"
+
+    # GameStats fields (nested in rencontres)
+    PHASES_POULES_RENCONTRES_GSID_MATCH_ID = "phases.poules.rencontres.gsId.matchId"
+    PHASES_POULES_RENCONTRES_GSID_CURRENT_STATUS = (
+        "phases.poules.rencontres.gsId.currentStatus"
+    )
+    PHASES_POULES_RENCONTRES_GSID_CURRENT_PERIOD = (
+        "phases.poules.rencontres.gsId.currentPeriod"
+    )
+    PHASES_POULES_RENCONTRES_GSID_SCORE_Q1_HOME = (
+        "phases.poules.rencontres.gsId.score_q1_home"
+    )
+    PHASES_POULES_RENCONTRES_GSID_SCORE_Q2_HOME = (
+        "phases.poules.rencontres.gsId.score_q2_home"
+    )
+    PHASES_POULES_RENCONTRES_GSID_SCORE_Q3_HOME = (
+        "phases.poules.rencontres.gsId.score_q3_home"
+    )
+    PHASES_POULES_RENCONTRES_GSID_SCORE_Q4_HOME = (
+        "phases.poules.rencontres.gsId.score_q4_home"
+    )
+    PHASES_POULES_RENCONTRES_GSID_SCORE_OT1_HOME = (
+        "phases.poules.rencontres.gsId.score_ot1_home"
+    )
+    PHASES_POULES_RENCONTRES_GSID_SCORE_OT2_HOME = (
+        "phases.poules.rencontres.gsId.score_ot2_home"
+    )
+    PHASES_POULES_RENCONTRES_GSID_SCORE_Q1_OUT = (
+        "phases.poules.rencontres.gsId.score_q1_out"
+    )
+    PHASES_POULES_RENCONTRES_GSID_SCORE_Q2_OUT = (
+        "phases.poules.rencontres.gsId.score_q2_out"
+    )
+    PHASES_POULES_RENCONTRES_GSID_SCORE_Q3_OUT = (
+        "phases.poules.rencontres.gsId.score_q3_out"
+    )
+    PHASES_POULES_RENCONTRES_GSID_SCORE_Q4_OUT = (
+        "phases.poules.rencontres.gsId.score_q4_out"
+    )
+    PHASES_POULES_RENCONTRES_GSID_SCORE_OT1_OUT = (
+        "phases.poules.rencontres.gsId.score_ot1_out"
+    )
+    PHASES_POULES_RENCONTRES_GSID_SCORE_OT2_OUT = (
+        "phases.poules.rencontres.gsId.score_ot2_out"
+    )
+
+    # Officiels fields (nested in rencontres)
+    PHASES_POULES_RENCONTRES_OFFICIELS_ORDRE = (
+        "phases.poules.rencontres.officiels.ordre"
+    )
+    PHASES_POULES_RENCONTRES_OFFICIELS_FONCTION_LIBELLE = (
+        "phases.poules.rencontres.officiels.fonction.libelle"
+    )
+    PHASES_POULES_RENCONTRES_OFFICIELS_OFFICIEL_NOM = (
+        "phases.poules.rencontres.officiels.officiel.nom"
+    )
+    PHASES_POULES_RENCONTRES_OFFICIELS_OFFICIEL_PRENOM = (
+        "phases.poules.rencontres.officiels.officiel.prenom"
+    )
+
+    # idOrganismeEquipe logo fields
+    PHASES_POULES_RENCONTRES_ID_ORGANISME_EQUIPE1_LOGO_ID = (
+        "phases.poules.rencontres.idOrganismeEquipe1.logo.id"
+    )
+    PHASES_POULES_RENCONTRES_ID_ORGANISME_EQUIPE2_LOGO_ID = (
+        "phases.poules.rencontres.idOrganismeEquipe2.logo.id"
+    )
+
+    # idEngagementEquipe1 fields (model: Idengagementequipe1Model)
+    PHASES_POULES_RENCONTRES_ID_ENGAGEMENT_EQUIPE1_ID = (
+        "phases.poules.rencontres.idEngagementEquipe1.id"
+    )
+    PHASES_POULES_RENCONTRES_ID_ENGAGEMENT_EQUIPE1_NOM = (
+        "phases.poules.rencontres.idEngagementEquipe1.nom"
+    )
+    PHASES_POULES_RENCONTRES_ID_ENGAGEMENT_EQUIPE1_NOM_OFFICIEL = (
+        "phases.poules.rencontres.idEngagementEquipe1.nomOfficiel"
+    )
+    PHASES_POULES_RENCONTRES_ID_ENGAGEMENT_EQUIPE1_NOM_USUEL = (
+        "phases.poules.rencontres.idEngagementEquipe1.nomUsuel"
+    )
+    PHASES_POULES_RENCONTRES_ID_ENGAGEMENT_EQUIPE1_CODE_ABREGE = (
+        "phases.poules.rencontres.idEngagementEquipe1.codeAbrege"
+    )
+    PHASES_POULES_RENCONTRES_ID_ENGAGEMENT_EQUIPE1_LOGO = (
+        "phases.poules.rencontres.idEngagementEquipe1.logo"
+    )
+
+    # idEngagementEquipe2 fields (model: Idengagementequipe2Model)
+    PHASES_POULES_RENCONTRES_ID_ENGAGEMENT_EQUIPE2_ID = (
+        "phases.poules.rencontres.idEngagementEquipe2.id"
+    )
+    PHASES_POULES_RENCONTRES_ID_ENGAGEMENT_EQUIPE2_NOM = (
+        "phases.poules.rencontres.idEngagementEquipe2.nom"
+    )
+    PHASES_POULES_RENCONTRES_ID_ENGAGEMENT_EQUIPE2_NOM_OFFICIEL = (
+        "phases.poules.rencontres.idEngagementEquipe2.nomOfficiel"
+    )
+    PHASES_POULES_RENCONTRES_ID_ENGAGEMENT_EQUIPE2_NOM_USUEL = (
+        "phases.poules.rencontres.idEngagementEquipe2.nomUsuel"
+    )
+    PHASES_POULES_RENCONTRES_ID_ENGAGEMENT_EQUIPE2_CODE_ABREGE = (
+        "phases.poules.rencontres.idEngagementEquipe2.codeAbrege"
+    )
+    PHASES_POULES_RENCONTRES_ID_ENGAGEMENT_EQUIPE2_LOGO = (
+        "phases.poules.rencontres.idEngagementEquipe2.logo"
+    )
+
+    # Salle in rencontres (model: SalleModel)
+    PHASES_POULES_RENCONTRES_SALLE_ID = "phases.poules.rencontres.salle.id"
+    PHASES_POULES_RENCONTRES_SALLE_NUMERO = "phases.poules.rencontres.salle.numero"
+    PHASES_POULES_RENCONTRES_SALLE_LIBELLE = "phases.poules.rencontres.salle.libelle"
+    PHASES_POULES_RENCONTRES_SALLE_LIBELLE2 = "phases.poules.rencontres.salle.libelle2"
+    PHASES_POULES_RENCONTRES_SALLE_ADRESSE = "phases.poules.rencontres.salle.adresse"
+    PHASES_POULES_RENCONTRES_SALLE_ADRESSE_COMPLEMENT = (
+        "phases.poules.rencontres.salle.adresseComplement"
+    )
+    PHASES_POULES_RENCONTRES_SALLE_COMMUNE_CP = (
+        "phases.poules.rencontres.salle.commune.codePostal"
+    )
+    PHASES_POULES_RENCONTRES_SALLE_COMMUNE_LIBELLE = (
+        "phases.poules.rencontres.salle.commune.libelle"
+    )
+    PHASES_POULES_RENCONTRES_SALLE_CARTO_LAT = (
+        "phases.poules.rencontres.salle.cartographie.latitude"
+    )
+    PHASES_POULES_RENCONTRES_SALLE_CARTO_LNG = (
+        "phases.poules.rencontres.salle.cartographie.longitude"
+    )
+
+    @classmethod
+    def get_default_fields(cls) -> list[str]:
+        """Get default fields for competition queries based on real API usage."""
+        return [
+            # Basic competition fields
+            cls.ID,
+            cls.NOM,
+            cls.SEXE,
+            cls.CATEGORIE_CODE,
+            cls.CATEGORIE_ORDRE,
+            cls.SAISON,
+            cls.CODE,
+            cls.TYPE_COMPETITION,
+            cls.LIVE_STAT,
+            cls.COMPETITION_ORIGINE,
+            cls.COMPETITION_ORIGINE_NOM,
+            cls.TYPE_COMPETITION_GENERIQUE_LOGO_ID,
+            cls.TYPE_COMPETITION_GENERIQUE_LOGO_GRADIENT_COLOR,
+            cls.LOGO_ID,
+            cls.LOGO_GRADIENT_COLOR,
+            cls.POULES_ID,
+            cls.POULES_NOM,
+            cls.PUBLICATION_INTERNET,
+            # Phases fields
+            cls.PHASES_ID,
+            cls.PHASES_NOM,
+            cls.PHASES_LIVE_STAT,
+            cls.PHASES_PHASE_CODE,
+            # Phases > Poules fields
+            cls.PHASES_POULES_ID,
+            cls.PHASES_POULES_NOM,
+            # Phases > Poules > Rencontres essential fields
+            cls.PHASES_POULES_RENCONTRES_ID,
+            cls.PHASES_POULES_RENCONTRES_NUMERO,
+            cls.PHASES_POULES_RENCONTRES_NUMERO_JOURNEE,
+            cls.PHASES_POULES_RENCONTRES_ID_POULE,
+            cls.PHASES_POULES_RENCONTRES_COMPETITION_ID,
+            cls.PHASES_POULES_RENCONTRES_RESULTAT_EQUIPE1,
+            cls.PHASES_POULES_RENCONTRES_RESULTAT_EQUIPE2,
+            cls.PHASES_POULES_RENCONTRES_JOUE,
+            cls.PHASES_POULES_RENCONTRES_NOM_EQUIPE1,
+            cls.PHASES_POULES_RENCONTRES_NOM_EQUIPE2,
+            cls.PHASES_POULES_RENCONTRES_DATE,
+            # Phases > Poules > Engagements
+            cls.PHASES_POULES_ENGAGEMENTS_ID,
+            cls.PHASES_POULES_ENGAGEMENTS_ID_ORGANISME_ID,
+            # idOrganismeEquipe logo
+            cls.PHASES_POULES_RENCONTRES_ID_ORGANISME_EQUIPE1_LOGO_ID,
+            cls.PHASES_POULES_RENCONTRES_ID_ORGANISME_EQUIPE2_LOGO_ID,
+            # idEngagementEquipe1
+            cls.PHASES_POULES_RENCONTRES_ID_ENGAGEMENT_EQUIPE1_ID,
+            cls.PHASES_POULES_RENCONTRES_ID_ENGAGEMENT_EQUIPE1_NOM,
+            cls.PHASES_POULES_RENCONTRES_ID_ENGAGEMENT_EQUIPE1_NOM_OFFICIEL,
+            cls.PHASES_POULES_RENCONTRES_ID_ENGAGEMENT_EQUIPE1_NOM_USUEL,
+            cls.PHASES_POULES_RENCONTRES_ID_ENGAGEMENT_EQUIPE1_CODE_ABREGE,
+            cls.PHASES_POULES_RENCONTRES_ID_ENGAGEMENT_EQUIPE1_LOGO,
+            # idEngagementEquipe2
+            cls.PHASES_POULES_RENCONTRES_ID_ENGAGEMENT_EQUIPE2_ID,
+            cls.PHASES_POULES_RENCONTRES_ID_ENGAGEMENT_EQUIPE2_NOM,
+            cls.PHASES_POULES_RENCONTRES_ID_ENGAGEMENT_EQUIPE2_NOM_OFFICIEL,
+            cls.PHASES_POULES_RENCONTRES_ID_ENGAGEMENT_EQUIPE2_NOM_USUEL,
+            cls.PHASES_POULES_RENCONTRES_ID_ENGAGEMENT_EQUIPE2_CODE_ABREGE,
+            cls.PHASES_POULES_RENCONTRES_ID_ENGAGEMENT_EQUIPE2_LOGO,
+            # Salle in rencontres
+            cls.PHASES_POULES_RENCONTRES_SALLE_ID,
+            cls.PHASES_POULES_RENCONTRES_SALLE_NUMERO,
+            cls.PHASES_POULES_RENCONTRES_SALLE_LIBELLE,
+            cls.PHASES_POULES_RENCONTRES_SALLE_LIBELLE2,
+            cls.PHASES_POULES_RENCONTRES_SALLE_ADRESSE,
+            cls.PHASES_POULES_RENCONTRES_SALLE_ADRESSE_COMPLEMENT,
+            cls.PHASES_POULES_RENCONTRES_SALLE_COMMUNE_CP,
+            cls.PHASES_POULES_RENCONTRES_SALLE_COMMUNE_LIBELLE,
+            cls.PHASES_POULES_RENCONTRES_SALLE_CARTO_LAT,
+            cls.PHASES_POULES_RENCONTRES_SALLE_CARTO_LNG,
+            # GameStats fields for live match data
+            cls.PHASES_POULES_RENCONTRES_GSID_MATCH_ID,
+            cls.PHASES_POULES_RENCONTRES_GSID_CURRENT_STATUS,
+            cls.PHASES_POULES_RENCONTRES_GSID_CURRENT_PERIOD,
+            cls.PHASES_POULES_RENCONTRES_GSID_SCORE_Q1_HOME,
+            cls.PHASES_POULES_RENCONTRES_GSID_SCORE_Q2_HOME,
+            cls.PHASES_POULES_RENCONTRES_GSID_SCORE_Q3_HOME,
+            cls.PHASES_POULES_RENCONTRES_GSID_SCORE_Q4_HOME,
+            cls.PHASES_POULES_RENCONTRES_GSID_SCORE_OT1_HOME,
+            cls.PHASES_POULES_RENCONTRES_GSID_SCORE_OT2_HOME,
+            cls.PHASES_POULES_RENCONTRES_GSID_SCORE_Q1_OUT,
+            cls.PHASES_POULES_RENCONTRES_GSID_SCORE_Q2_OUT,
+            cls.PHASES_POULES_RENCONTRES_GSID_SCORE_Q3_OUT,
+            cls.PHASES_POULES_RENCONTRES_GSID_SCORE_Q4_OUT,
+            cls.PHASES_POULES_RENCONTRES_GSID_SCORE_OT1_OUT,
+            cls.PHASES_POULES_RENCONTRES_GSID_SCORE_OT2_OUT,
+            # Officiels fields
+            cls.PHASES_POULES_RENCONTRES_OFFICIELS_ORDRE,
+            cls.PHASES_POULES_RENCONTRES_OFFICIELS_FONCTION_LIBELLE,
+            cls.PHASES_POULES_RENCONTRES_OFFICIELS_OFFICIEL_NOM,
+            cls.PHASES_POULES_RENCONTRES_OFFICIELS_OFFICIEL_PRENOM,
+        ]
+
+    @classmethod
+    def get_basic_fields(cls) -> list[str]:
+        """Get basic fields for simple competition queries."""
+        return [
+            cls.ID,
+            cls.NOM,
+            cls.SEXE,
+            cls.SAISON,
+            cls.CODE,
+        ]
+
+    @classmethod
+    def get_detailed_fields(cls) -> list[str]:
+        """Get detailed fields (all fields now included in default)."""
+        return cls.get_default_fields()

ffbb_data_client/models/competition_id.py

@@ -0,0 +1,116 @@
+from __future__ import annotations
+
+from dataclasses import dataclass
+from typing import Any
+
+from ..utils.converter_utils import (
+    from_bool,
+    from_obj,
+    from_str,
+)
+from .competition_id_categorie import CompetitionIDCategorie
+from .competition_id_type_competition_generique import (
+    CompetitionIDTypeCompetitionGenerique,
+)
+from .competition_origine import CompetitionOrigine
+from .logo import Logo
+
+
+@dataclass
+class CompetitionID:
+    id: str | None = None
+    nom: str | None = None
+    competition_origine_nom: str | None = None
+    code: str | None = None
+    creation_en_cours: bool | None = None
+    live_stat: bool | None = None
+    publication_internet: str | None = None
+    sexe: str | None = None
+    type_competition: str | None = None
+    pro: bool | None = None
+    logo: Logo | None = None
+    categorie: CompetitionIDCategorie | None = None
+    type_competition_generique: CompetitionIDTypeCompetitionGenerique | None = None
+    competition_origine: CompetitionOrigine | None = None
+    nom_extended: str | None = None
+
+    @staticmethod
+    def from_dict(obj: Any) -> CompetitionID:
+        try:
+            assert isinstance(obj, dict)
+            id = from_str(obj, "id")
+            nom = from_str(obj, "nom")
+            competition_origine_nom = from_str(obj, "competition_origine_nom")
+            code = from_str(obj, "code")
+            creation_en_cours = from_bool(obj, "creationEnCours")
+            live_stat = from_bool(obj, "liveStat")
+            publication_internet = from_str(obj, "publicationInternet")
+            sexe = from_str(obj, "sexe")
+            type_competition = from_str(obj, "typeCompetition")
+            pro = from_bool(obj, "pro")
+            logo = from_obj(Logo.from_dict, obj, "logo")
+            categorie = from_obj(CompetitionIDCategorie.from_dict, obj, "categorie")
+            type_competition_generique = from_obj(
+                CompetitionIDTypeCompetitionGenerique.from_dict,
+                obj,
+                "typeCompetitionGenerique",
+            )
+            competition_origine = from_obj(
+                CompetitionOrigine.from_dict, obj, "competition_origine"
+            )
+            nom_extended = from_str(obj, "nomExtended")
+            return CompetitionID(
+                id=id,
+                nom=nom,
+                competition_origine_nom=competition_origine_nom,
+                code=code,
+                creation_en_cours=creation_en_cours,
+                live_stat=live_stat,
+                publication_internet=publication_internet,
+                sexe=sexe,
+                type_competition=type_competition,
+                pro=pro,
+                logo=logo,
+                categorie=categorie,
+                type_competition_generique=type_competition_generique,
+                competition_origine=competition_origine,
+                nom_extended=nom_extended,
+            )
+        except Exception as e:
+            raise ValueError("Invalid CompetitionID object") from e
+
+    def to_dict(self) -> dict:
+        result: dict = {}
+        if self.id is not None:
+            result["id"] = self.id
+        if self.nom is not None:
+            result["nom"] = self.nom
+        if self.competition_origine_nom is not None:
+            result["competition_origine_nom"] = self.competition_origine_nom
+        if self.code is not None:
+            result["code"] = self.code
+        if self.creation_en_cours is not None:
+            result["creationEnCours"] = self.creation_en_cours
+        if self.live_stat is not None:
+            result["liveStat"] = self.live_stat
+        if self.publication_internet is not None:
+            result["publicationInternet"] = self.publication_internet
+        if self.sexe is not None:
+            result["sexe"] = self.sexe
+        if self.type_competition is not None:
+            result["typeCompetition"] = self.type_competition
+        if self.pro is not None:
+            result["pro"] = self.pro
+        if self.logo is not None:
+            result["logo"] = self.logo.to_dict()
+        if self.categorie is not None:
+            result["categorie"] = self.categorie.to_dict()
+        if self.type_competition_generique is not None:
+            result["typeCompetitionGenerique"] = (
+                self.type_competition_generique.to_dict()
+            )
+        if self.competition_origine is not None:
+            result["competition_origine"] = self.competition_origine.to_dict()
+        if self.nom_extended is not None:
+            result["nomExtended"] = self.nom_extended
+        return result

ffbb_data_client/models/competition_id_categorie.py

@@ -0,0 +1,31 @@
+from __future__ import annotations
+
+from dataclasses import dataclass
+from typing import Any
+
+from ..utils.converter_utils import from_int, from_str
+
+
+@dataclass
+class CompetitionIDCategorie:
+    code: str | None = None
+    libelle: str | None = None
+    ordre: int | None = None
+
+    @staticmethod
+    def from_dict(obj: Any) -> CompetitionIDCategorie:
+        assert isinstance(obj, dict)
+        code = from_str(obj, "code")
+        libelle = from_str(obj, "libelle")
+        ordre = from_int(obj, "ordre")
+        return CompetitionIDCategorie(code=code, libelle=libelle, ordre=ordre)
+
+    def to_dict(self) -> dict:
+        result: dict = {}
+        if self.code is not None:
+            result["code"] = self.code
+        if self.libelle is not None:
+            result["libelle"] = self.libelle
+        if self.ordre is not None:
+            result["ordre"] = self.ordre
+        return result

ffbb_data_client/models/competition_id_sexe.py

@@ -0,0 +1,31 @@
+from __future__ import annotations
+
+from dataclasses import dataclass
+from typing import Any
+
+from ..utils.converter_utils import from_int
+
+
+@dataclass
+class CompetitionIDSexe:
+    feminine: int | None = None
+    masculine: int | None = None
+    mixed: int | None = None
+
+    @staticmethod
+    def from_dict(obj: Any) -> CompetitionIDSexe:
+        assert isinstance(obj, dict)
+        feminine = from_int(obj, "Féminin")
+        masculine = from_int(obj, "Masculin")
+        mixed = from_int(obj, "Mixte")
+        return CompetitionIDSexe(feminine=feminine, masculine=masculine, mixed=mixed)
+
+    def to_dict(self) -> dict:
+        result: dict = {}
+        if self.feminine is not None:
+            result["Féminin"] = self.feminine
+        if self.masculine is not None:
+            result["Masculin"] = self.masculine
+        if self.mixed is not None:
+            result["Mixte"] = self.mixed
+        return result

ffbb_data_client/models/competition_id_type_competition.py

@@ -0,0 +1,27 @@
+from __future__ import annotations
+
+from dataclasses import dataclass
+from typing import Any
+
+from ..utils.converter_utils import from_int
+
+
+@dataclass
+class CompetitionIDTypeCompetition:
+    championnat: int | None = None
+    coupe: int | None = None
+
+    @staticmethod
+    def from_dict(obj: Any) -> CompetitionIDTypeCompetition:
+        assert isinstance(obj, dict)
+        championnat = from_int(obj, "Championnat")
+        coupe = from_int(obj, "Coupe")
+        return CompetitionIDTypeCompetition(championnat=championnat, coupe=coupe)
+
+    def to_dict(self) -> dict:
+        result: dict = {}
+        if self.championnat is not None:
+            result["Championnat"] = self.championnat
+        if self.coupe is not None:
+            result["Coupe"] = self.coupe
+        return result