Buckets:

hf-doc-build
/

doc

Files

xet

hf-doc-build/doc / diffusers /v0.43.0 /pt /api /logging.md

mishig

2 days ago

preview code

download

raw

7.8 kB

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

Xet Storage Details

Size:: 7.8 kB
Xet hash:: 09fee5010e6b6e7c8872e763278dc43c36767de1d0c7ba3928912b15808f656e

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

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