ffbb-data-client 2.4.35__tar.gz → 2.4.37__tar.gz

{ffbb_data_client-2.4.35/src/ffbb_data_client.egg-info → ffbb_data_client-2.4.37}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ffbb-data-client
-Version: 2.4.35
+Version: 2.4.37
 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

{ffbb_data_client-2.4.35 → ffbb_data_client-2.4.37}/data/api_update_summary.md

@@ -1,10 +1,10 @@
 # FFBB API update summary
 
-- Timestamp: `2026-10-01T07:34:29.224713+00:00`
+- Timestamp: `2026-10-11T11:25:31.496841+00:00`
 - API base URL: `https://api.ffbb.app/`
 - Meilisearch base URL: `https://meilisearch-prod.ffbb.app/`
-- OpenAPI version: `dcd2ad0fff6086cb91ea14bdd4782bc9ba343b5f`
-- OpenAPI SHA256: `3658bee13f442b72d7e5b71c04d995f4f65bdb88b50b89a45f32b1426b1a2c5e`
+- OpenAPI version: `9744f09b111bf3033192cbf60e4f2dafbd1a2d5a`
+- OpenAPI SHA256: `27d821d8baa21f33d0607457ce20eaf458cd9ae21184d72624dfd44e396b0c8e`
 
 ## Directus collections
 - Total: `162`
@@ -18,7 +18,7 @@
 
 ## Meilisearch indexes
 - Available total: `17`
-- Added: ['ffbbsite_faq', 'ffbbsite_jobs', 'ffbbsite_pages', 'youtube_playlists']
+- Added: None
 - Removed: None
 
 Generated by `python scripts/discover_endpoints.py`.

{ffbb_data_client-2.4.35 → ffbb_data_client-2.4.37}/data/endpoint_discovery.json

