Ce paquet Python fournit une interface simple pour intéragir avec Blagues API.
Important : Ce paquet ne fournit que des méthodes asynchrones.
Vous pouvez simplement ajouter la dépendance à votre projet depuis PyPI :
pip install blagues-api
Pour utiliser l'API, vous devez obtenir une clé gratuite sur le site officiel : https://www.blagues-api.fr/. Vous pourrez ensuite construire un objet BlaguesAPI :
from blagues_api import BlaguesAPI
blagues = BlaguesAPI("VOTRE_TOKEN_ICI")Toutes les méthodes excepté count renverront un objet Blague, qui permet d'accéder aux différentes propriétés renvoyées par l'API : id, type, joke, answer. En cas d'erreur, vous recevrez une erreur du type aiohttp.ClientResponseError.
Les diffĂ©rents types de blagues peuvent ĂȘtre reprĂ©sentĂ©s au choix sous forme d'un string ou d'un objet BlagueType (exemple: BlagueType.GENERAL). La liste des types disponibles est notĂ©e dans sur le site officiel.
await blagues.random()
# Blague(id=108, type=<BlagueType.GLOBAL: 'global'>, joke="C'est l'histoire d'un poil. Avant, il était bien.", answer='Maintenant, il est pubien.')Il est possible de spécifier des catégories à exclure :
await blagues.random(disallow=[BlagueType.LIMIT, BlagueType.BEAUF])
# Avec des strings
await blagues.random(disallow=["limit", "beauf"])await blagues.random_categorized(BlagueType.DEV)
# Blague(id=430, type=<BlagueType.DEV: 'dev'>, joke='De quelle couleur sont tes yeux ?', answer='#1292f4 et toi ?')
# Avec des strings
await blagues.random_categorized("dev")await blagues.from_id(20)
# Blague(id=20, type=<BlagueType.GLOBAL: 'global'>, joke="Qu'est-ce qu'un chou au milieu de l'océan ?", answer='Un chou marin.')await blagues.count()
# CountJoke(count=1730)La méthode ci-dessus renverra un objet CountJoke, qui permet d'accéder a la propriété renvoyée par l'API : count. En cas d'erreur, vous recevrez une erreur du type aiohttp.ClientResponseError.