Buckets:

hf-doc-build
/

doc

Files

xet

hf-doc-build/doc / diffusers /main /es /api /logging.md

mishig

8 days ago

preview code

download

raw

8.01 kB

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

Xet Storage Details

Size:: 8.01 kB
Xet hash:: 64ea2b1273f5316e4a44b5a0e9e45d937b189c3c3bcf850189b1ce28dfbf507e

Xet efficiently stores files, intelligently splitting them into unique chunks and accelerating uploads and downloads. More info.

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