Diffusers 文档

日志记录

Hugging Face's logo
加入 Hugging Face 社区

并获得增强的文档体验

开始使用

日志记录

🤗 Diffusers 拥有一个集中式日志系统,可轻松管理库的详细程度。默认详细程度设置为 `WARNING`。

要更改详细程度级别,请使用直接设置器之一。例如,要将详细程度更改为 `INFO` 级别。

import diffusers

diffusers.logging.set_verbosity_info()

您还可以使用环境变量 `DIFFUSERS_VERBOSITY` 覆盖默认详细程度。您可以将其设置为以下值之一:`debug`、`info`、`warning`、`error`、`critical`。例如

DIFFUSERS_VERBOSITY=error ./myprogram.py

此外,一些 `warnings` 可以通过将环境变量 `DIFFUSERS_NO_ADVISORY_WARNINGS` 设置为 `1` 等真值来禁用。这将禁用 `logger.warning_advice` 记录的任何警告。例如

DIFFUSERS_NO_ADVISORY_WARNINGS=1 ./myprogram.py

以下是如何在您自己的模块或脚本中使用与库相同的日志记录器的示例

from diffusers.utils import logging

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

下面记录了日志模块的所有方法。主要方法是 `logging.get_verbosity` 用于获取日志记录器中当前的详细程度级别,以及 `logging.set_verbosity` 用于将详细程度设置为您选择的级别。

从最不详细到最详细的顺序

方法 整数值 描述
diffusers.logging.CRITICALdiffusers.logging.FATAL 50 仅报告最关键的错误
diffusers.logging.ERROR 40 仅报告错误
diffusers.logging.WARNINGdiffusers.logging.WARN 30 仅报告错误和警告(默认)
diffusers.logging.INFO 20 仅报告错误、警告和基本信息
diffusers.logging.DEBUG 10 报告所有信息

默认情况下,模型下载期间会显示 `tqdm` 进度条。`logging.disable_progress_bar` 和 `logging.enable_progress_bar` 用于启用或禁用此行为。

基本设置器

diffusers.utils.logging.set_verbosity_error

< >

( )

将详细程度设置为 `ERROR` 级别。

diffusers.utils.logging.set_verbosity_warning

< >

( )

将详细程度设置为 `WARNING` 级别。

diffusers.utils.logging.set_verbosity_info

< >

( )

将详细程度设置为 `INFO` 级别。

diffusers.utils.logging.set_verbosity_debug

< >

( )

将详细程度设置为 `DEBUG` 级别。

其他函数

diffusers.utils.logging.get_verbosity

< >

( ) int

返回

int

日志级别整数,可以是以下之一

  • 50: diffusers.logging.CRITICALdiffusers.logging.FATAL
  • 40: diffusers.logging.ERROR
  • 30: diffusers.logging.WARNINGdiffusers.logging.WARN
  • 20: diffusers.logging.INFO
  • 10: diffusers.logging.DEBUG

将 🤗 Diffusers 根日志记录器当前的详细程度级别以 `int` 形式返回。

diffusers.utils.logging.set_verbosity

< >

( verbosity: int )

参数

  • verbosity (int) — 日志级别,可以是以下之一:

    • diffusers.logging.CRITICALdiffusers.logging.FATAL
    • diffusers.logging.ERROR
    • diffusers.logging.WARNINGdiffusers.logging.WARN
    • diffusers.logging.INFO
    • diffusers.logging.DEBUG

为 🤗 Diffusers 根日志记录器设置详细程度级别。

diffusers.utils.get_logger

< >

( name: typing.Optional[str] = None )

返回具有指定名称的日志记录器。

除非您正在编写自定义 diffusers 模块,否则不应直接访问此函数。

diffusers.utils.logging.enable_default_handler

< >

( )

启用 🤗 Diffusers 根日志记录器的默认处理程序。

diffusers.utils.logging.disable_default_handler

< >

( )

禁用 🤗 Diffusers 根日志记录器的默认处理程序。

diffusers.utils.logging.enable_explicit_format

< >

( )

为每个 🤗 Diffusers 日志记录器启用显式格式化。显式格式化程序如下

[LEVELNAME|FILENAME|LINE NUMBER] TIME >> MESSAGE
目前绑定到根日志记录器的所有处理程序都受此方法影响。

diffusers.utils.logging.reset_format

< >

( )

重置 🤗 Diffusers 日志记录器的格式。

目前绑定到根日志记录器的所有处理程序都受此方法影响。

diffusers.utils.logging.enable_progress_bar

< >

( )

启用 tqdm 进度条。

diffusers.utils.logging.disable_progress_bar

< >

( )

禁用 tqdm 进度条。

< > 在 GitHub 上更新