ffbb-data-client 2.3.4__tar.gz → 2.4.0__tar.gz

{ffbb_data_client-2.3.4 → ffbb_data_client-2.4.0}/AGENTS.md

@@ -1,8 +1,8 @@
 # FFBB Data Client SDK
 
 > ⚠️ **Fichier auto-généré** par `tools/update_agents_md.py` — ne pas modifier manuellement.
-> Dernière mise à jour : ffbb-data-client | SDK total : ~19030 lignes de code
-> (clients: 6227, models: 9878, utils: 1954, helpers: 971)
+> Dernière mise à jour : ffbb-data-client | SDK total : ~18803 lignes de code
+> (clients: 5980, models: 9805, utils: 2003, helpers: 1015)
 
 ## Langue
 Tous les documents de travail (walkthrough.md, implementation_plan.md) DOIVENT être en français.
@@ -69,17 +69,19 @@ Ces directives inspirées d'Andrej Karpathy visent à éliminer les erreurs de c
 ```
 src/ffbb_data_client/
 ├── __init__.py            # Point d'entrée du SDK, expose FFBBDataClient et FFBBTokens
-├── clients/               # Clients d'API (REST et Meilisearch) et façades (≈6227 lignes)
+├── clients/               # Clients d'API (REST et Meilisearch) et façades (≈5980 lignes)
 ├── config.py              # Configuration centralisée (URLs, Headers, Endpoints, Facettes)
 ├── data/                  # Ressources et données statiques
-├── helpers/               # Méthodes utilitaires pour requêtes HTTP et mapping (≈971 lignes)
-├── models/                # Modèles de données Pydantic type-safe (≈9878 lignes)
+├── helpers/               # Méthodes utilitaires pour requêtes HTTP et mapping (≈1015 lignes)
+├── models/                # Modèles de données Pydantic type-safe (≈9805 lignes)
 ├── py.typed               # Marqueur pour la compatibilité avec mypy
-└── utils/                 # Gestionnaires transversaux (cache, jetons de sécurité, validation) (≈1954 lignes)
+└── utils/                 # Gestionnaires transversaux (cache, jetons de sécurité, validation) (≈2003 lignes)
 ```
 
 ## Conventions de code
 - **Modèles Pydantic** : Tous les modèles héritent de `pydantic.BaseModel` et fournissent une validation stricte.
+  Chaque modèle possède son propre fichier source dédié en `snake_case` (ex: `categorie_type.py`, `niveau_info.py`).
+  Les imports internes et dans les tests doivent cibler précisément le fichier dédié ou le namespace racine `models`.
 - **Async/Sync en parallèle** : Le SDK implémente systématiquement la double interface synchrone (`get_x`)
   et asynchrone (`get_x_async`) pour un maximum de flexibilité d'intégration.
 - **Cache HTTP** : Utilisation d'`hishel` pour le cache de requêtes HTTP asynchrones et d'un cache local
@@ -101,3 +103,7 @@ Avant push/tag/release :
 2. `rtk ruff check .`
 3. `rtk mypy src`
 4. `rtk pytest`
+5. `rtk pre-commit run --all-files`
+
+⚠️ Note Release PyPI : Les releases sur PyPI sont immuables. Ne jamais réassigner ou forcer un tag
+déjà publié sur PyPI. Tout correctif requiert un bump de version (ex: v2.3.6).

{ffbb_data_client-2.3.4 → ffbb_data_client-2.4.0}/CHANGELOG.md

@@ -7,6 +7,17 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [2.4.0] - 2026-08-29
+
+### Added
+- **Serveur FastAPI & REST API**: Serveur FastAPI intégré avec support CORS, documentation OpenAPI/Swagger et routes optimisées pour les matchs de clubs.
+- **Résolution d'adresses précises des salles**: Résolution automatique de l'adresse de voirie exacte des gymnases pour l'ensemble des rencontres (domicile & extérieur).
+- **Gestion du cycle de vie async (`aclose`)**: Support natif de la fermeture asynchrone des sessions et mutualisation des pools de connexions HTTP.
+
+### Fixed & Maintenance
+- **Imports des modèles**: Correction des chemins d'accès aux modèles `CategorieType` et `Niveau`.
+- **Conventions d'architecture**: Documentation des règles d'immutabilité des packages PyPI et des directives d'imports de modèles dans `AGENTS.md`.
+
 ## [2.3.4] - 2026-08-19
 
 ### Fixed

ffbb_data_client-2.4.0/Dockerfile

