ffbb-data-client 2.4.15__tar.gz → 2.4.16__tar.gz

{ffbb_data_client-2.4.15 → ffbb_data_client-2.4.16}/.github/workflows/ci.yml

@@ -60,8 +60,21 @@ jobs:
           pipx run --python '${{ steps.setup-python.outputs.python-path }}'
           tox -e type
 
+  dependency-audit:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0  # v7.0.0
+      - uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405  # v6.2.0
+        with:
+          python-version: "3.14"
+          cache: 'pip'
+      - name: Install package and auditor
+        run: python -m pip install . pip-audit
+      - name: Audit Python dependencies
+        run: python -m pip_audit
+
   build:
-    needs: [lint, type-check]
+    needs: [lint, type-check, dependency-audit]
     runs-on: ubuntu-latest
     outputs:
       wheel-distribution: ${{ steps.wheel-distribution.outputs.path }}

{ffbb_data_client-2.4.15 → ffbb_data_client-2.4.16}/.github/workflows/publish.yml

@@ -13,8 +13,45 @@ env:
   FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
 
 jobs:
+  verify:
+    name: Verify Python ${{ matrix.python }}
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - python: "3.10"
+            toxenv: py310
+          - python: "3.11"
+            toxenv: py311
+          - python: "3.12"
+            toxenv: py312
+          - python: "3.13"
+            toxenv: py313
+          - python: "3.14"
+            toxenv: py314
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v7
+        with:
+          fetch-depth: 0
+      - name: Set up Python
+        uses: actions/setup-python@v6
+        id: setup-python
+        with:
+          python-version: ${{ matrix.python }}
+          cache: 'pip'
+      - name: Run test suite
+        env:
+          API_FFBB_APP_BEARER_TOKEN: ${{ secrets.API_FFBB_APP_BEARER_TOKEN }}
+          MEILISEARCH_BEARER_TOKEN: ${{ secrets.MEILISEARCH_BEARER_TOKEN }}
+        run: >-
+          pipx run --python '${{ steps.setup-python.outputs.python-path }}'
+          tox -e ${{ matrix.toxenv }}
+
   build:
     name: Build distribution
+    needs: verify
     runs-on: ubuntu-latest
     permissions:
       attestations: write

{ffbb_data_client-2.4.15 → ffbb_data_client-2.4.16}/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 : ~18803 lignes de code
-> (clients: 5980, models: 9805, utils: 2003, helpers: 1015)
+> Dernière mise à jour : ffbb-data-client | SDK total : ~19037 lignes de code
+> (clients: 6014, models: 9806, utils: 2061, helpers: 1156)
 
 ## Langue
 Tous les documents de travail (walkthrough.md, implementation_plan.md) DOIVENT être en français.
@@ -40,10 +40,9 @@ ou interroge l'API publique en cache en cas d'absence :
   documentation (`AGENTS.md`), de site/landing page ou autres tâches de synchronisation de
   manière autonome. Si vous estimez qu'une mise à jour automatique est pertinente ou non, prenez
   la décision par vous-même sans attendre la validation explicite de l'utilisateur.
-- **Protocole Strict Pre-Commit & Re-Stage (Zéro échec de CI)** :
-  1. Toujours appliquer `.rstrip() + "\n"` dans les générateurs de fichiers (RST, MD, JSON).
-  2. Exécuter systématiquement `rtk pre-commit run --all-files`.
-  3. Si un hook (end-of-file-fixer, black, isort...) modifie un fichier sur disque : **OBLIGATION de ré-indexer (`rtk git add -u`) et de ré-exécuter `rtk pre-commit run --all-files`** jusqu'à un passage 100% propre avant de créer le commit (`git commit`).
+- **Validation pre-commit systématique (Zéro échec de CI)** : Pour éviter tout échec de build ou de formatage en CI,
+  exécutez systématiquement la validation complète locale via `rtk pre-commit run --all-files` avant de pousser
+  tout commit vers origin. Résolvez toutes les alertes (formatage, imports `isort`, typage) localement.
 
 
 ## Karpathy Guidelines (Règles de développement)
