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

{ffbb_data_client-2.3.4 → ffbb_data_client-2.3.5}/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.3.5
+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
@@ -52,9 +52,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.3.5}/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.3.5}/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

{ffbb_data_client-2.3.4 → ffbb_data_client-2.3.5}/src/ffbb_data_client/clients/_rest_facade.py

@@ -1,5 +1,6 @@
 from __future__ import annotations
 
+import asyncio
 import json
 from typing import Any
 
@@ -1732,3 +1733,107 @@ class _RestFacade:
                 )
             )
         return results
+
+    async def list_engagements_by_ids_async(
+        self, ids: list[int], cached_session: httpx.AsyncClient | None = None
+    ) -> list[GetEngagementResponse]:
+        if not ids:
+            return []
+        chunks = self._chunked(ids, self._BATCH_CHUNK_SIZE)
+        tasks = [
+            self.list_engagements_async(
+                limit=len(chunk),
+                filter_criteria=json.dumps({"id": {"_in": chunk}}),
+                cached_session=cached_session,
+            )
+            for chunk in chunks
+        ]
+        chunk_results = await asyncio.gather(*tasks)
+        results: list[GetEngagementResponse] = []
+        for chunk_res in chunk_results:
+            if chunk_res:
+                results.extend(chunk_res)
+        return results
+
+    async def list_engagements_by_poule_async(
+        self, poule_id: int, cached_session: httpx.AsyncClient | None = None
+    ) -> list[GetEngagementResponse]:
+        return await self.list_engagements_async(
+            limit=250,
+            filter_criteria=json.dumps({"idPoule": {"_eq": poule_id}}),
+            cached_session=cached_session,
+        )
+
+    async def list_engagements_by_poules_async(
+        self, poule_ids: list[int], cached_session: httpx.AsyncClient | None = None
+    ) -> list[GetEngagementResponse]:
+        if not poule_ids:
+            return []
+        chunks = self._chunked(poule_ids, self._BATCH_CHUNK_SIZE)
+        tasks = [
+            self.list_engagements_async(
+                limit=len(chunk) * 15,
+                filter_criteria=json.dumps({"idPoule": {"_in": chunk}}),
+                cached_session=cached_session,
+            )
+            for chunk in chunks
+        ]
+        chunk_results = await asyncio.gather(*tasks)
+        results: list[GetEngagementResponse] = []
+        for chunk_res in chunk_results:
+            if chunk_res:
+                results.extend(chunk_res)
+        return results
+
+    async def list_rencontres_by_poule_async(
+        self, poule_id: int, cached_session: httpx.AsyncClient | None = None
+    ) -> list[GetRencontreResponse]:
+        return await self.list_rencontres_async(
+            limit=500,
+            filter_criteria=json.dumps({"idPoule": {"_eq": poule_id}}),
+            cached_session=cached_session,
+        )
+
+    async def list_rencontres_by_poules_async(
+        self, poule_ids: list[int], cached_session: httpx.AsyncClient | None = None
+    ) -> list[GetRencontreResponse]:
+        if not poule_ids:
+            return []
+        chunks = self._chunked(poule_ids, self._BATCH_CHUNK_SIZE)
+        tasks = [
+            self.list_rencontres_async(
+                limit=len(chunk) * 30,
+                filter_criteria=json.dumps({"idPoule": {"_in": chunk}}),
+                cached_session=cached_session,
+            )
+            for chunk in chunks
+        ]
+        chunk_results = await asyncio.gather(*tasks)
+        results: list[GetRencontreResponse] = []
+        for chunk_res in chunk_results:
+            if chunk_res:
+                results.extend(chunk_res)
+        return results
+
+    async def list_entraineurs_by_ids_async(
+        self, ids: list[int], cached_session: httpx.AsyncClient | None = None
+    ) -> list[GetEntraineurResponse]:
+        if not ids:
+            return []
+        chunks = self._chunked(ids, self._BATCH_CHUNK_SIZE)
+        tasks = [
+            self.list_entraineurs_async(
+                limit=len(chunk),
+                filter_criteria=json.dumps(
+                    {"idLicence": {"_in": [str(i) for i in chunk]}}
+                ),
+                cached_session=cached_session,
+            )
+            for chunk in chunks
+        ]
+        chunk_results = await asyncio.gather(*tasks)
+        results: list[GetEntraineurResponse] = []
+        for chunk_res in chunk_results:
+            if chunk_res:
+                results.extend(chunk_res)
+        return results

