ffbb-data-client 2.1.0__tar.gz → 2.2.0__tar.gz

{ffbb_data_client-2.1.0 → ffbb_data_client-2.2.0}/.github/scripts/check_wrapper_parity.py

@@ -62,13 +62,25 @@ def write_summary(text: str) -> None:
 def main() -> int:
     api_methods = get_public_methods(CLIENTS / "api_ffbb_app_client.py")
     ms_methods = get_public_methods(CLIENTS / "meilisearch_ffbb_client.py")
-    wrapper_methods = get_public_methods(CLIENTS / "ffbb_data_client.py")
+
+    # Collect wrapper methods from the main file AND any facade files.
+    # After the v2.1.0 refactor, methods live in _rest_facade.py and
+    # _search_facade.py; the thin ffbb_data_client.py delegates via setattr.
+    wrapper_files = [
+        CLIENTS / "ffbb_data_client.py",
+        CLIENTS / "_rest_facade.py",
+        CLIENTS / "_search_facade.py",
+    ]
+    wrapper_methods: set[str] = set()
+    for wf in wrapper_files:
+        if wf.exists():
+            wrapper_methods |= get_public_methods(wf)
 
     all_inner = api_methods | ms_methods
     missing = sorted(all_inner - wrapper_methods)
 
     if not missing:
-        msg = "## ✅ Wrapper parity OK\n\nAll public methods from inner clients are exposed in `FFBBDataClient`."
+        msg = "## ✅ Wrapper parity OK\n\nAll public methods from inner clients are exposed in `FFBBDataClient` (including facade files)."
         print(msg)
         write_summary(msg)
         return 0
@@ -77,13 +89,14 @@ def main() -> int:
     missing_detail = " ".join(
         [
             "The following methods exist in inner clients but are **not exposed**",
-            "in `FFBBDataClient`:",
+            "in `FFBBDataClient` or its facade files:",
         ]
     )
     fix_detail = " ".join(
         [
             "Add the missing method(s) to",
-            "`src/ffbb_data_client/clients/ffbb_data_client.py`",
+            "`src/ffbb_data_client/clients/ffbb_data_client.py` or one of its",
+            "facade files (`_rest_facade.py`, `_search_facade.py`)",
             "so they delegate to the appropriate inner client.",
         ]
     )

{ffbb_data_client-2.1.0 → ffbb_data_client-2.2.0}/CHANGELOG.md

@@ -5,6 +5,26 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [2.2.0] - 2026-05-17
+
+### Changed
+- **REFACTOR**: `FFBBDataClient` (2865 → 272 lines) split into modular facades — `_RestFacade` (1592 lines) and `_SearchFacade` (1020 lines)
+- Public API remains 100% backward-compatible — all 167 methods accessible directly on `FFBBDataClient`
+- `check_wrapper_parity.py` updated to scan facade files in addition to the main client
+
+### Added
+- `pytest_asyncio_mode = "auto"` in `pyproject.toml` for pytest-asyncio compatibility
+- `isolated_build = True` in `tox.ini` for proper PEP 517 builds
+
+### Fixed
+- `CacheManager` docstring corrected — Redis backend marked as "planned" (not implemented)
+- `readme_renderer[md]` moved from `install_requires` to `testing` extras (build-time only dependency)
+
+### Removed
+- Orphaned `src/ffbb_api_client_v3/` directory (residual from v2.1.0 cleanup)
+- Orphaned `.coverage` file at project root
+- `benchmark_search_organisme.py` moved from root to `scripts/`
+
 ## [2.1.0] - 2026-05-17
 
 ### Changed