@@ -70,13 +69,13 @@ 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 (≈5980 lignes)
+├── clients/               # Clients d'API (REST et Meilisearch) et façades (≈6014 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 (≈1015 lignes)
-├── models/                # Modèles de données Pydantic type-safe (≈9805 lignes)
+├── helpers/               # Méthodes utilitaires pour requêtes HTTP et mapping (≈1156 lignes)
+├── models/                # Modèles de données Pydantic type-safe (≈9806 lignes)
 ├── py.typed               # Marqueur pour la compatibilité avec mypy
-└── utils/                 # Gestionnaires transversaux (cache, jetons de sécurité, validation) (≈2003 lignes)
+└── utils/                 # Gestionnaires transversaux (cache, jetons de sécurité, validation) (≈2061 lignes)
 ```
 
 ## Conventions de code

{ffbb_data_client-2.4.15 → ffbb_data_client-2.4.16}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ffbb-data-client
-Version: 2.4.15
+Version: 2.4.16
 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
@@ -94,7 +94,7 @@ Dynamic: license-file
 `ffbb_data_client` simplifie l'accès aux API FFBB et à leurs index Meilisearch avec :
 
 - une façade unique : `FFBBDataClient` ;
-- des modèles Pydantic v2 typés ;
+- des modèles typés, avec validation Pydantic v2 sur les contrats sensibles ;
 - une API utilisable en synchrone ou en `async/await` ;
 - une gestion automatique des tokens via `TokenManager` ;
 - du cache HTTP configurable via `hishel` ;
@@ -154,7 +154,7 @@ lives = client.get_lives()
 | API FFBB | clubs, compétitions, organismes, saisons, poules, classements, rencontres, lives |
 | Entités additionnelles | EDF (matches, joueurs, rosters, équipes), Genius Sport, Rematch Videos |
 | Recherche | organismes, compétitions, rencontres, salles, terrains, pratiques, tournois, engagements et formations |
-| REST typé | récupération de ressources individuelles avec modèles Pydantic v2 |
+| REST typé | récupération de ressources individuelles avec modèles typés et conversion contrôlée |
 | Async | méthodes `*_async()` — source de vérité ; sync délègue via `_run_async()` |
 | Cache | cache HTTP `hishel`, sessions `httpx` réutilisées, retries configurables, SQLite séparés sync/async |
 | Sécurité | masquage des tokens dans les logs, CodeQL scanning, Dependabot |
@@ -229,7 +229,7 @@ entraineur = client.get_entraineur(44444)
 
 Les assets Directus et autres collections peuvent être exploités via les méthodes REST/listing dédiées exposées par le client lorsque disponibles.
 
-Les réponses sont converties en modèles Pydantic lorsque le schéma est connu, ce qui apporte validation, autocomplétion et sérialisation propre.
+Les réponses sont converties en modèles typés lorsque le schéma est connu. Les contrats sensibles, notamment la configuration des tokens, utilisent une validation Pydantic stricte.
 
 ---
 
@@ -283,7 +283,7 @@ src/ffbb_data_client/
 │   ├── 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
-├── models/                        # Modèles Pydantic v2
+├── models/                        # Modèles typés (dataclasses et Pydantic v2)
 ├── utils/                         # cache (sync/async séparés), tokens, logging sécurisé
 └── data/                          # schémas et métadonnées embarqués
 ```

{ffbb_data_client-2.4.15 → ffbb_data_client-2.4.16}/README.md

@@ -38,7 +38,7 @@
 `ffbb_data_client` simplifie l'accès aux API FFBB et à leurs index Meilisearch avec :
 
 - une façade unique : `FFBBDataClient` ;
-- des modèles Pydantic v2 typés ;
+- des modèles typés, avec validation Pydantic v2 sur les contrats sensibles ;
 - une API utilisable en synchrone ou en `async/await` ;
 - une gestion automatique des tokens via `TokenManager` ;
 - du cache HTTP configurable via `hishel` ;