@@ -329,9 +329,9 @@
       "items/youtube_videos_youtube_tags"
     ],
     "metadata": {
-      "openapi_version": "dcd2ad0fff6086cb91ea14bdd4782bc9ba343b5f",
+      "openapi_version": "9744f09b111bf3033192cbf60e4f2dafbd1a2d5a",
       "source": "https://api.ffbb.app/server/specs/oas",
-      "timestamp": "2026-10-01T07:34:29.224713+00:00"
+      "timestamp": "2026-10-11T11:25:31.496841+00:00"
     },
     "paths": {
       "items/configuration": [
@@ -1404,7 +1404,7 @@
       },
       {
         "available": true,
-        "estimatedTotalHits": 549,
+        "estimatedTotalHits": 598,
         "indexUid": "ffbbnational_pratiques",
         "sampleKeys": [
           "_geo",
@@ -1461,7 +1461,7 @@
       },
       {
         "available": true,
-        "estimatedTotalHits": 4329,
+        "estimatedTotalHits": 4379,
         "indexUid": "ffbbnational_rss",
         "sampleKeys": [
           "categories",
@@ -1491,7 +1491,7 @@
       },
       {
         "available": true,
-        "estimatedTotalHits": 2994,
+        "estimatedTotalHits": 3166,
         "indexUid": "ffbbserver_competitions",
         "sampleKeys": [
           "age",
@@ -1571,7 +1571,7 @@
       },
       {
         "available": true,
-        "estimatedTotalHits": 150,
+        "estimatedTotalHits": 145,
         "indexUid": "ffbbserver_formations",
         "sampleKeys": [
           "certification",
@@ -1734,7 +1734,7 @@
       },
       {
         "available": true,
-        "estimatedTotalHits": 16,
+        "estimatedTotalHits": 32,
         "indexUid": "ffbbserver_tournois",
         "sampleKeys": [
           "_geo",
@@ -1789,7 +1789,7 @@
       },
       {
         "available": true,
-        "estimatedTotalHits": 4,
+        "estimatedTotalHits": 5,
         "indexUid": "ffbbsite_jobs",
         "sampleKeys": [
           "asset",
@@ -1834,7 +1834,7 @@
       },
       {
         "available": true,
-        "estimatedTotalHits": 6332,
+        "estimatedTotalHits": 6382,
         "indexUid": "ffbbsite_news",
         "sampleKeys": [
           "author",
@@ -1893,7 +1893,7 @@
       },
       {
         "available": true,
-        "estimatedTotalHits": 1863,
+        "estimatedTotalHits": 1868,
         "indexUid": "youtube_videos",
         "sampleKeys": [
           "channelId",
@@ -1926,7 +1926,7 @@
     ],
     "metadata": {
       "source": "https://meilisearch-prod.ffbb.app/multi-search",
-      "timestamp": "2026-10-01T07:34:29.224713+00:00"
+      "timestamp": "2026-10-11T11:25:31.496841+00:00"
     },
     "unavailable_indexes": [
       {
@@ -2666,9 +2666,9 @@
   "metadata": {
     "api_base_url": "https://api.ffbb.app/",
     "meilisearch_base_url": "https://meilisearch-prod.ffbb.app/",
-    "openapi_sha256": "3658bee13f442b72d7e5b71c04d995f4f65bdb88b50b89a45f32b1426b1a2c5e",
-    "openapi_snapshot_sha256": "65ecec181d406f60f8c51a1a218c587b554c9dbcaed93d4c12a53ca4a6242cbc",
-    "openapi_version": "dcd2ad0fff6086cb91ea14bdd4782bc9ba343b5f",
-    "timestamp": "2026-10-01T07:34:29.224713+00:00"
+    "openapi_sha256": "27d821d8baa21f33d0607457ce20eaf458cd9ae21184d72624dfd44e396b0c8e",
+    "openapi_snapshot_sha256": "4098254f14104ef897f1a4d47f6e7903186a3cce2b24c3d607d3ba6c5e96762c",
+    "openapi_version": "9744f09b111bf3033192cbf60e4f2dafbd1a2d5a",
+    "timestamp": "2026-10-11T11:25:31.496841+00:00"
   }
 }

{ffbb_data_client-2.4.35 → ffbb_data_client-2.4.37}/data/indexes.json

@@ -44,7 +44,7 @@
     },
     {
       "available": true,
-      "estimatedTotalHits": 549,
+      "estimatedTotalHits": 598,
       "indexUid": "ffbbnational_pratiques",
       "sampleKeys": [
         "_geo",
@@ -101,7 +101,7 @@
     },
     {
       "available": true,
-      "estimatedTotalHits": 4329,
+      "estimatedTotalHits": 4379,
       "indexUid": "ffbbnational_rss",
       "sampleKeys": [
         "categories",
@@ -131,7 +131,7 @@
     },
     {
       "available": true,
-      "estimatedTotalHits": 2994,
+      "estimatedTotalHits": 3166,
       "indexUid": "ffbbserver_competitions",
       "sampleKeys": [
         "age",
@@ -211,7 +211,7 @@
     },
     {
       "available": true,
-      "estimatedTotalHits": 150,
+      "estimatedTotalHits": 145,
       "indexUid": "ffbbserver_formations",
       "sampleKeys": [
         "certification",
@@ -374,7 +374,7 @@
     },
     {
       "available": true,
-      "estimatedTotalHits": 16,
+      "estimatedTotalHits": 32,
       "indexUid": "ffbbserver_tournois",
       "sampleKeys": [
         "_geo",
@@ -429,7 +429,7 @@
     },
     {
       "available": true,
-      "estimatedTotalHits": 4,
+      "estimatedTotalHits": 5,
       "indexUid": "ffbbsite_jobs",
       "sampleKeys": [
         "asset",
@@ -474,7 +474,7 @@
     },
     {
       "available": true,
-      "estimatedTotalHits": 6332,
+      "estimatedTotalHits": 6382,
       "indexUid": "ffbbsite_news",
       "sampleKeys": [
         "author",
@@ -533,7 +533,7 @@
     },
     {
       "available": true,
-      "estimatedTotalHits": 1863,
+      "estimatedTotalHits": 1868,
       "indexUid": "youtube_videos",
       "sampleKeys": [
         "channelId",
@@ -566,7 +566,7 @@
   ],
   "metadata": {
     "source": "https://meilisearch-prod.ffbb.app/multi-search",
-    "timestamp": "2026-10-01T07:34:29.224713+00:00"
+    "timestamp": "2026-10-11T11:25:31.496841+00:00"
   },
   "unavailable_indexes": [
     {

ffbb_data_client-2.4.37/data/permission_drift_summary.md

@@ -0,0 +1,6 @@
+# FFBB permission matrix drift — 2026-10-11T11:25:49.373634+00:00
+
+- FLIP: config_noauth_ipv6: ok -> error:ConnectError
+- FLIP: config_tripwire_okhttp_ipv4: blocked_cdn -> ok
+
+Vérifier la politique de rôles Directus (filtres de saison, champs restreints) ou rafraîchir les canaris après un rollover de saison.

{ffbb_data_client-2.4.35/src/ffbb_data_client → ffbb_data_client-2.4.37}/data/permission_matrix.json

@@ -1,11 +1,18 @@
 {
   "drift": {
-    "added": [
-      "config_noauth_ipv4",
-      "config_noauth_ipv6",
-      "config_tripwire_okhttp_ipv4"
+    "added": [],
+    "flips": [
+      {
+        "after": "error:ConnectError",
+        "before": "ok",
+        "probe": "config_noauth_ipv6"
+      },
+      {
+        "after": "ok",
+        "before": "blocked_cdn",
+        "probe": "config_tripwire_okhttp_ipv4"
+      }
     ],
-    "flips": [],
     "removed": []
   },
   "metadata": {
@@ -13,7 +20,7 @@
     "archived_competition_id": "200000002872733",
     "canary_season": "2026-2027",
     "current_competition_id": "200000002900744",
-    "timestamp": "2026-10-10T14:44:42.901605+00:00",
+    "timestamp": "2026-10-11T11:25:49.373634+00:00",
     "token_source": "public-fallback"
   },
   "probes": [
@@ -32,17 +39,18 @@
       "url": "https://api.ffbb.app/items/configuration"
     },
     {
+      "detail": "[Errno 101] Network is unreachable",
       "name": "config_noauth_ipv6",
       "notes": "Public endpoint sans auth en IPv6 strict.",
-      "outcome": "ok",
-      "status": 200,
+      "outcome": "error:ConnectError",
+      "status": null,
       "url": "https://api.ffbb.app/items/configuration"
     },
     {
       "name": "config_tripwire_okhttp_ipv4",
       "notes": "Canari sentinelle okhttp sur IPv4 : attendu blocked_cdn (alerte si débloqué ou si la règle change).",
-      "outcome": "blocked_cdn",
-      "status": 403,
+      "outcome": "ok",
+      "status": 200,
       "url": "https://api.ffbb.app/items/configuration"
     },
     {

{ffbb_data_client-2.4.35 → ffbb_data_client-2.4.37}/docs/data_dictionary.rst

@@ -75,7 +75,7 @@ Index ``ffbbnational_galeries``
 Index ``ffbbnational_pratiques``
 --------------------------------
 
-- **Nombre d'enregistrements estimés** : ``549``
+- **Nombre d'enregistrements estimés** : ``598``
 
 .. list-table::
    :header-rows: 1
@@ -235,7 +235,7 @@ Index ``ffbbnational_pratiques``
 Index ``ffbbnational_rss``
 --------------------------
 
-- **Nombre d'enregistrements estimés** : ``4329``
+- **Nombre d'enregistrements estimés** : ``4379``
 
 .. list-table::
    :header-rows: 1
@@ -314,7 +314,7 @@ Index ``ffbbnational_rss``
 Index ``ffbbserver_competitions``
 ---------------------------------
 
-- **Nombre d'enregistrements estimés** : ``2994``
+- **Nombre d'enregistrements estimés** : ``3166``
 
 .. list-table::
    :header-rows: 1
@@ -532,7 +532,7 @@ Index ``ffbbserver_engagements``
 Index ``ffbbserver_formations``
 -------------------------------
 
-- **Nombre d'enregistrements estimés** : ``150``
+- **Nombre d'enregistrements estimés** : ``145``
 
 .. list-table::
    :header-rows: 1
@@ -966,7 +966,7 @@ Index ``ffbbserver_terrains``
 Index ``ffbbserver_tournois``
 -----------------------------
 
-- **Nombre d'enregistrements estimés** : ``16``
+- **Nombre d'enregistrements estimés** : ``32``
 
 .. list-table::
    :header-rows: 1
@@ -1109,7 +1109,7 @@ Index ``ffbbsite_faq``
 Index ``ffbbsite_jobs``
 -----------------------
 
-- **Nombre d'enregistrements estimés** : ``4``
+- **Nombre d'enregistrements estimés** : ``5``
 
 .. list-table::
    :header-rows: 1
@@ -1233,7 +1233,7 @@ Index ``ffbbsite_jobs``
 Index ``ffbbsite_news``
 -----------------------
 
-- **Nombre d'enregistrements estimés** : ``6332``
+- **Nombre d'enregistrements estimés** : ``6382``
 
 .. list-table::
    :header-rows: 1
@@ -1380,7 +1380,7 @@ Index ``youtube_playlists``
 Index ``youtube_videos``
 ------------------------
 
-- **Nombre d'enregistrements estimés** : ``1863``
+- **Nombre d'enregistrements estimés** : ``1868``
 
 .. list-table::
    :header-rows: 1

{ffbb_data_client-2.4.35 → ffbb_data_client-2.4.37}/src/ffbb_data_client/config.py

@@ -3,7 +3,9 @@
 import os
 
 # API URLs
-API_FFBB_BASE_URL = "https://api.ffbb.app/"
+API_FFBB_BASE_URL = (
+    os.getenv("API_FFBB_BASE_URL", "https://bo.ffbb.com/").rstrip("/") + "/"
+)
 MEILISEARCH_BASE_URL = "https://meilisearch-prod.ffbb.app/"
 
 # HTTP Headers

{ffbb_data_client-2.4.35 → ffbb_data_client-2.4.37}/src/ffbb_data_client/data/endpoint_discovery.json

@@ -329,9 +329,9 @@
       "items/youtube_videos_youtube_tags"
     ],
     "metadata": {
-      "openapi_version": "dcd2ad0fff6086cb91ea14bdd4782bc9ba343b5f",
+      "openapi_version": "9744f09b111bf3033192cbf60e4f2dafbd1a2d5a",
       "source": "https://api.ffbb.app/server/specs/oas",
-      "timestamp": "2026-10-01T07:34:29.224713+00:00"
+      "timestamp": "2026-10-11T11:25:31.496841+00:00"
     },
     "paths": {
       "items/configuration": [
@@ -1404,7 +1404,7 @@
       },
       {
         "available": true,
-        "estimatedTotalHits": 549,
+        "estimatedTotalHits": 598,
         "indexUid": "ffbbnational_pratiques",
         "sampleKeys": [
           "_geo",
@@ -1461,7 +1461,7 @@
       },
       {
         "available": true,
-        "estimatedTotalHits": 4329,
+        "estimatedTotalHits": 4379,
         "indexUid": "ffbbnational_rss",
         "sampleKeys": [
           "categories",
@@ -1491,7 +1491,7 @@
       },
       {
         "available": true,
-        "estimatedTotalHits": 2994,
+        "estimatedTotalHits": 3166,
         "indexUid": "ffbbserver_competitions",
         "sampleKeys": [
           "age",
@@ -1571,7 +1571,7 @@
       },
       {
         "available": true,
-        "estimatedTotalHits": 150,
+        "estimatedTotalHits": 145,
         "indexUid": "ffbbserver_formations",
         "sampleKeys": [
           "certification",
@@ -1734,7 +1734,7 @@
       },
       {
         "available": true,
-        "estimatedTotalHits": 16,
+        "estimatedTotalHits": 32,
         "indexUid": "ffbbserver_tournois",
         "sampleKeys": [
           "_geo",
@@ -1789,7 +1789,7 @@
       },
       {
         "available": true,
-        "estimatedTotalHits": 4,
+        "estimatedTotalHits": 5,
         "indexUid": "ffbbsite_jobs",
         "sampleKeys": [
           "asset",
@@ -1834,7 +1834,7 @@
       },
       {
         "available": true,
-        "estimatedTotalHits": 6332,
+        "estimatedTotalHits": 6382,
         "indexUid": "ffbbsite_news",
         "sampleKeys": [
           "author",
@@ -1893,7 +1893,7 @@
       },
       {
         "available": true,
-        "estimatedTotalHits": 1863,
+        "estimatedTotalHits": 1868,
         "indexUid": "youtube_videos",
         "sampleKeys": [
           "channelId",
@@ -1926,7 +1926,7 @@
     ],
     "metadata": {
       "source": "https://meilisearch-prod.ffbb.app/multi-search",
-      "timestamp": "2026-10-01T07:34:29.224713+00:00"
+      "timestamp": "2026-10-11T11:25:31.496841+00:00"
     },
     "unavailable_indexes": [
       {
@@ -2666,9 +2666,9 @@
   "metadata": {
     "api_base_url": "https://api.ffbb.app/",
     "meilisearch_base_url": "https://meilisearch-prod.ffbb.app/",
-    "openapi_sha256": "3658bee13f442b72d7e5b71c04d995f4f65bdb88b50b89a45f32b1426b1a2c5e",
-    "openapi_snapshot_sha256": "65ecec181d406f60f8c51a1a218c587b554c9dbcaed93d4c12a53ca4a6242cbc",
-    "openapi_version": "dcd2ad0fff6086cb91ea14bdd4782bc9ba343b5f",
-    "timestamp": "2026-10-01T07:34:29.224713+00:00"
+    "openapi_sha256": "27d821d8baa21f33d0607457ce20eaf458cd9ae21184d72624dfd44e396b0c8e",
+    "openapi_snapshot_sha256": "4098254f14104ef897f1a4d47f6e7903186a3cce2b24c3d607d3ba6c5e96762c",
+    "openapi_version": "9744f09b111bf3033192cbf60e4f2dafbd1a2d5a",
+    "timestamp": "2026-10-11T11:25:31.496841+00:00"
   }
 }

{ffbb_data_client-2.4.35 → ffbb_data_client-2.4.37}/src/ffbb_data_client/data/indexes.json

@@ -44,7 +44,7 @@
     },
     {
       "available": true,
-      "estimatedTotalHits": 549,
+      "estimatedTotalHits": 598,
       "indexUid": "ffbbnational_pratiques",
       "sampleKeys": [
         "_geo",
@@ -101,7 +101,7 @@
     },
     {
       "available": true,
-      "estimatedTotalHits": 4329,
+      "estimatedTotalHits": 4379,
       "indexUid": "ffbbnational_rss",
       "sampleKeys": [
         "categories",
@@ -131,7 +131,7 @@
     },
     {
       "available": true,
-      "estimatedTotalHits": 2994,
+      "estimatedTotalHits": 3166,
       "indexUid": "ffbbserver_competitions",
       "sampleKeys": [
         "age",
@@ -211,7 +211,7 @@
     },
     {
       "available": true,
-      "estimatedTotalHits": 150,
+      "estimatedTotalHits": 145,
       "indexUid": "ffbbserver_formations",
       "sampleKeys": [
         "certification",
@@ -374,7 +374,7 @@
     },
     {
       "available": true,
-      "estimatedTotalHits": 16,
+      "estimatedTotalHits": 32,
       "indexUid": "ffbbserver_tournois",
       "sampleKeys": [
         "_geo",
@@ -429,7 +429,7 @@
     },
     {
       "available": true,
-      "estimatedTotalHits": 4,
+      "estimatedTotalHits": 5,
       "indexUid": "ffbbsite_jobs",
       "sampleKeys": [
         "asset",
@@ -474,7 +474,7 @@
     },
     {
       "available": true,
-      "estimatedTotalHits": 6332,
+      "estimatedTotalHits": 6382,
       "indexUid": "ffbbsite_news",
       "sampleKeys": [
         "author",
@@ -533,7 +533,7 @@
     },
     {
       "available": true,
-      "estimatedTotalHits": 1863,
+      "estimatedTotalHits": 1868,
       "indexUid": "youtube_videos",
       "sampleKeys": [
         "channelId",
@@ -566,7 +566,7 @@
   ],
   "metadata": {
     "source": "https://meilisearch-prod.ffbb.app/multi-search",
-    "timestamp": "2026-10-01T07:34:29.224713+00:00"
+    "timestamp": "2026-10-11T11:25:31.496841+00:00"
   },
   "unavailable_indexes": [
     {

{ffbb_data_client-2.4.35 → ffbb_data_client-2.4.37/src/ffbb_data_client}/data/permission_matrix.json

@@ -1,11 +1,18 @@
 {
   "drift": {
-    "added": [
-      "config_noauth_ipv4",
-      "config_noauth_ipv6",
-      "config_tripwire_okhttp_ipv4"
+    "added": [],
+    "flips": [
+      {
+        "after": "error:ConnectError",
+        "before": "ok",
+        "probe": "config_noauth_ipv6"
+      },
+      {
+        "after": "ok",
+        "before": "blocked_cdn",
+        "probe": "config_tripwire_okhttp_ipv4"
+      }
     ],
-    "flips": [],
     "removed": []
   },
   "metadata": {
@@ -13,7 +20,7 @@
     "archived_competition_id": "200000002872733",
     "canary_season": "2026-2027",
     "current_competition_id": "200000002900744",
-    "timestamp": "2026-10-10T14:44:42.901605+00:00",
+    "timestamp": "2026-10-11T11:25:49.373634+00:00",
     "token_source": "public-fallback"
   },
   "probes": [
@@ -32,17 +39,18 @@
       "url": "https://api.ffbb.app/items/configuration"
     },
     {
+      "detail": "[Errno 101] Network is unreachable",
       "name": "config_noauth_ipv6",
       "notes": "Public endpoint sans auth en IPv6 strict.",
-      "outcome": "ok",
-      "status": 200,
+      "outcome": "error:ConnectError",
+      "status": null,
       "url": "https://api.ffbb.app/items/configuration"
     },
     {
       "name": "config_tripwire_okhttp_ipv4",
       "notes": "Canari sentinelle okhttp sur IPv4 : attendu blocked_cdn (alerte si débloqué ou si la règle change).",
-      "outcome": "blocked_cdn",
-      "status": 403,
+      "outcome": "ok",
+      "status": 200,
       "url": "https://api.ffbb.app/items/configuration"
     },
     {

{ffbb_data_client-2.4.35 → ffbb_data_client-2.4.37}/src/ffbb_data_client/utils/cache_manager.py

@@ -12,6 +12,7 @@ This module provides sophisticated caching strategies including:
 from __future__ import annotations
 
 import hashlib
+import os
 import threading
 from dataclasses import dataclass
 from typing import Any, cast
@@ -170,6 +171,7 @@ class CacheManager:
         # ⚡ Optimisation des performances réseau : connection pooling robuste pour HTTPX
         # Permet de maintenir les sockets TLS chauds et d'éviter les handshakes répétés
         limits = httpx.Limits(max_keepalive_connections=50, max_connections=200)
+        proxy = os.getenv("HTTPS_PROXY") or os.getenv("HTTP_PROXY") or None
 
         if self.config.backend == "memory":
             import sqlite3
@@ -185,7 +187,7 @@ class CacheManager:
                 storage=storage,
                 policy=policy,
                 transport=httpx.HTTPTransport(
-                    retries=self.config.transport_retries, limits=limits
+                    retries=self.config.transport_retries, limits=limits, proxy=proxy
                 ),
             )
             # Async version uses its own connection
@@ -196,7 +198,7 @@ class CacheManager:
                 storage=async_storage,
                 policy=policy,
                 transport=httpx.AsyncHTTPTransport(
-                    retries=self.config.transport_retries, limits=limits
+                    retries=self.config.transport_retries, limits=limits, proxy=proxy
                 ),
             )
         elif self.config.backend == "sqlite":
@@ -209,7 +211,7 @@ class CacheManager:
                 storage=storage,
                 policy=policy,
                 transport=httpx.HTTPTransport(
-                    retries=self.config.transport_retries, limits=limits
+                    retries=self.config.transport_retries, limits=limits, proxy=proxy
                 ),
             )
             # Async version uses its own database file
@@ -221,7 +223,7 @@ class CacheManager:
                 storage=async_storage,
                 policy=policy,
                 transport=httpx.AsyncHTTPTransport(
-                    retries=self.config.transport_retries, limits=limits
+                    retries=self.config.transport_retries, limits=limits, proxy=proxy
                 ),
             )
         else: