diffusers/main/fr/api/logging.md

Journalisation

🤗 Diffusers dispose d'un système de journalisation centralisé pour gérer facilement la verbosité de la bibliothèque. La verbosité par défaut est définie sur WARNING.

Pour modifier le niveau de verbosité, utilisez l’un des setters directs. Par exemple, pour passer la verbosité au niveau INFO.

import diffusers

diffusers.logging.set_verbosity_info()

Vous pouvez également utiliser la variable d'environnement DIFFUSERS_VERBOSITY pour remplacer le niveau de verbosité par défaut. Vous pouvez la définir sur l'une des valeurs suivantes : debug, info, warning, error, critical. Par exemple :

DIFFUSERS_VERBOSITY=error ./myprogram.py

De plus, certains warnings peuvent être désactivés en définissant la variable d'environnement DIFFUSERS_NO_ADVISORY_WARNINGS sur une valeur vraie, comme 1. Cela désactive tout avertissement journalisé par logger.warning_advice. Par exemple :

DIFFUSERS_NO_ADVISORY_WARNINGS=1 ./myprogram.py

Voici un exemple d'utilisation du même journaliseur que la bibliothèque dans votre propre module ou script :

from diffusers.utils import logging

logging.set_verbosity_info()
logger = logging.get_logger("diffusers")
logger.info("INFO")
logger.warning("WARN")

Toutes les méthodes du module de journalisation sont documentées ci-dessous. Les principales méthodes sont logging.get_verbosity pour obtenir le niveau de verbosité actuel du journaliseur et logging.set_verbosity pour définir la verbosité au niveau de votre choix.

Par ordre croissant de verbosité :

Méthode	Valeur entière	Description
diffusers.logging.CRITICAL ou diffusers.logging.FATAL	50	ne signaler que les erreurs les plus critiques
diffusers.logging.ERROR	40	ne signaler que les erreurs
diffusers.logging.WARNING ou diffusers.logging.WARN	30	ne signaler que les erreurs et les avertissements (par défaut)
diffusers.logging.INFO	20	ne signaler que les erreurs, les avertissements et les informations de base
diffusers.logging.DEBUG	10	signaler toutes les informations

Par défaut, les barres de progression tqdm sont affichées lors du téléchargement du modèle. logging.disable_progress_bar et logging.enable_progress_bar sont utilisés pour activer ou désactiver ce comportement.

Définitions de base[[diffusers.utils.logging.set_verbosity_error]]

diffusers.utils.logging.set_verbosity_error[[diffusers.utils.logging.set_verbosity_error]]

diffusers.utils.logging.set_verbosity_error()

Source

Définissez la verbosité au niveau ERROR.

diffusers.utils.logging.set_verbosity_warning[[diffusers.utils.logging.set_verbosity_warning]]

diffusers.utils.logging.set_verbosity_warning()

Source

Définissez la verbosité au niveau WARNING.

diffusers.utils.logging.set_verbosity_info[[diffusers.utils.logging.set_verbosity_info]]

diffusers.utils.logging.set_verbosity_info()

Source

Définissez la verbosité au niveau INFO.

diffusers.utils.logging.set_verbosity_debug[[diffusers.utils.logging.set_verbosity_debug]]

diffusers.utils.logging.set_verbosity_debug()

Source

Définissez la verbosité au niveau DEBUG.

Autres fonctions[[diffusers.utils.logging.get_verbosity]]

diffusers.utils.logging.get_verbosity[[diffusers.utils.logging.get_verbosity]]

diffusers.utils.logging.get_verbosity()

Source

Retourne : int

Niveaux de journalisation entiers pouvant être l'un des éléments suivants :

• 50 : diffusers.logging.CRITICAL ou diffusers.logging.FATAL
• 40: diffusers.logging.ERROR
• 30 : diffusers.logging.WARNING ou diffusers.logging.WARN
• 20: diffusers.logging.INFO
• 10: diffusers.logging.DEBUG

Retourne le niveau actuel du journal racine de 🤗 Diffusers en tant qu'int.

diffusers.utils.logging.set_verbosity[[diffusers.utils.logging.set_verbosity]]

diffusers.utils.logging.set_verbosity(verbosity: int)

Source

Paramètres :

verbosity (int) : Niveau de journalisation, qui peut être l'un des éléments suivants : - diffusers.logging.CRITICAL ou diffusers.logging.FATAL - diffusers.logging.ERROR - diffusers.logging.WARNING ou diffusers.logging.WARN - diffusers.logging.INFO - diffusers.logging.DEBUG

Définissez le niveau de verbosité du journal racine de 🤗 Diffusers.

diffusers.utils.get_logger[[diffusers.utils.get_logger]]

diffusers.utils.get_logger(name: str | None = None)

Source

Retourne un journal avec le nom spécifié.

Cette fonction n'est pas censée être accédée directement, sauf si vous écrivez un module diffusers personnalisé.

diffusers.utils.logging.enable_default_handler[[diffusers.utils.logging.enable_default_handler]]

diffusers.utils.logging.enable_default_handler()

Source

Activer le gestionnaire par défaut du journal racine de 🤗 Diffusers.

diffusers.utils.logging.disable_default_handler[[diffusers.utils.logging.disable_default_handler]]

diffusers.utils.logging.disable_default_handler()

Source

Désactiver le gestionnaire par défaut du journal racine de 🤗 Diffusers.

diffusers.utils.logging.enable_explicit_format[[diffusers.utils.logging.enable_explicit_format]]

diffusers.utils.logging.enable_explicit_format()

Source

Activer le formatage explicite pour chaque journal de 🤗 Diffusers. Le formatage explicite est le suivant :

[LEVELNAME|FILENAME|LINE NUMBER] TIME >> MESSAGE

Tous les gestionnaires actuellement liés à l'enregistreur racine sont affectés par cette méthode.

diffusers.utils.logging.reset_format[[diffusers.utils.logging.reset_format]]

diffusers.utils.logging.reset_format()

Source

Réinitialise la mise en forme des journalisateurs de 🤗 Diffusers.

Tous les gestionnaires actuellement liés à l'enregistreur racine sont affectés par cette méthode.

diffusers.utils.logging.enable_progress_bar[[diffusers.utils.logging.enable_progress_bar]]

diffusers.utils.logging.enable_progress_bar()

Source

Activer la barre de progression tqdm.

diffusers.utils.logging.disable_progress_bar[[diffusers.utils.logging.disable_progress_bar]]

diffusers.utils.logging.disable_progress_bar()

Source

Désactiver la barre de progression tqdm.