@@ -98,7 +98,7 @@ lives = client.get_lives()
 | API FFBB | clubs, compétitions, organismes, saisons, poules, classements, rencontres, lives |
 | Entités additionnelles | EDF (matches, joueurs, rosters, équipes), Genius Sport, Rematch Videos |
 | Recherche | organismes, compétitions, rencontres, salles, terrains, pratiques, tournois, engagements et formations |
-| REST typé | récupération de ressources individuelles avec modèles Pydantic v2 |
+| REST typé | récupération de ressources individuelles avec modèles typés et conversion contrôlée |
 | Async | méthodes `*_async()` — source de vérité ; sync délègue via `_run_async()` |
 | Cache | cache HTTP `hishel`, sessions `httpx` réutilisées, retries configurables, SQLite séparés sync/async |
 | Sécurité | masquage des tokens dans les logs, CodeQL scanning, Dependabot |
@@ -173,7 +173,7 @@ entraineur = client.get_entraineur(44444)
 
 Les assets Directus et autres collections peuvent être exploités via les méthodes REST/listing dédiées exposées par le client lorsque disponibles.
 
-Les réponses sont converties en modèles Pydantic lorsque le schéma est connu, ce qui apporte validation, autocomplétion et sérialisation propre.
+Les réponses sont converties en modèles typés lorsque le schéma est connu. Les contrats sensibles, notamment la configuration des tokens, utilisent une validation Pydantic stricte.
 
 ---
 
@@ -227,7 +227,7 @@ src/ffbb_data_client/
 │   ├── 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
