Metadata-Version: 2.5
Name: ffbb-api-python
Version: 2.4.34
Summary: API FFBB (Python SDK) — Client officiel et asynchrone pour l'API de la Fédération Française de BasketBall (clubs, classements, calendriers, scores live).
Project-URL: Homepage, https://ffbb-api.desimone.fr/
Project-URL: Documentation, https://ffbb-api.desimone.fr/docs
Project-URL: Repository, https://github.com/nickdesi/ffbb-data-client
Project-URL: Changelog, https://github.com/nickdesi/ffbb-data-client/blob/master/CHANGELOG.md
Author-email: Nicolas De Simone <nicolas.desimone@gmail.com>
License: Apache-2.0
Keywords: api-ffbb,async,basket-france,basketball,ffbb,ffbb api,ffbb-api,ffbb-api-client,ffbb-api-client-v2,live-scores,sdk
Classifier: Development Status :: 5 - Production/Stable
Classifier: Framework :: AsyncIO
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Natural Language :: French
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.10
Requires-Dist: ffbb-data-client>=2.4.34
Description-Content-Type: text/markdown

# 🏀 FFBB API (Python SDK) — ffbb-api-python

[![PyPI version](https://img.shields.io/pypi/v/ffbb-api-python?color=ff6b00&label=PyPI%20Release&logo=python&logoColor=white&style=for-the-badge)](https://pypi.org/project/ffbb-api-python/)
[![Python versions](https://img.shields.io/pypi/pyversions/ffbb-api-python?logo=python&logoColor=white&style=for-the-badge&color=238636)](https://pypi.org/project/ffbb-api-python/)
[![Documentation](https://img.shields.io/badge/Documentation-ffbb--api.desimone.fr-blue?style=for-the-badge&logo=googlechrome&logoColor=white)](https://ffbb-api.desimone.fr/)

**Le SDK Python moderne, asynchrone et typé pour exploiter l'API de la Fédération Française de BasketBall (FFBB).**

> 💡 **Ce package est le point d'entrée canonique pour l'API FFBB**, propulsé sous le capot par le moteur haute performance [`ffbb-data-client`](https://pypi.org/project/ffbb-data-client/).

---

## ⚡ Installation rapide

```bash
pip install ffbb-api-python
```

*(Installe automatiquement la dernière version de `ffbb-data-client`).*

---

## 🚀 Utilisation immédiate

```python
from ffbb_api import FFBBDataClient

# Client asynchrone prêt à l'emploi
client = FFBBDataClient.create()

# Recherche multi-index instantanée (Clubs, Poules, Salles, 3x3)
resultats = client.multi_search("Gerzat")
print(resultats)
```

---

## 🔄 Remplacement de `ffbb-api-client` et `ffbb-api-client-v2`

Si vous venez des anciens packages non maintenus :
1. Remplacez votre dépendance par `ffbb-api-python`.
2. Profitez du support **async/await**, des **scores live**, des **modèles Pydantic v2 validés** et de la **recherche Meilisearch sur 4 500+ clubs**.

Pour la documentation complète et le serveur Swagger en ligne, rendez-vous sur **[ffbb-api.desimone.fr](https://ffbb-api.desimone.fr/)**.
