# Registro

🤗 O Diffusers possui um sistema de log centralizado para gerenciar facilmente a verbosidade da biblioteca. A verbosidade padrão é definida como `WARNING`.

Para alterar o nível de verbosidade, use um dos setters diretos. Por exemplo, para alterar a verbosidade para o nível `INFO`.

```python
import diffusers

diffusers.logging.set_verbosity_info()
```

Você também pode usar a variável de ambiente `DIFFUSERS_VERBOSITY` para substituir a verbosidade padrão. Você pode configurá-la com um dos seguintes valores: `debug`, `info`, `warning`, `error`, `critical`. Por exemplo:

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

Além disso, alguns `warnings` podem ser desativados definindo a variável de ambiente `DIFFUSERS_NO_ADVISORY_WARNINGS` para um valor verdadeiro, como `1`. Isso desativa qualquer aviso registrado por `logger.warning_advice`. Por exemplo:

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

Aqui está um exemplo de como usar o mesmo logger da biblioteca no seu próprio módulo ou script:

```python
from diffusers.utils import logging

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

Todos os métodos do módulo de logging estão documentados abaixo. Os principais métodos são `logging.get_verbosity` para obter o nível atual de verbosidade no logger e `logging.set_verbosity` para definir a verbosidade no nível de sua escolha.

Em ordem, do menos verboso ao mais verboso:

|                                                    Método | Valor inteiro |                                         Descrição |
|----------------------------------------------------------:|--------------:|----------------------------------------------------:|
| `diffusers.logging.CRITICAL` ou `diffusers.logging.FATAL` |            50 |                relate apenas os erros mais críticos |
|                                 `diffusers.logging.ERROR` |            40 |                                  relatar apenas erros |
|   `diffusers.logging.WARNING` ou `diffusers.logging.WARN` |            30 |           relata apenas erros e avisos (padrão) |
|                                  `diffusers.logging.INFO` |            20 | relatar apenas erros, avisos e informações básicas |
|                                 `diffusers.logging.DEBUG` |            10 |                              relate todas as informações |

Por padrão, as barras de progresso `tqdm` são exibidas durante o download do modelo. `logging.disable_progress_bar` e `logging.enable_progress_bar` são usados para habilitar ou desabilitar esse comportamento.

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

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

Defina a verbosidade para o nível `ERROR`.

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

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

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

Defina a verbosidade para o nível `WARNING`.

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

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

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

Defina a verbosidade para o nível `INFO`.

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

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

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

Defina a verbosidade para o nível `DEBUG`.

## Outras funções[[diffusers.utils.logging.get_verbosity]]

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

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

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

**Retorna:** `int`

Inteiros de nível de log que podem ser um dos seguintes:

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

Retorna o nível atual do logger raiz do 🤗 Diffusers como um `int`.

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

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

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

**Parâmetros:**

verbosity (`int`) : Nível de log que pode ser um dos seguintes:  - `diffusers.logging.CRITICAL` ou `diffusers.logging.FATAL` - `diffusers.logging.ERROR` - `diffusers.logging.WARNING` ou `diffusers.logging.WARN` - `diffusers.logging.INFO` - `diffusers.logging.DEBUG`

Defina o nível de verbosidade do logger raiz do 🤗 Diffusers.

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

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

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

Retorna um logger com o nome especificado.

Esta função não deve ser acessada diretamente, a menos que você esteja escrevendo um módulo customizado do diffusers.

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

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

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

Ative o manipulador padrão do logger raiz do 🤗 Diffusers.

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

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

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

Desative o manipulador padrão do logger raiz do 🤗 Diffusers.

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

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

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

Ative o formato explícito para cada logger do 🤗 Diffusers. O formatador explícito é o seguinte:
```
[LEVELNAME|FILENAME|LINE NUMBER] TIME >> MESSAGE
```

Todos os handlers atualmente vinculados ao logger raiz são afetados por este método.

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

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

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

Redefine o formato dos registradores do 🤗 Diffusers.

Todos os handlers atualmente vinculados ao logger raiz são afetados por este método.

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

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

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

Ative a barra de progresso do tqdm.

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

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

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

Desative a barra de progresso do tqdm.