# 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`.

```python
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 :

```bash
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 :

```bash
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 :

```python
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]]

```python
diffusers.utils.logging.set_verbosity_error()
```

[Source](https://github.com/huggingface/diffusers/blob/v0.43.0/src/diffusers/utils/logging.py#L201)

Définissez la verbosité au niveau `ERROR`.

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

```python
diffusers.utils.logging.set_verbosity_warning()
```

[Source](https://github.com/huggingface/diffusers/blob/v0.43.0/src/diffusers/utils/logging.py#L191)

Définissez la verbosité au niveau `WARNING`.

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

```python
diffusers.utils.logging.set_verbosity_info()
```

[Source](https://github.com/huggingface/diffusers/blob/v0.43.0/src/diffusers/utils/logging.py#L186)

Définissez la verbosité au niveau `INFO`.

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

```python
diffusers.utils.logging.set_verbosity_debug()
```

[Source](https://github.com/huggingface/diffusers/blob/v0.43.0/src/diffusers/utils/logging.py#L196)

Définissez la verbosité au niveau `DEBUG`.

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

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

```python
diffusers.utils.logging.get_verbosity()
```

[Source](https://github.com/huggingface/diffusers/blob/v0.43.0/src/diffusers/utils/logging.py#L147)

**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]]

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

[Source](https://github.com/huggingface/diffusers/blob/v0.43.0/src/diffusers/utils/logging.py#L167)

**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]]

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

[Source](https://github.com/huggingface/diffusers/blob/v0.43.0/src/diffusers/utils/logging.py#L131)

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]]

```python
diffusers.utils.logging.enable_default_handler()
```

[Source](https://github.com/huggingface/diffusers/blob/v0.43.0/src/diffusers/utils/logging.py#L215)

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

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

```python
diffusers.utils.logging.disable_default_handler()
```

[Source](https://github.com/huggingface/diffusers/blob/v0.43.0/src/diffusers/utils/logging.py#L206)

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

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

```python
diffusers.utils.logging.enable_explicit_format()
```

[Source](https://github.com/huggingface/diffusers/blob/v0.43.0/src/diffusers/utils/logging.py#L261)

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]]

```python
diffusers.utils.logging.reset_format()
```

[Source](https://github.com/huggingface/diffusers/blob/v0.43.0/src/diffusers/utils/logging.py#L276)

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]]

```python
diffusers.utils.logging.enable_progress_bar()
```

[Source](https://github.com/huggingface/diffusers/blob/v0.43.0/src/diffusers/utils/logging.py#L352)

Activer la barre de progression tqdm.

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

```python
diffusers.utils.logging.disable_progress_bar()
```

[Source](https://github.com/huggingface/diffusers/blob/v0.43.0/src/diffusers/utils/logging.py#L358)

Désactiver la barre de progression tqdm.