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

ffbb_api_client_v3/__init__.py

@@ -0,0 +1,25 @@
+"""
+Backward-compatibility shim for ffbb_api_client_v3.
+
+This package has been renamed to ``ffbb_data_client``.
+Update your imports::
+
+    # Old (deprecated)
+    from ffbb_api_client_v3 import FFBBAPIClientV3
+
+    # New
+    from ffbb_data_client import FFBBDataClient
+"""
+
+import warnings  # noqa: E402
+
+from ffbb_data_client import FFBBDataClient as FFBBAPIClientV3  # noqa: E402, F401
+from ffbb_data_client import *  # noqa: E402, F401, F403
+from ffbb_data_client import __all__, __version__  # noqa: E402, F401
+
+warnings.warn(
+    "The 'ffbb_api_client_v3' package has been renamed to 'ffbb_data_client'. "
+    "Please update your imports. This shim will be removed in a future release.",
+    DeprecationWarning,
+    stacklevel=2,
+)

ffbb_data_client/__init__.py

@@ -0,0 +1,175 @@
+"""
+FFBB Data Client.
+
+A Python client library for the French Basketball Federation (FFBB) API,
+providing access to clubs, competitions, matches, and other basketball data.
+"""
+
+from .clients.api_ffbb_app_client import ApiFFBBAppClient
+from .clients.ffbb_data_client import FFBBDataClient
+from .clients.meilisearch_client import MeilisearchClient
+from .clients.meilisearch_ffbb_client import MeilisearchFFBBClient
+from .helpers.meilisearch_client_extension import MeilisearchClientExtension
+from .helpers.multi_search_query_helper import generate_queries
+from .models.club_contacts import ClubContacts
+from .models.competitions_facet_distribution import CompetitionsFacetDistribution
+from .models.competitions_facet_stats import CompetitionsFacetStats
+from .models.competitions_hit import CompetitionsHit
+from .models.contact_info import ContactInfo
+from .models.engagement_contacts import EngagementContacts
+from .models.engagements_facet_distribution import EngagementsFacetDistribution
+from .models.engagements_facet_stats import EngagementsFacetStats
+from .models.engagements_hit import EngagementsHit
+from .models.field_set import FieldSet
+from .models.formations_facet_distribution import FormationsFacetDistribution
+from .models.formations_facet_stats import FormationsFacetStats
+from .models.formations_hit import FormationsHit
+from .models.generic_search import (
+    GaleriesMultiSearchResult,
+    GenericSearchHit,
+    NewsMultiSearchResult,
+    RssMultiSearchResult,
+    YoutubeVideosMultiSearchResult,
+)
+from .models.get_competition_response import GetCompetitionResponse
+from .models.get_organisme_response import GetOrganismeResponse
+from .models.multi_search_query import MultiSearchQuery
+from .models.multi_search_result_competitions import CompetitionsMultiSearchResult
+from .models.multi_search_result_engagements import EngagementsMultiSearchResult
+from .models.multi_search_result_formations import FormationsMultiSearchResult
+from .models.multi_search_result_organismes import OrganismesMultiSearchResult
+from .models.multi_search_result_pratiques import PratiquesMultiSearchResult
+from .models.multi_search_result_rencontres import RencontresMultiSearchResult
+from .models.multi_search_result_salles import SallesMultiSearchResult
+from .models.multi_search_result_terrains import TerrainsMultiSearchResult
+from .models.multi_search_result_tournois import TournoisMultiSearchResult
+from .models.organismes_facet_distribution import OrganismesFacetDistribution
+from .models.organismes_facet_stats import OrganismesFacetStats
+from .models.organismes_hit import OrganismesHit
+from .models.poules_models import GetPouleResponse
+from .models.pratiques_facet_distribution import PratiquesFacetDistribution
+from .models.pratiques_facet_stats import PratiquesFacetStats
+from .models.pratiques_hit import PratiquesHit
+from .models.query_fields_manager import QueryFieldsManager
+from .models.rankings_models import RankingEngagement, TeamRanking
+from .models.rencontres_facet_distribution import RencontresFacetDistribution
+from .models.rencontres_facet_stats import RencontresFacetStats
+from .models.rencontres_hit import RencontresHit
+from .models.salles_facet_distribution import SallesFacetDistribution
+from .models.salles_facet_stats import SallesFacetStats
+from .models.salles_hit import SallesHit
+from .models.terrains_facet_distribution import TerrainsFacetDistribution
+from .models.terrains_facet_stats import TerrainsFacetStats
+from .models.terrains_hit import TerrainsHit
+from .models.tournois_facet_distribution import TournoisFacetDistribution
+from .models.tournois_facet_stats import TournoisFacetStats
+from .models.tournois_hit import TournoisHit
+from .utils.token_manager import FFBBTokens, TokenManager
+
+# Public API exports
+__all__ = [
+    # Clients
+    "ApiFFBBAppClient",
+    "FFBBDataClient",
+    "MeilisearchClient",
+    "MeilisearchFFBBClient",
+    # Helpers
+    "MeilisearchClientExtension",
+    "generate_queries",
+    "QueryFieldsManager",
+    # Query
+    "MultiSearchQuery",
+    "FieldSet",
+    # Responses
+    "GetCompetitionResponse",
+    "GetOrganismeResponse",
+    "ContactInfo",
+    "ClubContacts",
+    "EngagementContacts",
+    "GetPouleResponse",
+    # Rankings
+    "RankingEngagement",
+    "TeamRanking",
+    # Competitions
+    "CompetitionsFacetDistribution",
+    "CompetitionsFacetStats",
+    "CompetitionsHit",
+    "CompetitionsMultiSearchResult",
+    # Engagements
+    "EngagementsFacetDistribution",
+    "EngagementsFacetStats",
+    "EngagementsHit",
+    "EngagementsMultiSearchResult",
+    # Formations
+    "FormationsFacetDistribution",
+    "FormationsFacetStats",
+    "FormationsHit",
+    "FormationsMultiSearchResult",
+    # Content indexes
+    "GenericSearchHit",
+    "NewsMultiSearchResult",
+    "YoutubeVideosMultiSearchResult",
+    "RssMultiSearchResult",
+    "GaleriesMultiSearchResult",
+    # Organismes
+    "OrganismesFacetDistribution",
+    "OrganismesFacetStats",
+    "OrganismesHit",
+    "OrganismesMultiSearchResult",
+    # Pratiques
+    "PratiquesFacetDistribution",
+    "PratiquesFacetStats",
+    "PratiquesHit",
+    "PratiquesMultiSearchResult",
+    # Rencontres
+    "RencontresFacetDistribution",
+    "RencontresFacetStats",
+    "RencontresHit",
+    "RencontresMultiSearchResult",
+    # Salles
+    "SallesFacetDistribution",
+    "SallesFacetStats",
+    "SallesHit",
+    "SallesMultiSearchResult",
+    # Terrains
+    "TerrainsFacetDistribution",
+    "TerrainsFacetStats",
+    "TerrainsHit",
+    "TerrainsMultiSearchResult",
+    # Tournois
+    "TournoisFacetDistribution",
+    "TournoisFacetStats",
+    "TournoisHit",
+    "TournoisMultiSearchResult",
+    # Token management
+    "FFBBTokens",
+    "TokenManager",
+]
+
+from importlib.metadata import PackageNotFoundError, version
+
+try:
+    DIST_NAME = __name__
+    __version__ = version(DIST_NAME)
+except PackageNotFoundError:
+    __version__ = "unknown"
+finally:
+    del version, PackageNotFoundError
+
+
+# ---------------------------------------------------------------------------
+# Backward-compatibility alias (deprecated)
+# ---------------------------------------------------------------------------
+import warnings as _warnings
+
+
+def __getattr__(name: str):
+    if name == "FFBBAPIClientV3":
+        _warnings.warn(
+            "FFBBAPIClientV3 has been renamed to FFBBDataClient. "
+            "Update your imports: from ffbb_data_client import FFBBDataClient",
+            DeprecationWarning,
+            stacklevel=2,
+        )
+        return FFBBDataClient
+    raise AttributeError(f"module {__name__!r} has no attribute {name!r}")

ffbb_data_client/clients/__init__.py

@@ -0,0 +1,13 @@
+"""Client classes for FFBB API interactions."""
+
+from .api_ffbb_app_client import ApiFFBBAppClient
+from .ffbb_data_client import FFBBDataClient
+from .meilisearch_client import MeilisearchClient
+from .meilisearch_ffbb_client import MeilisearchFFBBClient
+
+__all__ = [
+    "ApiFFBBAppClient",
+    "FFBBDataClient",
+    "MeilisearchClient",
+    "MeilisearchFFBBClient",
+]