工具

配置日志记录

🤗 Datasets 致力于使其工作方式透明且明确，但这有时会导致输出过于冗长。我们包含了一系列日志记录方法，使您可以轻松调整整个库的详细程度。目前，该库的默认详细程度设置为 WARNING。

要更改详细程度，请使用其中一个直接设置方法。例如，以下是如何将详细程度更改为 INFO 级别：

import datasets
datasets.logging.set_verbosity_info()

您还可以使用环境变量 DATASETS_VERBOSITY 来覆盖默认的详细程度，并将其设置为以下之一：debug、info、warning、error、critical。

DATASETS_VERBOSITY=error ./myprogram.py

此日志模块的所有方法如下所述。主要的方法有：

logging.get_verbosity() 用于获取记录器当前的详细程度级别
logging.set_verbosity() 用于将详细程度设置为您选择的级别

按详细程度从低到高排列（及其对应的 int 值）：

logging.CRITICAL 或 logging.FATAL (int 值, 50): 仅报告最严重的错误。
logging.ERROR (int 值, 40): 仅报告错误。
logging.WARNING 或 logging.WARN (int 值, 30): 仅报告错误和警告。这是该库使用的默认级别。
logging.INFO (int 值, 20): 报告错误、警告和基本信息。
logging.DEBUG (int 值, 10): 报告所有信息。

datasets.utils.logging.get_verbosity

< 源码 >

( )

返回 HuggingFace datasets 库根记录器的当前级别。

HuggingFace datasets 库具有以下日志级别：

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

< 源码 >

( verbosity: int )

参数

verbosity — 日志级别，例如 datasets.logging.DEBUG 和 datasets.logging.INFO。

设置 Hugging Face Datasets 库根记录器的级别。

datasets.utils.logging.set_verbosity_info

< 源码 >

( )

将 Hugging Face datasets 库根记录器的级别设置为 INFO。

这将显示大部分日志信息和 tqdm 进度条。

datasets.logging.set_verbosity(datasets.logging.INFO) 的快捷方式。

datasets.utils.logging.set_verbosity_warning

< 源码 >

( )

将 Hugging Face datasets 库根记录器的级别设置为 WARNING。

这将仅显示警告和错误日志信息以及 tqdm 进度条。

datasets.logging.set_verbosity(datasets.logging.WARNING) 的快捷方式。

datasets.utils.logging.set_verbosity_debug

< 源码 >

( )

将 Hugging Face datasets 库根记录器的级别设置为 DEBUG。

这将显示所有日志信息和 tqdm 进度条。

datasets.logging.set_verbosity(datasets.logging.DEBUG) 的快捷方式。

datasets.utils.logging.set_verbosity_error

< 源码 >

( )

将 Hugging Face datasets 库根记录器的级别设置为 ERROR。

这将仅显示错误日志信息和 tqdm 进度条。

datasets.logging.set_verbosity(datasets.logging.ERROR) 的快捷方式。

datasets.utils.logging.disable_propagation

< 源码 >

( )

禁用库日志输出的传播。请注意，日志传播默认是禁用的。

datasets.utils.logging.enable_propagation

< 源码 >

( )

启用库日志输出的传播。如果已配置根记录器，请禁用 Hugging Face datasets 库的默认处理器，以防止重复记录。

配置进度条

默认情况下，在数据集下载和预处理期间会显示 tqdm 进度条。您可以通过设置 HF_DATASETS_DISABLE_PROGRESS_BARS 环境变量来全局禁用它们。您还可以使用 enable_progress_bars() 和 disable_progress_bars() 启用/禁用它们。如果已设置环境变量，则其优先级高于辅助函数。

datasets.enable_progress_bars

< 源码 >

( )

除非已设置 HF_DATASETS_DISABLE_PROGRESS_BARS 环境变量，否则全局启用 datasets 中使用的进度条。

使用 disable_progress_bars() 禁用它们。

datasets.disable_progress_bars

< 源码 >

( )

除非已设置 HF_DATASETS_DISABLE_PROGRESS_BARS 环境变量，否则全局禁用 datasets 中使用的进度条。

使用 enable_progress_bars() 重新启用它们。

datasets.are_progress_bars_disabled

< 源码 >

( )

返回进度条是否已被全局禁用。

datasets 中使用的进度条可以通过 enable_progress_bars() 和 disable_progress_bars() 或通过设置 HF_DATASETS_DISABLE_PROGRESS_BARS 环境变量来全局启用或禁用。

在 GitHub 上更新