Journalisation

🤗 Transformers dispose d'un système de journalisation centralisé, ce qui vous permet de configurer facilement le niveau de détail de la bibliothèque.

Actuellement, le niveau de verbosité par défaut de la bibliothèque est WARNING.

Pour modifier le niveau de verbosité, utilisez simplement l'un des setters directs. Par exemple, voici comment passer la verbosité au niveau INFO.

import transformers

transformers.logging.set_verbosity_info()

Vous pouvez également utiliser la variable d'environnement TRANSFORMERS_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, fatal. Par exemple :

TRANSFORMERS_VERBOSITY=error ./myprogram.py

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

TRANSFORMERS_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 transformers.utils import logging

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

Toutes les méthodes de ce module de journalisation sont documentées ci-dessous. Les principales 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. Dans l'ordre (du moins verbeux au plus verbeux), ces niveaux (avec leurs valeurs int correspondantes entre parenthèses) sont :

• transformers.logging.CRITICAL ou transformers.logging.FATAL (valeur entière, 50) : ne signale que les erreurs les plus critiques.
• transformers.logging.ERROR (valeur int, 40) : ne signale que les erreurs.
• transformers.logging.WARNING ou transformers.logging.WARN (valeur entière, 30) : ne signale que les erreurs et les avertissements. C'est le niveau par défaut utilisé par la bibliothèque.
• transformers.logging.INFO (valeur int, 20) : signale les erreurs, les avertissements et les informations de base.
• transformers.logging.DEBUG (valeur int, 10) : signale toutes les informations.

Par défaut, les barres de progression tqdm sont affichées pendant le téléchargement du modèle. logging.disable_progress_bar() et logging.enable_progress_bar() peuvent être utilisés pour supprimer ou réactiver ce comportement.

journalisation et avertissements

Python dispose de deux systèmes de journalisation souvent utilisés conjointement : logging, décrit ci-dessus, et warnings, qui permet de classer les avertissements dans des catégories spécifiques, par exemple FutureWarning pour une fonctionnalité ou un chemin déjà obsolète et DeprecationWarning pour signaler une obsolescence à venir.

Nous utilisons les deux dans la bibliothèque transformers. Nous exploitons et adaptons la méthode captureWarnings de logging pour permettre la gestion de ces messages d’avertissement par les paramètres de verbosité ci-dessus.

Que signifie cela pour les développeurs de la bibliothèque ? Nous devons respecter les heuristiques suivantes :

• warnings doivent être privilégiés par les développeurs de la bibliothèque et des bibliothèques dépendantes de transformers
• logging doit être utilisé par les utilisateurs finaux de la bibliothèque qui l’emploient dans leurs projets au quotidien

Voir la référence de la méthode captureWarnings ci-dessous.

Définitions de base

Autres fonctions

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