# Registro

🤗 Diffusers tiene un sistema de registro centralizado para gestionar fácilmente la verbosidad de la biblioteca. La verbosidad predeterminada se establece en `WARNING`.

Para cambiar el nivel de verbosidad, use uno de los setters directos. Por ejemplo, para cambiar la verbosidad al nivel `INFO`.

```python
import diffusers

diffusers.logging.set_verbosity_info()
```

También puede usar la variable de entorno `DIFFUSERS_VERBOSITY` para anular la verbosidad predeterminada. Puede configurarla en uno de los siguientes valores: `debug`, `info`, `warning`, `error`, `critical`. Por ejemplo:

```bash
DIFFUSERS_VERBOSITY=error ./myprogram.py
```

Además, algunas `warnings` se pueden desactivar estableciendo la variable de entorno `DIFFUSERS_NO_ADVISORY_WARNINGS` en un valor verdadero, como `1`. Esto desactiva cualquier advertencia registrada por `logger.warning_advice`. Por ejemplo:

```bash
DIFFUSERS_NO_ADVISORY_WARNINGS=1 ./myprogram.py
```

A continuación se muestra un ejemplo de cómo usar el mismo registrador que la biblioteca en su propio módulo o script:

```python
from diffusers.utils import logging

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

Todos los métodos del módulo de registro están documentados a continuación. Los métodos principales son `logging.get_verbosity` para obtener el nivel de verbosidad actual del registrador y `logging.set_verbosity` para establecer la verbosidad en el nivel que desee.

En orden, de la opción menos verbosa a la más verbosa:

|                                                    Método | Valor entero |                                         Descripción |
|----------------------------------------------------------:|--------------:|----------------------------------------------------:|
| `diffusers.logging.CRITICAL` o `diffusers.logging.FATAL` |            50 |                solo reportar los errores más críticos |
|                                 `diffusers.logging.ERROR` |            40 |                                  solo reportar errores |
|   `diffusers.logging.WARNING` o `diffusers.logging.WARN` |            30 |           solo reportar errores y advertencias (predeterminado) |
|                                  `diffusers.logging.INFO` |            20 | solo reportar errores, advertencias e información básica |
|                                 `diffusers.logging.DEBUG` |            10 |                              informar toda la información |

Por defecto, las barras de progreso de `tqdm` se muestran durante la descarga del modelo. `logging.disable_progress_bar` y `logging.enable_progress_bar` se utilizan para habilitar o deshabilitar este comportamiento.

## Configuradores 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()
```

[Fuente](https://github.com/huggingface/diffusers/blob/main/src/diffusers/utils/logging.py#L201)

Establezca la verbosidad en el nivel `ERROR`.

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

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

[Fuente](https://github.com/huggingface/diffusers/blob/main/src/diffusers/utils/logging.py#L191)

Establezca la verbosidad en el nivel `WARNING`.

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

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

[Fuente](https://github.com/huggingface/diffusers/blob/main/src/diffusers/utils/logging.py#L186)

Establezca la verbosidad en el nivel `INFO`.

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

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

[Fuente](https://github.com/huggingface/diffusers/blob/main/src/diffusers/utils/logging.py#L196)

Establezca la verbosidad en el nivel `DEBUG`.

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

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

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

[Fuente](https://github.com/huggingface/diffusers/blob/main/src/diffusers/utils/logging.py#L147)

**Devuelve:** `int`

Números enteros de nivel de registro que pueden ser uno de los siguientes:

- `50`: `diffusers.logging.CRITICAL` o `diffusers.logging.FATAL`
- `40`: `diffusers.logging.ERROR`
- `30`: `diffusers.logging.WARNING` o `diffusers.logging.WARN`
- `20`: `diffusers.logging.INFO`
- `10`: `diffusers.logging.DEBUG`

Devuelve el nivel actual del registrador raíz de 🤗 Diffusers como un `int`.

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

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

[Fuente](https://github.com/huggingface/diffusers/blob/main/src/diffusers/utils/logging.py#L167)

**Parámetros:**

verbosity (`int`) : Nivel de registro que puede ser uno de los siguientes: - `diffusers.logging.CRITICAL` o `diffusers.logging.FATAL` - `diffusers.logging.ERROR` - `diffusers.logging.WARNING` o `diffusers.logging.WARN` - `diffusers.logging.INFO` - `diffusers.logging.DEBUG`

Establece el nivel de verbosidad del registrador raíz de 🤗 Diffusers.

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

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

[Fuente](https://github.com/huggingface/diffusers/blob/main/src/diffusers/utils/logging.py#L131)

Devuelve un registrador con el nombre especificado.

Esta función no está destinada a ser accedida directamente, a menos que estés escribiendo un módulo personalizado de diffusers.

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

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

[Fuente](https://github.com/huggingface/diffusers/blob/main/src/diffusers/utils/logging.py#L215)

Habilite el controlador predeterminado del registro raíz de 🤗 Diffusers.

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

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

[Fuente](https://github.com/huggingface/diffusers/blob/main/src/diffusers/utils/logging.py#L206)

Desactive el controlador predeterminado del registro raíz de 🤗 Diffusers.

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

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

[Fuente](https://github.com/huggingface/diffusers/blob/main/src/diffusers/utils/logging.py#L261)

Habilite el formato explícito para cada registro de 🤗 Diffusers. El formateador explícito es el siguiente:
```
[LEVELNAME|FILENAME|LINE NUMBER] TIME >> MESSAGE
```

Todos los manejadores actualmente vinculados al registro principal se ven afectados por este método.

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

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

[Fuente](https://github.com/huggingface/diffusers/blob/main/src/diffusers/utils/logging.py#L276)

Restablece el formato de los registradores de 🤗 Diffusers.

Todos los manejadores actualmente vinculados al registro principal se ven afectados por este método.

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

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

[Fuente](https://github.com/huggingface/diffusers/blob/main/src/diffusers/utils/logging.py#L352)

Activar la barra de progreso de tqdm.

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

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

[Fuente](https://github.com/huggingface/diffusers/blob/main/src/diffusers/utils/logging.py#L358)

Desactivar la barra de progreso de tqdm.