Diffusers 文档

日志记录

Hugging Face's logo
加入 Hugging Face 社区

并获得增强的文档体验

开始使用

日志记录

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

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

import diffusers

diffusers.logging.set_verbosity_info()

您还可以使用环境变量 DIFFUSERS_VERBOSITY 来覆盖默认详细程度。您可以将其设置为以下值之一:debuginfowarningerrorcritical。例如

DIFFUSERS_VERBOSITY=error ./myprogram.py

此外,可以通过将环境变量 DIFFUSERS_NO_ADVISORY_WARNINGS 设置为真值(如 1)来禁用某些 warnings。这将禁用 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_barlogging.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

int 形式返回 🤗 Diffusers 根记录器的当前级别。

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 上更新