# Utilidades

## Configurar el registro[[datasets.utils.logging.get_verbosity]]

🤗 Datasets se esfuerza por ser transparente y explícito sobre su funcionamiento, aunque a veces esto puede resultar bastante prolijo. Hemos incluido una serie de métodos de registro que te permiten ajustar fácilmente el nivel de detalle de toda la biblioteca. Actualmente, el nivel de detalle predeterminado de la biblioteca está establecido en `WARNING`.

Para cambiar el nivel de verbosidad, use uno de los setters directos. Por ejemplo, así se cambia la verbosidad al nivel `INFO`:

```py
import datasets
datasets.logging.set_verbosity_info()
```

También puede usar la variable de entorno `DATASETS_VERBOSITY` para anular la verbosidad predeterminada y establecerla en uno de los siguientes valores: `debug`, `info`, `warning`, `error`, `critical`:

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

Todos los métodos de este módulo de registro están documentados a continuación. Los principales son:

- [logging.get_verbosity()](/docs/datasets/v5.2.0/es/package_reference/utilities#datasets.utils.logging.get_verbosity) para obtener el nivel de verbosidad actual del registrador
- [logging.set_verbosity()](/docs/datasets/v5.2.0/es/package_reference/utilities#datasets.utils.logging.set_verbosity) para establecer el nivel de detalle que prefieras

En orden de menor a mayor nivel de detalle (con sus valores `int` correspondientes):

1. `logging.CRITICAL` o `logging.FATAL` (valor entero, 50): solo informa sobre los errores más críticos.
2. `logging.ERROR` (valor entero, 40): solo informa sobre errores.
3. `logging.WARNING` o `logging.WARN` (valor entero, 30): solo informa sobre errores y advertencias. Este es el nivel predeterminado utilizado por la biblioteca.
4. `logging.INFO` (valor int, 20): informa sobre errores, advertencias e información básica.
5. `logging.DEBUG` (valor int, 10): informa toda la información.

#### datasets.utils.logging.get_verbosity[[datasets.utils.logging.get_verbosity]]

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

[Fuente](https://github.com/huggingface/datasets/blob/5.2.0/src/datasets/utils/logging.py#L94)

**Devuelve:**

Nivel de registro, p. ej., `datasets.logging.DEBUG` y `datasets.logging.INFO`.

Devuelve el nivel actual del registro raíz de la biblioteca de conjuntos de datos de HuggingFace.

> [!TIP]
> La biblioteca de datasets de HuggingFace tiene los siguientes niveles de registro: - `datasets.logging.CRITICAL`, `datasets.logging.FATAL` - `datasets.logging.ERROR` - `datasets.logging.WARNING`, `datasets.logging.WARN` - `datasets.logging.INFO` - `datasets.logging.DEBUG`

#### datasets.utils.logging.set_verbosity[[datasets.utils.logging.set_verbosity]]

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

[Fuente](https://github.com/huggingface/datasets/blob/5.2.0/src/datasets/utils/logging.py#L110)

**Parámetros:**

verbosity : Nivel de registro, p. ej., `datasets.logging.DEBUG` y `datasets.logging.INFO`.

Establece el nivel del registro raíz de la biblioteca Hugging Face Datasets.

#### datasets.utils.logging.set_verbosity_info[[datasets.utils.logging.set_verbosity_info]]

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

[Fuente](https://github.com/huggingface/datasets/blob/5.2.0/src/datasets/utils/logging.py#L119)

Establezca el nivel del registro raíz de la biblioteca de conjuntos de datos de Hugging Face en `INFO`.

Esto mostrará la mayor parte de la información de registro y las barras de tqdm.

Atajo a `datasets.logging.set_verbosity(datasets.logging.INFO)`.

#### datasets.utils.logging.set_verbosity_warning[[datasets.utils.logging.set_verbosity_warning]]

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

[Fuente](https://github.com/huggingface/datasets/blob/5.2.0/src/datasets/utils/logging.py#L129)

Establezca el nivel del registro raíz de la biblioteca de conjuntos de datos de Hugging Face en `WARNING`.

Esto mostrará solo la información de registro de advertencias y errores y las barras de tqdm.

Atajo a `datasets.logging.set_verbosity(datasets.logging.WARNING)`.

#### datasets.utils.logging.set_verbosity_debug[[datasets.utils.logging.set_verbosity_debug]]

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

[Fuente](https://github.com/huggingface/datasets/blob/5.2.0/src/datasets/utils/logging.py#L139)

Establezca el nivel del registro raíz de la biblioteca de conjuntos de datos de Hugging Face en `DEBUG`.

Esto mostrará toda la información de registro y las barras de tqdm.

Atajo a `datasets.logging.set_verbosity(datasets.logging.DEBUG)`.

#### datasets.utils.logging.set_verbosity_error[[datasets.utils.logging.set_verbosity_error]]

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

[Fuente](https://github.com/huggingface/datasets/blob/5.2.0/src/datasets/utils/logging.py#L149)

Establezca el nivel del registro raíz de la biblioteca de conjuntos de datos de Hugging Face en `ERROR`.

Esto mostrará solo la información de registro de errores y las barras de tqdm.

Atajo a `datasets.logging.set_verbosity(datasets.logging.ERROR)`.

#### datasets.utils.logging.disable_propagation[[datasets.utils.logging.disable_propagation]]

```python
datasets.utils.logging.disable_propagation()
```

[Fuente](https://github.com/huggingface/datasets/blob/5.2.0/src/datasets/utils/logging.py#L159)

Desactive la propagación de las salidas de registro de la biblioteca. Tenga en cuenta que la propagación de registros está desactivada de forma predeterminada.

#### datasets.utils.logging.enable_propagation[[datasets.utils.logging.enable_propagation]]

```python
datasets.utils.logging.enable_propagation()
```

[Fuente](https://github.com/huggingface/datasets/blob/5.2.0/src/datasets/utils/logging.py#L166)

Habilite la propagación de las salidas de registro de la biblioteca. Deshabilite el controlador predeterminado de la biblioteca Hugging Face datasets para evitar el registro duplicado si el registro raíz se ha configurado.

## Configurar las barras de progreso[[datasets.enable_progress_bars]]

Por defecto, las barras de progreso de `tqdm` se mostrarán durante la descarga y el preprocesamiento de los conjuntos de datos. Puede desactivarlas de forma global estableciendo la variable de entorno `HF_DATASETS_DISABLE_PROGRESS_BARS`. También puede activarlas o desactivarlas mediante [enable_progress_bars()](/docs/datasets/v5.2.0/es/package_reference/utilities#datasets.enable_progress_bars) y [disable_progress_bars()](/docs/datasets/v5.2.0/es/package_reference/utilities#datasets.disable_progress_bars). Si se establece, la variable de entorno tiene prioridad sobre los helpers.

#### datasets.enable_progress_bars[[datasets.enable_progress_bars]]

```python
datasets.enable_progress_bars()
```

[Fuente](https://github.com/huggingface/datasets/blob/5.2.0/src/datasets/utils/tqdm.py#L78)

Habilita las barras de progreso globales utilizadas en `datasets`, a menos que se haya establecido la variable de entorno `HF_DATASETS_DISABLE_PROGRESS_BARS`.

Use [disable_progress_bars()](/docs/datasets/v5.2.0/es/package_reference/utilities#datasets.disable_progress_bars) para desactivarlos.

#### datasets.disable_progress_bars[[datasets.disable_progress_bars]]

```python
datasets.disable_progress_bars()
```

[Fuente](https://github.com/huggingface/datasets/blob/5.2.0/src/datasets/utils/tqdm.py#L61)

Desactiva globalmente las barras de progreso utilizadas en `datasets`, a menos que se haya establecido la variable de entorno `HF_DATASETS_DISABLE_PROGRESS_BARS`.

Use [enable_progress_bars()](/docs/datasets/v5.2.0/es/package_reference/utilities#datasets.enable_progress_bars) para volver a activarlos.

#### datasets.are_progress_bars_disabled[[datasets.are_progress_bars_disabled]]

```python
datasets.are_progress_bars_disabled()
```

[Fuente](https://github.com/huggingface/datasets/blob/5.2.0/src/datasets/utils/tqdm.py#L95)

Devuelve si las barras de progreso están deshabilitadas globalmente o no.

Las barras de progreso utilizadas en `datasets` se pueden habilitar o deshabilitar de forma global mediante [enable_progress_bars()](/docs/datasets/v5.2.0/es/package_reference/utilities#datasets.enable_progress_bars) y [disable_progress_bars()](/docs/datasets/v5.2.0/es/package_reference/utilities#datasets.disable_progress_bars) o estableciendo `HF_DATASETS_DISABLE_PROGRESS_BARS` como variable de entorno.