@@ -0,0 +1,37 @@
+# Multi-stage Dockerfile for FFBB Data Client API & Web Server
+FROM python:3.12-slim AS builder
+
+WORKDIR /app
+
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    gcc \
+    git \
+    && rm -rf /var/lib/apt/lists/*
+
+COPY . .
+
+RUN pip install --no-cache-dir --upgrade pip setuptools wheel && \
+    pip install --no-cache-dir ".[server]"
+
+FROM python:3.12-slim AS runner
+
+WORKDIR /app
+
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    curl \
+    && rm -rf /var/lib/apt/lists/*
+
+COPY --from=builder /usr/local/lib/python3.12/site-packages /usr/local/lib/python3.12/site-packages
+COPY --from=builder /usr/local/bin /usr/local/bin
+COPY --from=builder /app /app
+
+ENV PYTHONUNBUFFERED=1
+ENV PORT=8000
+ENV HOST=0.0.0.0
+
+EXPOSE 8000
+
+HEALTHCHECK --interval=30s --timeout=5s --start-period=5s --retries=3 \
+  CMD curl -f http://localhost:8000/health || exit 1
+
+CMD ["uvicorn", "ffbb_data_client.api:app", "--host", "0.0.0.0", "--port", "8000"]

{ffbb_data_client-2.3.4 → ffbb_data_client-2.4.0}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: ffbb-data-client
-Version: 2.3.4
-Summary: FFBB Data Client — SDK Python asynchrone pour les Statistiques de Basket France. Type-safe Pydantic models, async/sync, Meilisearch.
+Version: 2.4.0
+Summary: API FFBB — SDK Python moderne & asynchrone pour les donnees officielles de la Federation Francaise de BasketBall (clubs, classements, calendriers, lives, Meilisearch). Alternative moderne a ffbb-api-client.
 Home-page: https://github.com/nickdesi/ffbb-data-client
 Author: nickdesi
 Author-email: nicolas.desimone@gmail.com
@@ -12,7 +12,7 @@ Project-URL: Source, https://github.com/nickdesi/ffbb-data-client
 Project-URL: Changelog, https://github.com/nickdesi/ffbb-data-client/blob/master/CHANGELOG.md
 Project-URL: Tracker, https://github.com/nickdesi/ffbb-data-client/issues
 Project-URL: Release Notes, https://github.com/nickdesi/ffbb-data-client/blob/master/RELEASE_NOTES.md
-Keywords: ffbb,basketball,statistiques,france,api,python-sdk,pydantic,asynchrone,meilisearch,basket-france
+Keywords: ffbb-api,api-ffbb,ffbb,api,basketball,basket-france,statistiques,python-sdk,pydantic,asynchrone,meilisearch,ffbb-api-client,ffbb-api-client-v2,open-data-basket,live-scores
 Platform: any
 Classifier: Development Status :: 4 - Beta
 Classifier: Programming Language :: Python
@@ -37,6 +37,10 @@ Requires-Dist: python-dateutil>=2.9.0.post0
 Requires-Dist: httpx>=0.28.1
 Requires-Dist: hishel[async]>=1.3.0
 Requires-Dist: pydantic>=2.13.4
+Provides-Extra: server
+Requires-Dist: fastapi>=0.115.0; extra == "server"
+Requires-Dist: uvicorn[standard]>=0.34.0; extra == "server"
+Requires-Dist: starlette>=0.45.0; extra == "server"
 Provides-Extra: testing
 Requires-Dist: setuptools>=82.0.1; extra == "testing"
 Requires-Dist: coverage>=7.13.5; extra == "testing"
@@ -52,9 +56,11 @@ Dynamic: license-file
 
 <div align="center">
 
-# 🏀 FFBB Data Client
+# 🏀 FFBB Data Client — API FFBB Python SDK
 
-**SDK Python moderne, typé et asynchrone pour exploiter les données publiques FFBB : clubs, compétitions, rencontres, classements, salles, officiels et recherche Meilisearch.**
+**SDK Python moderne, typé et asynchrone pour exploiter l'API FFBB et ses données officielles : clubs, compétitions, rencontres, classements, salles, officiels, scores en direct (lives) et recherche Meilisearch.**
+
+*Alternative moderne, performante et maintenue aux anciens packages `ffbb-api-client` et `ffbb-api-client-v2`.*
 
 [![PyPI](https://img.shields.io/pypi/v/ffbb-data-client?color=blue&label=PyPI&logo=python&logoColor=white)](https://pypi.org/project/ffbb-data-client/)
 [![Python](https://img.shields.io/pypi/pyversions/ffbb-data-client?logo=python&logoColor=white)](https://pypi.org/project/ffbb-data-client/)

{ffbb_data_client-2.3.4 → ffbb_data_client-2.4.0}/README.md

@@ -1,8 +1,10 @@
 <div align="center">
 
-# 🏀 FFBB Data Client
+# 🏀 FFBB Data Client — API FFBB Python SDK
 
-**SDK Python moderne, typé et asynchrone pour exploiter les données publiques FFBB : clubs, compétitions, rencontres, classements, salles, officiels et recherche Meilisearch.**
+**SDK Python moderne, typé et asynchrone pour exploiter l'API FFBB et ses données officielles : clubs, compétitions, rencontres, classements, salles, officiels, scores en direct (lives) et recherche Meilisearch.**
+
+*Alternative moderne, performante et maintenue aux anciens packages `ffbb-api-client` et `ffbb-api-client-v2`.*
 
 [![PyPI](https://img.shields.io/pypi/v/ffbb-data-client?color=blue&label=PyPI&logo=python&logoColor=white)](https://pypi.org/project/ffbb-data-client/)
 [![Python](https://img.shields.io/pypi/pyversions/ffbb-data-client?logo=python&logoColor=white)](https://pypi.org/project/ffbb-data-client/)

{ffbb_data_client-2.3.4 → ffbb_data_client-2.4.0}/RELEASE_NOTES.md

@@ -1,6 +1,19 @@
 # Release Notes - FFBB Data Client
 
-## Version 2.3.4 (Latest Release)
+## Version 2.4.0 (Latest Release)
+
+### 🚀 New Features & API
+- **Embedded FastAPI Server**: Standalone or embeddable FastAPI application providing CORS-enabled REST endpoints for clubs, competitions, and match calendars with auto-generated Swagger UI.
+- **Precise Venue Geocoding**: Enhanced gym & salle resolution delivering exact street addresses for both home and away matches.
+- **Async Resource Cleanup**: Added explicit `aclose()` support across async clients with connection pool lifecycle management.
+
+### 🐛 Bug Fixes & Refactoring
+- **Model Import Paths**: Fixed direct module imports for `CategorieType` and `Niveau` to avoid deprecation warnings.
+- **Repository Architecture Rules**: Documented PyPI release immutability and strict zero-guess versioning in `AGENTS.md`.
+
+---
+
+## Version 2.3.4
 
 ### 🔒 Security & Bug Fixes
 - **Sensitive logging mitigation**: Masked authentication tokens in logging messages and format arguments (`CWE-532` / CodeQL compliance)

{ffbb_data_client-2.3.4 → ffbb_data_client-2.4.0}/examples/team_ranking_analysis.py

@@ -26,9 +26,9 @@ from dotenv import load_dotenv
 
 from ffbb_data_client import FFBBDataClient
 from ffbb_data_client.models.get_organisme_response import GetOrganismeResponse
-from ffbb_data_client.models.niveau_models import NiveauType
-from ffbb_data_client.models.poules_models import GetPouleResponse
-from ffbb_data_client.models.rankings_models import TeamRanking
+from ffbb_data_client.models.get_poule_response import GetPouleResponse
+from ffbb_data_client.models.niveau_type import NiveauType
+from ffbb_data_client.models.team_ranking import TeamRanking
 
 # Example configuration - modify these values for your team
 TEAM_NAME = "SENAS BASKET BALL"

{ffbb_data_client-2.3.4 → ffbb_data_client-2.4.0}/setup.cfg

@@ -1,9 +1,9 @@
 [metadata]
 name = ffbb-data-client
-description = FFBB Data Client — SDK Python asynchrone pour les Statistiques de Basket France. Type-safe Pydantic models, async/sync, Meilisearch.
+description = API FFBB — SDK Python moderne & asynchrone pour les donnees officielles de la Federation Francaise de BasketBall (clubs, classements, calendriers, lives, Meilisearch). Alternative moderne a ffbb-api-client.
 author = nickdesi
 author_email = nicolas.desimone@gmail.com
-keywords = ffbb, basketball, statistiques, france, api, python-sdk, pydantic, asynchrone, meilisearch, basket-france
+keywords = ffbb-api, api-ffbb, ffbb, api, basketball, basket-france, statistiques, python-sdk, pydantic, asynchrone, meilisearch, ffbb-api-client, ffbb-api-client-v2, open-data-basket, live-scores
 license = Apache-2.0
 license_files = LICENSE.txt
 long_description = file: README.md
@@ -61,6 +61,10 @@ exclude =
 	tests
 
 [options.extras_require]
+server = 
+	fastapi>=0.115.0
+	uvicorn[standard]>=0.34.0
+	starlette>=0.45.0
 testing = 
 	setuptools>=82.0.1
 	coverage>=7.13.5

{ffbb_data_client-2.3.4 → ffbb_data_client-2.4.0}/src/ffbb_data_client/__init__.py

@@ -34,6 +34,7 @@ from .models.generic_search import (
 )
 from .models.get_competition_response import GetCompetitionResponse
 from .models.get_organisme_response import GetOrganismeResponse
+from .models.get_poule_response import GetPouleResponse
 from .models.multi_search_query import MultiSearchQuery
 from .models.multi_search_result_competitions import CompetitionsMultiSearchResult
 from .models.multi_search_result_engagements import EngagementsMultiSearchResult
@@ -47,18 +48,18 @@ 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.ranking_engagement import RankingEngagement
 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.team_ranking import TeamRanking
 from .models.terrains_facet_distribution import TerrainsFacetDistribution
 from .models.terrains_facet_stats import TerrainsFacetStats
 from .models.terrains_hit import TerrainsHit