-├── models/                        # Modèles Pydantic v2
+├── models/                        # Modèles typés (dataclasses et Pydantic v2)
 ├── utils/                         # cache (sync/async séparés), tokens, logging sécurisé
 └── data/                          # schémas et métadonnées embarqués
 ```

{ffbb_data_client-2.4.15 → ffbb_data_client-2.4.16}/docs/architecture.rst

@@ -64,7 +64,8 @@ Usage:
 
 .. code-block:: python
 
-    from ffbb_data_client import Live, MultiSearchQuery, CompetitionType
+    from ffbb_data_client import MultiSearchQuery
+    from ffbb_data_client.models import CompetitionType, Live
 
     # Create search queries
     query = MultiSearchQuery("basketball")

{ffbb_data_client-2.4.15 → ffbb_data_client-2.4.16}/docs/examples.rst

@@ -77,7 +77,7 @@ Cache Management
     from ffbb_data_client.utils.cache_manager import CacheManager
 
     # Clear token cache
-    CacheManager().clear()
+    CacheManager().clear_cache()
 
 Configuration Management (v1.2.0+)
 ====================================
@@ -296,8 +296,7 @@ Robust Error Handling
 
 .. code-block:: python
 
-    from ffbb_data_client import FFBBDataClient
-    import requests
+    from ffbb_data_client import FFBBDataClient, FFBBError
 
     try:
         client = FFBBDataClient.create(MEILISEARCH_TOKEN, API_TOKEN)
@@ -307,8 +306,8 @@ Robust Error Handling
 
     except ValueError as e:
         print(f"Configuration error: {e}")
-    except requests.RequestException as e:
-        print(f"Network error: {e}")
+    except FFBBError as e:
+        print(f"FFBB error: {e}")
     except Exception as e:
         print(f"Unexpected error: {e}")
 
@@ -320,30 +319,18 @@ Using Cached Sessions
 
 .. code-block:: python
 
-    from requests_cache import CachedSession
     from ffbb_data_client import FFBBDataClient
+    from ffbb_data_client.utils.cache_manager import CacheConfig, CacheManager
 
-    # Create custom cached session
-    cached_session = CachedSession(
-        'ffbb_cache',
-        backend='sqlite',
-        expire_after=3600  # 1 hour cache
-    )
-
-    # Create client with custom session
-    api_client = ApiFFBBAppClient(
-        bearer_token=API_TOKEN,
-        cached_session=cached_session
-    )
+    cache = CacheManager(CacheConfig(backend="sqlite", expire_after=3600))
 
-    meilisearch_client = MeilisearchFFBBClient(
-        bearer_token=MEILISEARCH_TOKEN,
-        cached_session=cached_session
+    client = FFBBDataClient.create(
+        api_bearer_token=API_TOKEN,
+        meilisearch_bearer_token=MEILISEARCH_TOKEN,
+        cached_session=cache.session,
+        async_cached_session=cache.async_session,
     )
 
-    # Create main client
-    client = FFBBDataClient(api_client, meilisearch_client)
-
 Data Export and Processing
 ==========================
 

{ffbb_data_client-2.4.15 → ffbb_data_client-2.4.16}/docs/migration.rst

@@ -102,12 +102,12 @@ Migration from v1.1.x to v1.2.0 (Upcoming)
     tokens = TokenManager.get_tokens(use_cache=False)
 
     # Use CacheManager directly for cache operations
-    CacheManager().clear()
+    CacheManager().clear_cache()
 
 **Migration Steps:**
 
 1. Update TokenManager.get_tokens() calls to use cache_config parameter
-2. Replace TokenManager.clear_cache() with CacheManager().clear()
+2. Replace TokenManager.clear_cache() with CacheManager().clear_cache()
 3. Import CacheManager from ffbb_data_client.utils.cache_manager
 
 ---
@@ -165,4 +165,4 @@ Token Management Updates
     # After v1.2.0
     tokens = TokenManager.get_tokens(use_cache=False)
     from ffbb_data_client.utils.cache_manager import CacheManager
-    CacheManager().clear()
+    CacheManager().clear_cache()

{ffbb_data_client-2.4.15 → ffbb_data_client-2.4.16}/docs/requirements.txt

@@ -4,7 +4,6 @@ pydantic>=2.13.4
 python-dateutil>=2.9.0.post0
 python-dotenv>=1.2.2
 readme_renderer[md]>=44.0
-requests_cache
 # Requirements file for ReadTheDocs, check .readthedocs.yml.
 # To build the module reference correctly, make sure every external package
 # under `install_requires` in `setup.cfg` is also listed here!

{ffbb_data_client-2.4.15 → ffbb_data_client-2.4.16}/src/ffbb_data_client/__init__.py

@@ -10,6 +10,16 @@ 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 .exceptions import (
+    FFBBAuthenticationError,
+    FFBBError,
+    FFBBHTTPError,
+    FFBBNotFoundError,
+    FFBBRateLimitError,
+    FFBBResponseValidationError,
+    FFBBServerError,
+    FFBBTransportError,
+)
 from .helpers.meilisearch_client_extension import MeilisearchClientExtension
 from .helpers.multi_search_query_helper import generate_queries
 from .models.club_contacts import ClubContacts
@@ -76,6 +86,15 @@ __all__ = [
     "FFBBDataClient",
     "MeilisearchClient",
     "MeilisearchFFBBClient",
+    # Exceptions
+    "FFBBError",
+    "FFBBHTTPError",
+    "FFBBNotFoundError",
+    "FFBBAuthenticationError",
+    "FFBBRateLimitError",
+    "FFBBServerError",
+    "FFBBTransportError",
+    "FFBBResponseValidationError",
     # Helpers
     "MeilisearchClientExtension",
     "generate_queries",

{ffbb_data_client-2.4.15 → ffbb_data_client-2.4.16}/src/ffbb_data_client/api.py

@@ -8,6 +8,7 @@ from __future__ import annotations
 
 import asyncio
 import logging
+import os
 import re
 import time
 from collections import OrderedDict
@@ -112,11 +113,18 @@ l'ensemble des données publiques de la **Fédération Française de BasketBall*
     lifespan=lifespan,
 )
 
-# Enable CORS for all origins
+_cors_origins = [
+    origin.strip()
+    for origin in os.getenv(
+        "FFBB_CORS_ORIGINS", "http://localhost:3000,http://localhost:8000"
+    ).split(",")
+    if origin.strip()
+]
+
 app.add_middleware(
     CORSMiddleware,
-    allow_origins=["*"],
-    allow_credentials=True,
+    allow_origins=_cors_origins,
+    allow_credentials=False,
     allow_methods=["*"],
     allow_headers=["*"],
 )

{ffbb_data_client-2.4.15 → ffbb_data_client-2.4.16}/src/ffbb_data_client/clients/_mixins/competition.py

@@ -10,6 +10,7 @@ from ...config import (
     ENDPOINT_POULES,
     ENDPOINT_SAISONS,
 )
+from ...exceptions import FFBBNotFoundError
 from ...helpers.http_requests_utils import http_get_json_async, url_with_params
 from ...models.field_set import FieldSet
 from ...models.get_competition_response import GetCompetitionResponse
@@ -75,13 +76,13 @@ class CompetitionMixin:
                 final_url,
                 self.headers,
                 debug=self.debug,
-                cached_session=self.async_cached_session or self.async_cached_session,
+                cached_session=cached_session or self.async_cached_session,
             )
             actual_data = data.get("data") if data and isinstance(data, dict) else data
             if actual_data:
                 return GetCompetitionResponse.from_dict(actual_data)
             return None
-        except Exception as e:
+        except FFBBNotFoundError as e:
             if self.debug:
                 self.logger.error(f"Error in get_competition_async: {e}")
             return None
@@ -129,13 +130,13 @@ class CompetitionMixin:
                 final_url,
                 self.headers,
                 debug=self.debug,
-                cached_session=self.async_cached_session or self.async_cached_session,
+                cached_session=cached_session or self.async_cached_session,
             )
             actual_data = data.get("data") if data and isinstance(data, dict) else data
             if actual_data:
                 return GetPouleResponse.from_dict(actual_data)
             return None
-        except Exception as e:
+        except FFBBNotFoundError as e:
             if self.debug:
                 self.logger.error(f"Error in get_poule_async: {e}")
             return None
@@ -205,13 +206,13 @@ class CompetitionMixin:
                 final_url,
                 self.headers,
                 debug=self.debug,
-                cached_session=self.async_cached_session or self.async_cached_session,
+                cached_session=cached_session or self.async_cached_session,
             )
             actual_data = data.get("data") if data and isinstance(data, dict) else data
             if actual_data and isinstance(actual_data, list):
                 return GetSaisonsResponse.from_list(actual_data)
             return []
-        except Exception as e:
+        except FFBBNotFoundError as e:
             if self.debug:
                 self.logger.error(f"Error in get_saisons_async: {e}")
             return []

{ffbb_data_client-2.4.15 → ffbb_data_client-2.4.16}/src/ffbb_data_client/clients/_mixins/getters.py

@@ -21,6 +21,7 @@ from ...config import (
     ENDPOINT_TERRAINS,
     ENDPOINT_TOURNOIS,
 )
+from ...exceptions import FFBBNotFoundError
 from ...helpers.http_requests_utils import http_get_json_async, url_with_params
 from ...models.configuration_models import GetConfigurationResponse
 from ...models.get_commune_response import GetCommuneResponse
@@ -83,11 +84,11 @@ class GettersMixin:
                 final_url,
                 self.headers,
                 debug=self.debug,
-                cached_session=self.async_cached_session or self.async_cached_session,
+                cached_session=cached_session or self.async_cached_session,
                 retry_config=self.retry_config,
                 timeout_config=self.timeout_config,
             )
-        except Exception as e:
+        except FFBBNotFoundError as e:
             if self.debug:
                 self.logger.error(f"Error in _get_directus_item_async: {e}")
             return None
@@ -149,11 +150,11 @@ class GettersMixin:
                 final_url,
                 self.headers,
                 debug=self.debug,
-                cached_session=self.async_cached_session or self.async_cached_session,
+                cached_session=cached_session or self.async_cached_session,
                 retry_config=self.retry_config,
                 timeout_config=self.timeout_config,
             )
-        except Exception as e:
+        except FFBBNotFoundError as e:
             if self.debug:
                 self.logger.error(f"Error in _list_directus_items_async: {e}")
             return []
@@ -182,12 +183,12 @@ class GettersMixin:
                 url,
                 self.headers,
                 debug=self.debug,
-                cached_session=self.async_cached_session or self.async_cached_session,
+                cached_session=cached_session or self.async_cached_session,
                 retry_config=self.retry_config,
                 timeout_config=self.timeout_config,
             )
             return data if isinstance(data, dict) else None
-        except Exception as e:
+        except FFBBNotFoundError as e:
             if self.debug:
                 self.logger.error(f"Error in get_openapi_spec_async: {e}")
             return None
@@ -210,7 +211,7 @@ class GettersMixin:
                 url,
                 self.headers,
                 debug=self.debug,
-                cached_session=self.async_cached_session or self.async_cached_session,
+                cached_session=cached_session or self.async_cached_session,
                 retry_config=self.retry_config,
                 timeout_config=self.timeout_config,
             )
@@ -220,7 +221,7 @@ class GettersMixin:
                 if not isinstance(raw_data, list):
                     return []
                 return lives_from_dict(raw_data)
-        except Exception as e:
+        except FFBBNotFoundError as e:
             if self.debug:
                 self.logger.error(f"Error in get_lives_async: {e}")
         return None
@@ -247,7 +248,7 @@ class GettersMixin:
                 url,
                 self.headers,
                 debug=self.debug,
-                cached_session=self.async_cached_session or self.async_cached_session,
+                cached_session=cached_session or self.async_cached_session,
                 retry_config=self.retry_config,
                 timeout_config=self.timeout_config,
             )
@@ -255,7 +256,7 @@ class GettersMixin:
             if actual_data:
                 return GetConfigurationResponse.from_dict(actual_data)
             return None
-        except Exception as e:
+        except FFBBNotFoundError as e:
             if self.debug:
                 self.logger.error(f"Error in get_configuration_async: {e}")
             return None
@@ -282,11 +283,11 @@ class GettersMixin:
                 url,
                 self.headers,
                 debug=self.debug,
-                cached_session=self.async_cached_session or self.async_cached_session,
+                cached_session=cached_session or self.async_cached_session,
             )
             actual_data = data.get("data") if data and isinstance(data, dict) else data
             return GetRencontreResponse.from_dict(actual_data) if actual_data else None
-        except Exception as e:
+        except FFBBNotFoundError as e:
             if self.debug:
                 self.logger.error(f"Error in get_rencontre_async: {e}")
             return None
@@ -309,11 +310,11 @@ class GettersMixin:
                 url,
                 self.headers,
                 debug=self.debug,
-                cached_session=self.async_cached_session or self.async_cached_session,
+                cached_session=cached_session or self.async_cached_session,
             )
             actual_data = data.get("data") if data and isinstance(data, dict) else data
             return GetEngagementResponse.from_dict(actual_data) if actual_data else None
-        except Exception as e:
+        except FFBBNotFoundError as e:
             if self.debug:
                 self.logger.error(f"Error in get_engagement_async: {e}")
             return None
@@ -340,11 +341,11 @@ class GettersMixin:
                 url,
                 self.headers,
                 debug=self.debug,
-                cached_session=self.async_cached_session or self.async_cached_session,
+                cached_session=cached_session or self.async_cached_session,
             )
             actual_data = data.get("data") if data and isinstance(data, dict) else data
             return GetFormationResponse.from_dict(actual_data) if actual_data else None
-        except Exception as e:
+        except FFBBNotFoundError as e:
             if self.debug:
                 self.logger.error(f"Error in get_formation_async: {e}")
             return None
@@ -367,11 +368,11 @@ class GettersMixin:
                 url,
                 self.headers,
                 debug=self.debug,
-                cached_session=self.async_cached_session or self.async_cached_session,
+                cached_session=cached_session or self.async_cached_session,
             )
             actual_data = data.get("data") if data and isinstance(data, dict) else data
             return GetEntraineurResponse.from_dict(actual_data) if actual_data else None
-        except Exception as e:
+        except FFBBNotFoundError as e:
             if self.debug:
                 self.logger.error(f"Error in get_entraineur_async: {e}")
             return None
@@ -398,11 +399,11 @@ class GettersMixin:
                 url,
                 self.headers,
                 debug=self.debug,
-                cached_session=self.async_cached_session or self.async_cached_session,
+                cached_session=cached_session or self.async_cached_session,
             )
             actual_data = data.get("data") if data and isinstance(data, dict) else data
             return GetCommuneResponse.from_dict(actual_data) if actual_data else None
-        except Exception as e:
+        except FFBBNotFoundError as e:
             if self.debug:
                 self.logger.error(f"Error in get_commune_async: {e}")
             return None
@@ -425,11 +426,11 @@ class GettersMixin:
                 url,
                 self.headers,
                 debug=self.debug,
-                cached_session=self.async_cached_session or self.async_cached_session,
+                cached_session=cached_session or self.async_cached_session,
             )
             actual_data = data.get("data") if data and isinstance(data, dict) else data
             return GetOfficielResponse.from_dict(actual_data) if actual_data else None
-        except Exception as e:
+        except FFBBNotFoundError as e:
             if self.debug:
                 self.logger.error(f"Error in get_officiel_async: {e}")
             return None
@@ -452,11 +453,11 @@ class GettersMixin:
                 url,
                 self.headers,
                 debug=self.debug,
-                cached_session=self.async_cached_session or self.async_cached_session,
+                cached_session=cached_session or self.async_cached_session,
             )
             actual_data = data.get("data") if data and isinstance(data, dict) else data
             return GetSalleResponse.from_dict(actual_data) if actual_data else None
-        except Exception as e:
+        except FFBBNotFoundError as e:
             if self.debug:
                 self.logger.error(f"Error in get_salle_async: {e}")
             return None
@@ -479,11 +480,11 @@ class GettersMixin:
                 url,
                 self.headers,
                 debug=self.debug,
-                cached_session=self.async_cached_session or self.async_cached_session,
+                cached_session=cached_session or self.async_cached_session,
             )
             actual_data = data.get("data") if data and isinstance(data, dict) else data
             return GetTerrainResponse.from_dict(actual_data) if actual_data else None
-        except Exception as e:
+        except FFBBNotFoundError as e:
             if self.debug:
                 self.logger.error(f"Error in get_terrain_async: {e}")
             return None
@@ -506,11 +507,11 @@ class GettersMixin:
                 url,
                 self.headers,
                 debug=self.debug,
-                cached_session=self.async_cached_session or self.async_cached_session,
+                cached_session=cached_session or self.async_cached_session,
             )
             actual_data = data.get("data") if data and isinstance(data, dict) else data
             return GetTournoiResponse.from_dict(actual_data) if actual_data else None
-        except Exception as e:
+        except FFBBNotFoundError as e:
             if self.debug:
                 self.logger.error(f"Error in get_tournoi_async: {e}")
             return None
@@ -533,11 +534,11 @@ class GettersMixin:
                 url,
                 self.headers,
                 debug=self.debug,
-                cached_session=self.async_cached_session or self.async_cached_session,
+                cached_session=cached_session or self.async_cached_session,
             )
             actual_data = data.get("data") if data and isinstance(data, dict) else data
             return GetPratiqueResponse.from_dict(actual_data) if actual_data else None
-        except Exception as e:
+        except FFBBNotFoundError as e:
             if self.debug:
                 self.logger.error(f"Error in get_pratique_async: {e}")
             return None