{ffbb_data_client-2.3.4 → ffbb_data_client-2.3.5}/src/ffbb_data_client/clients/_search_facade.py

@@ -403,16 +403,13 @@ class _SearchFacade:
         if categorie:
             for res in rencontres_results:
                 if res.hits:
-                    filtered_hits = []
-                    for hit in res.hits:
-                        comp = hit.competition_id
-                        cat = comp.categorie if comp else None
-                        if (
-                            comp
-                            and cat
-                            and (cat.code == categorie or cat.libelle == categorie)
-                        ):
-                            filtered_hits.append(hit)
+                    filtered_hits = [
+                        hit
+                        for hit in res.hits
+                        if (comp := hit.competition_id)
+                        and (cat := comp.categorie)
+                        and (cat.code == categorie or cat.libelle == categorie)
+                    ]
                     res.hits = filtered_hits
                     res.estimated_total_hits = len(filtered_hits)
         return rencontres_results

{ffbb_data_client-2.3.4 → ffbb_data_client-2.3.5}/src/ffbb_data_client/clients/meilisearch_client.py

@@ -61,8 +61,24 @@ def _cache_set(key: str, value: Any) -> None:
         _APP_CACHE[key] = (time.monotonic(), value)
 
 
+def _clone_multi_search_results(
+    res: MultiSearchResults | None,
+) -> MultiSearchResults | None:
+    if res is None:
+        return None
+    if res.results is None:
+        return MultiSearchResults(results=None)
+    cloned_results = []
+    for r in res.results:
+        r_copy = copy.copy(r)
+        if r.hits is not None:
+            r_copy.hits = list(r.hits)
+        cloned_results.append(r_copy)
+    return MultiSearchResults(results=cloned_results)
+
+
 def _cache_result_object(key: str, result: MultiSearchResults) -> None:
-    _cache_set(key, copy.deepcopy(result))
+    _cache_set(key, _clone_multi_search_results(result))
 
 
 def clear_meili_app_cache() -> None:
@@ -162,8 +178,7 @@ class MeilisearchClient:
         key = _make_cache_key(queries)
         cached = _cache_get(key)
         if cached is not None:
-            cached_copy: MultiSearchResults = copy.deepcopy(cached)
-            return cached_copy
+            return _clone_multi_search_results(cached)
 
         url = f"{self.url}{MEILISEARCH_ENDPOINT_MULTI_SEARCH}"
         params = {"queries": [query.to_dict() for query in queries] if queries else []}
@@ -193,8 +208,7 @@ class MeilisearchClient:
         key = _make_cache_key(queries)
         cached = _cache_get(key)
         if cached is not None:
-            cached_copy: MultiSearchResults = copy.deepcopy(cached)
-            return cached_copy
+            return _clone_multi_search_results(cached)
 
         url = f"{self.url}{MEILISEARCH_ENDPOINT_MULTI_SEARCH}"
         params = {"queries": [query.to_dict() for query in queries] if queries else []}

{ffbb_data_client-2.3.4 → ffbb_data_client-2.3.5}/src/ffbb_data_client/helpers/meilisearch_client_extension.py

@@ -31,7 +31,7 @@ def _apply_query_filters(
         result_list = results.results
         results.results = [
             query.filter_result(res) if query.q else res
-            for query, res in zip(queries, result_list, strict=True)
+            for query, res in zip(queries, result_list, strict=False)
         ]
     return results
 
@@ -51,7 +51,7 @@ def _build_pagination_jobs(
         return jobs
 
     for i, (query, query_result) in enumerate(
-        zip(queries, result.results, strict=True)
+        zip(queries, result.results, strict=False)
     ):
         if query_result.hits is None:
             continue

{ffbb_data_client-2.3.4 → ffbb_data_client-2.3.5}/src/ffbb_data_client.egg-info/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.3.5
+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
@@ -52,9 +52,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.3.5}/src/ffbb_data_client.egg-info/SOURCES.txt

@@ -370,8 +370,16 @@ tools/add_cross_repo_edges.py
 tools/graphify-cross-repo.sh
 tools/graphify_cross_repo.py
 tools/update_agents_md.py
+website/favicon.ico
 website/index.html
+website/llms-full.txt
+website/llms.txt
 website/robots.txt
 website/sitemap.xml
+website/assets/apple-touch-icon.png
+website/assets/favicon-192x192.png
+website/assets/favicon-48x48.png
+website/assets/favicon-96x96.png
+website/assets/favicon.ico
 website/assets/logo.webp
 website/css/style.css

{ffbb_data_client-2.3.4 → ffbb_data_client-2.3.5}/src/ffbb_data_client.egg-info/scm_file_list.json

@@ -364,9 +364,17 @@
     "tools/graphify_cross_repo.py",
     "tools/update_agents_md.py",
     "tox.ini",
+    "website/assets/apple-touch-icon.png",
+    "website/assets/favicon-192x192.png",
+    "website/assets/favicon-48x48.png",
+    "website/assets/favicon-96x96.png",
+    "website/assets/favicon.ico",
     "website/assets/logo.webp",
     "website/css/style.css",
+    "website/favicon.ico",
     "website/index.html",
+    "website/llms-full.txt",
+    "website/llms.txt",
     "website/robots.txt",
     "website/sitemap.xml"
   ]

ffbb_data_client-2.3.5/src/ffbb_data_client.egg-info/scm_version.json

@@ -0,0 +1,8 @@
+{
+  "tag": "2.3.5",
+  "distance": 0,
+  "node": "gadd603fd501b286f8a6b3be5f0eaf62c6d84660c",
+  "dirty": false,
+  "branch": "HEAD",
+  "node_date": "2026-08-21"
+}

{ffbb_data_client-2.3.4 → ffbb_data_client-2.3.5}/tests/unit/clients/test_210_targeted_clients_helpers_coverage.py

@@ -76,6 +76,18 @@ class TestTargetedMeilisearchExtensionCoverage(unittest.IsolatedAsyncioTestCase)
     def _client(self) -> MeilisearchClientExtension:
         return MeilisearchClientExtension("token", "https://example.test/")
 
+    def test_smart_multi_search_mismatched_lengths_does_not_raise(self) -> None:
+        client = self._client()
+        result1 = MultiSearchResult(hits=[_Hit(True)], estimated_total_hits=1)
+        queries = [MultiSearchQuery(q="Senas"), MultiSearchQuery(q="Other")]
+        # results has only 1 element while queries has 2
+        client.multi_search = MagicMock(return_value=MultiSearchResults([result1]))
+
+        result = client.smart_multi_search(queries)
+        self.assertIsNotNone(result)
+        assert result is not None and result.results is not None
+        self.assertEqual(len(result.results), 1)
+
     def test_smart_multi_search_filters_only_queries_with_q(self) -> None:
         client = self._client()
         result_with_q = MultiSearchResult(

{ffbb_data_client-2.3.4 → ffbb_data_client-2.3.5}/website/css/style.css

@@ -950,20 +950,20 @@ section {
         grid-template-columns: 1fr;
         gap: 2.25rem;
     }
-    
+
     .tools-grid, .usecases-grid {
         grid-template-columns: repeat(2, minmax(0, 1fr));
     }
-    
+
     .ai-banner {
         grid-template-columns: 1fr;
         padding: 2rem;
     }
-    
+
     .faq-grid {
         grid-template-columns: 1fr;
     }
-    
+
     .footer-grid {
         grid-template-columns: repeat(2, minmax(0, 1fr));
         gap: 1.75rem;