Documentation pour le module config_loader
Description
La fonction load_config est utilisée pour charger et lire les paramètres de configuration depuis un fichier JSON. Ces paramètres sont ensuite utilisés pour configurer des variables globales nécessaires au fonctionnement d'une application.
Détails de l'implémentation
- Fichier de configuration :
data/config.json - Format du fichier : JSON
Fonctionnalité
- Chargement du fichier de configuration :
- La fonction ouvre le fichier
data/config.jsonen mode lecture. -
Elle utilise la bibliothèque
jsonpour lire le contenu du fichier et le convertir en dictionnaire Python. -
Retour des données :
- La fonction retourne le dictionnaire Python chargé à partir du fichier JSON.
Variables globales
Après l'appel à load_config, les variables globales suivantes sont définies en utilisant les données du fichier de configuration et des variables d'environnement :
role_ping: Valeur extraite deconfig["role_ping"]role_ping_cdi: Valeur extraite deconfig["role_ping_cdi"]forum_channel_id: Valeur extraite deconfig["forum_channel_id"]forum_channel_id_cdi: Valeur extraite deconfig["forum_channel_id_cdi"]guild_id: Valeur extraite deconfig["guild_id"]discord_token: Valeur de la variable d'environnementTOKEN, obtenue viaos.getenv("TOKEN")
Exemples d'utilisation
# Charger les configurations
config = load_config()
# Accéder aux paramètres de configuration
print(config["role_ping"])
print(config["forum_channel_id"])
# Accéder aux variables globales
print(role_ping)
print(discord_token)
Gestion des erreurs
- La fonction
load_configsuppose que le fichierdata/config.jsonexiste et est bien formé. En cas d'absence du fichier ou de format incorrect, des exceptions (FileNotFoundError,json.JSONDecodeError) peuvent être levées. - La variable d'environnement
TOKENdoit être définie pour obtenir le jeton Discord. Sinon,discord_tokenseraNone.
Remarques
- Dépendances :
python-dotenv: Utilisé pour charger les variables d'environnement depuis un fichier.env.-
json: Utilisé pour lire les données du fichier de configuration en format JSON. -
Fichier
.env: -
Assurez-vous que le fichier
.envest présent et contient la variableTOKENavec une clé valide pour l'application Discord. -
Chemin du fichier :
- Le fichier de configuration est supposé être situé dans le répertoire
data. Modifiez le chemin si le fichier est stocké ailleurs.