{ffbb_data_client-2.1.0/src/ffbb_data_client.egg-info → ffbb_data_client-2.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ffbb-data-client
-Version: 2.1.0
+Version: 2.2.0
 Summary: FFBB Data Client — SDK Python asynchrone pour les Statistiques de Basket France. Type-safe Pydantic models, async/sync, Meilisearch.
 Home-page: https://github.com/nickdesi/ffbb-data-client
 Author: nickdesi
@@ -33,7 +33,6 @@ Requires-Python: >=3.10
 Description-Content-Type: text/markdown; charset=UTF-8
 License-File: LICENSE.txt
 Requires-Dist: python-dotenv>=1.2.2
-Requires-Dist: readme_renderer[md]>=44.0
 Requires-Dist: python-dateutil>=2.9.0.post0
 Requires-Dist: httpx>=0.28.1
 Requires-Dist: hishel[async]>=1.2.1
@@ -46,6 +45,7 @@ Requires-Dist: pytest-xdist>=3.8.0; extra == "testing"
 Requires-Dist: pytest-cov>=7.1.0; extra == "testing"
 Requires-Dist: respx>=0.23.1; extra == "testing"
 Requires-Dist: pytest-asyncio>=1.3.0; extra == "testing"
+Requires-Dist: readme_renderer[md]>=44.0; extra == "testing"
 Provides-Extra: typing
 Requires-Dist: types-python-dateutil>=2.9.0.20260408; extra == "typing"
 Dynamic: license-file
@@ -85,18 +85,17 @@ Dynamic: license-file
 - du cache HTTP configurable via `hishel` ;
 - des helpers prêts pour l'intégration MCP / agents IA.
 
-> La V3 remplace l’approche V2 basée sur des dictionnaires bruts et une configuration manuelle. Elle privilégie le typage, la robustesse réseau et les appels batchés.
-
 ---
 
-## 🚀 Version v2.1.0 — Mai 2026
+## 🚀 Version v2.2.0 — Mai 2026
 
 Principales évolutions récentes :
 
-- **unification sync/async** : les méthodes synchrones délèguent désormais à leurs homologues asynchrones via `_run_async()`, éliminant ~604 lignes de duplication ;
+- **refactor architecture** : `FFBBDataClient` (2865 → 272 lignes) découpé en `_RestFacade` + `_SearchFacade` — API publique 100% compatible ;
+- **unification sync/async** : les méthodes synchrones délèguent à leurs homologues asynchrones via `_run_async()`, éliminant ~604 lignes de duplication ;
 - **nouvelles entités** : EDF (matches, joueurs, rosters, équipes), Genius Sport (matches, live logs), Rematch Videos ;
 - **cache SQLite concurrency-safe** : fichiers séparés pour sync (`http_cache.db`) et async (`http_cache_async.db`) ;
-- **CI renforcée** : mypy + pyright + CodeQL + Dependabot + hook pre-push ;
+- **CI renforcée** : mypy + pyright + CodeQL + Dependabot + hook pre-push + wrapper parity check ;
 - **nettoyage** : suppression du shim `ffbb_api_client_v3`, scripts morts et code mort (`invalidate_pattern`).
 
 Voir aussi : [`CHANGELOG.md`](CHANGELOG.md) et [`RELEASE_NOTES.md`](RELEASE_NOTES.md).
@@ -272,7 +271,9 @@ Il est donc possible de laisser le client résoudre les tokens automatiquement o
 ```text
 src/ffbb_data_client/
 ├── clients/
-│   ├── ffbb_data_client.py       # Façade publique (sync → async delegation)
+│   ├── ffbb_data_client.py       # Façade publique (272 lignes, delegation)
+│   ├── _rest_facade.py           # Façade REST API (Directus)
+│   ├── _search_facade.py         # Façade recherche Meilisearch
 │   ├── api_ffbb_app_client.py    # Client REST FFBB (async source of truth)
 │   └── meilisearch_ffbb_client.py # Client recherche Meilisearch
 ├── helpers/                       # Requêtes HTTP, multi-search, conversions
@@ -282,6 +283,8 @@ src/ffbb_data_client/
 ```
 
 > **Architecture sync/async** : Depuis v2.1.0, les méthodes asynchrones sont la source de vérité. Les méthodes synchrones délèguent via `_run_async()`, un helper qui gère les event loops imbriqués avec `ThreadPoolExecutor`.
+>
+> **Architecture facades** : Depuis v2.2.0, `FFBBDataClient` est une fine coquille qui compose `_RestFacade` et `_SearchFacade`. L'API publique reste identique — `client.get_organisme(123)` fonctionne comme avant.
 
 ---
 

{ffbb_data_client-2.1.0 → ffbb_data_client-2.2.0}/README.md

@@ -33,18 +33,17 @@
 - du cache HTTP configurable via `hishel` ;
 - des helpers prêts pour l'intégration MCP / agents IA.
 
-> La V3 remplace l’approche V2 basée sur des dictionnaires bruts et une configuration manuelle. Elle privilégie le typage, la robustesse réseau et les appels batchés.
-
 ---
 
-## 🚀 Version v2.1.0 — Mai 2026
+## 🚀 Version v2.2.0 — Mai 2026
 
 Principales évolutions récentes :
 
-- **unification sync/async** : les méthodes synchrones délèguent désormais à leurs homologues asynchrones via `_run_async()`, éliminant ~604 lignes de duplication ;
+- **refactor architecture** : `FFBBDataClient` (2865 → 272 lignes) découpé en `_RestFacade` + `_SearchFacade` — API publique 100% compatible ;
+- **unification sync/async** : les méthodes synchrones délèguent à leurs homologues asynchrones via `_run_async()`, éliminant ~604 lignes de duplication ;
 - **nouvelles entités** : EDF (matches, joueurs, rosters, équipes), Genius Sport (matches, live logs), Rematch Videos ;
 - **cache SQLite concurrency-safe** : fichiers séparés pour sync (`http_cache.db`) et async (`http_cache_async.db`) ;
-- **CI renforcée** : mypy + pyright + CodeQL + Dependabot + hook pre-push ;
+- **CI renforcée** : mypy + pyright + CodeQL + Dependabot + hook pre-push + wrapper parity check ;
 - **nettoyage** : suppression du shim `ffbb_api_client_v3`, scripts morts et code mort (`invalidate_pattern`).
 
 Voir aussi : [`CHANGELOG.md`](CHANGELOG.md) et [`RELEASE_NOTES.md`](RELEASE_NOTES.md).
@@ -220,7 +219,9 @@ Il est donc possible de laisser le client résoudre les tokens automatiquement o
 ```text
 src/ffbb_data_client/
 ├── clients/
-│   ├── ffbb_data_client.py       # Façade publique (sync → async delegation)
+│   ├── ffbb_data_client.py       # Façade publique (272 lignes, delegation)
+│   ├── _rest_facade.py           # Façade REST API (Directus)
+│   ├── _search_facade.py         # Façade recherche Meilisearch
 │   ├── api_ffbb_app_client.py    # Client REST FFBB (async source of truth)
 │   └── meilisearch_ffbb_client.py # Client recherche Meilisearch
 ├── helpers/                       # Requêtes HTTP, multi-search, conversions
@@ -230,6 +231,8 @@ src/ffbb_data_client/
 ```
 
 > **Architecture sync/async** : Depuis v2.1.0, les méthodes asynchrones sont la source de vérité. Les méthodes synchrones délèguent via `_run_async()`, un helper qui gère les event loops imbriqués avec `ThreadPoolExecutor`.
+>
+> **Architecture facades** : Depuis v2.2.0, `FFBBDataClient` est une fine coquille qui compose `_RestFacade` et `_SearchFacade`. L'API publique reste identique — `client.get_organisme(123)` fonctionne comme avant.
 
 ---
 

{ffbb_data_client-2.1.0 → ffbb_data_client-2.2.0}/RELEASE_NOTES.md

@@ -1,6 +1,31 @@
 # Release Notes - FFBB API Client V2
 
-## Version 1.5.0 (Latest Release)
+## Version 2.2.0 (Latest Release)
+
+### 🏗 Architecture Refactor
+
+#### **Facade Pattern — FFBBDataClient Modularization**
+- **REFACTOR**: `FFBBDataClient` split from a monolithic 2865-line file into three focused modules:
+  - `ffbb_data_client.py` (272 lines) — thin public facade with factory and delegation
+  - `_rest_facade.py` (1592 lines) — all REST API (Directus) methods
+  - `_search_facade.py` (1020 lines) — all Meilisearch search methods
+- **BACKWARD-COMPATIBLE**: All 167 public methods remain accessible directly on `FFBBDataClient` instances — zero breaking changes
+- Methods delegated via `setattr` at construction time — no performance impact
+
+#### **CI & Build Improvements**
+- `pytest_asyncio_mode = "auto"` — prevents pytest-asyncio breaking changes across versions
+- `isolated_build = True` in tox — proper PEP 517 builds with setuptools_scm
+- `check_wrapper_parity.py` updated to scan facade files alongside the main client
+
+### 🐛 Bug Fixes & Cleanup
+- `CacheManager` docstring corrected — Redis backend documented as "planned"
+- `readme_renderer[md]` moved to dev extras (was incorrectly in runtime dependencies)
+- Orphaned `src/ffbb_api_client_v3/` directory removed
+- `benchmark_search_organisme.py` moved to `scripts/`
+
+---
+
+## Version 2.1.0 (Previous Release)
 
 ### 🚀 Major Features & Improvements
 

{ffbb_data_client-2.1.0 → ffbb_data_client-2.2.0}/pyproject.toml

@@ -44,3 +44,4 @@ python_classes = ["Test*"]
 python_functions = ["test_*"]
 addopts = "-v --tb=short"
 pythonpath = ["src"]
+asyncio_mode = "auto"

{ffbb_data_client-2.1.0 → ffbb_data_client-2.2.0}/src/ffbb_data_client/clients/__init__.py

@@ -1,5 +1,7 @@
 """Client classes for FFBB API interactions."""
 
+from ._rest_facade import _RestFacade
+from ._search_facade import _SearchFacade
 from .api_ffbb_app_client import ApiFFBBAppClient
 from .ffbb_data_client import FFBBDataClient
 from .meilisearch_client import MeilisearchClient
@@ -10,4 +12,6 @@ __all__ = [
     "FFBBDataClient",
     "MeilisearchClient",
     "MeilisearchFFBBClient",
+    "_RestFacade",
+    "_SearchFacade",
 ]