Official client for Blagues API
Project description
BlaguesAPI Python
Ce paquet Python fournit une interface simple pour intéragir avec Blagues API.
Important : Ce paquet ne fournit que des méthodes asynchrones.
Installation
Vous pouvez simplement ajouter la dépendance à votre projet depuis PyPI :
pip install blagues-api
Utilisation
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 renverront un objet Blagues
, 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.
Blague aléatoire
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"])
Blague aléatoire catégorisée
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")
Blague par identifiant
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.')
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for blagues_api-1.0.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | dc0af1e2c364105a71d1bf679262afd66f9a79aa378239c2e0afdd416ec5843b |
|
MD5 | 26301fe8f8e0a82c3f269a7195bf637b |
|
BLAKE2b-256 | 42772d5c532da3fce4cfcea187ababb8b7b0d8cd55926884e480765784927103 |