Details

这些变量可以在cli进度条格式字符串中使用。它们是按需计算的。

要在包中使用变量,比如pb_bar,你要么需要从cli中导入pb_bar,要么使用限定格式字符串:cli::pb_bar。

类似地,在R脚本中,您可以在library(cli)之后使用pb_bar,如果不附加cli包,则可以使用cli::pb_bar。

pb_bar

创建可视进度条。如果总单元数未知,则返回空字符串。

cli_progress_bar(total = 100,format = "Fitting model {cli::pb_bar} {cli::pb_percent}")
#> Fitting model ███████████████████████████████ 66% 

pb_current

当前进度单元的数量。

cli_progress_bar(total = 100,format = "{cli::pb_spin} Reading file {cli::pb_current}/{cli::pb_total}")
#> ⠙ Reading file 66/100 

pb_current_bytes

格式化为字节的当前进度单元的数目。输出具有六个字符的恒定宽度。

cli_progress_bar(format = "Got {cli::pb_current_bytes} in {cli::pb_elapsed}")
#> Got 524 kB in 5s

pb_elapsed

进度条开始后经过的时间。时间是在使用cli_progress_bar()或类似方法创建进度条之后测量的。

cli_progress_bar(total = 100,format = "{cli::pb_bar} {cli::pb_percent} [{cli::pb_elapsed}]")
#> ███████████████████████████████ 66% [5s] 

pb_elapsed_clock

经过的时间,格式为hh::mm::ss。

cli_progress_bar(total = 100,format = "{cli::pb_bar} {cli::pb_percent} [{cli::pb_elapsed_clock}]")
#> ███████████████████████████████ 66% [00:00:05] 

pb_elapsed_raw

进度条开始后的秒数。

cli_progress_bar(total = 100,format = "{cli::pb_bar} {cli::pb_percent} [{round(cli::pb_elapsed_raw)}s]")
#> ███████████████████████████████ 66% [5s] 

pb_eta

进度条结束前的估计时间,以人类可读的形式显示。

cli_progress_bar(total = 100,format = "{cli::pb_bar} {cli::pb_percent} | ETA: {cli::pb_eta}")
#> ███████████████████████████████ 66% | ETA:3s 

pb_eta_raw

进度条结束前的估计时间,以秒为单位。如果您想调整默认的pb_eta显示,这很有用。

cli_progress_bar(total = 100,format = "{cli::pb_bar} {cli::pb_percent} | ETA: {round(cli::pb_eta_raw)}s")
#> ███████████████████████████████ 66% | ETA: 3s 

pb_eta_str

进度条结束前的估计时间。它包括“ETA:”前缀。只有在时间可以估计的情况下才会显示,否则为空字符串。

cli_progress_bar(total = 100,format = "{cli::pb_bar} {cli::pb_percent} | {cli::pb_eta_str}")
#> ███████████████████████████████ 66% | ETA:3s 

pb_extra

Pb_extra可以用来访问额外的数据,参见cli_progress_bar()和cli_progress_update()的extra参数。

cli_progress_bar(total = 100,extra = list(user = whoami::username()),format = "Cleaning cache for user '{cli::pb_extra$user}': {cli::pb_current_bytes}")
#> Cleaning cache for user 'gaborcsardi': 161 MB

pb_id

cli_progress_bar(format = "Progress bar '{cli::pb_id}' is at {cli::pb_current}")
#> Progress bar 'cli-82040-1814' is at 64 

pb_name

进度条的名称。这是由开发人员提供的,默认情况下为空字符串。非空名称中添加空格字符。

cli_progress_bar(name = "Loading training data",total = 100,format = "{cli::pb_name} {cli::pb_bar} {cli::pb_percent}")
#> Loading training data███████████████████████████████ 66%

pb_percent

进度条的百分比,格式总是三个字符加百分号。如果总单位数未知,则为“NA%”。

cli_progress_bar(total = 100,format = "{cli::pb_bar} {cli::pb_percent}")
#> ███████████████████████████████ 66% 

pb_pid

进度条的整数进程id。如果您正在聚合来自多个进程的日志输出或进度结果,这将非常有用。

pb_rate

进度速率,以每秒单位数表示,格式为字符串。

cli_progress_bar(total = 156,format = "Reading input files {pb_current}/{pb_total} [{pb_rate}]")
#> Reading input files 68/156 [14/s] 

pb_rate_raw

原始进度速率,单位为每秒的单位数。

cli_progress_bar(total = 156,format = "Reading input files {pb_current}/{pb_total} [{round(pb_rate_raw)}/s]")
#> Reading input files 68/156 [14/s] 

pb_rate_bytes

进度速率,格式为字节每秒,以人类可读的形式。

cli_progress_bar(total = 256 * 1024 * 1014,format = paste0("Reading data {pb_current_bytes}/{pb_total_bytes} ","[{ansi_trimws(pb_rate_bytes)}]")
#> Reading data70 MB/266 MB [14 MB/s]

pb_spin

标记符号。默认的标记符号是通过get_spinner()调用选择的。

cli_progress_bar(total = 100,format = "{cli::pb_spin} Reading file {cli::pb_current}/{cli::pb_total}")
#> ⠙ Reading file 66/100

pb_status

进度条的状态字符串。默认情况下,这是一个空字符串,但可以在cli_progress_bar()和’cli_progress_update()]中设置它。

pb_timestamp

以ISO 8601格式表示当前时间的时间戳。

cli_progress_bar("Loading training data files",format = "{pb_timestamp} {pb_current} ({pb_rate})"
#> 2022-09-07T11:27:50+00:00 125 (25/s) 

pb_total

进度单位的总数,如果单位数量未知,则为NA。

cli_progress_bar(total = 100,format = "{cli::pb_spin} Reading file {cli::pb_current}/{cli::pb_total}")
#> ⠙ Reading file 66/100 

pb_total_bytes

进度单元的总数,格式化为字节,采用人类可读的格式。

cli_progress_bar(total = 256 * 1024 * 1014,format = paste0("Reading data {pb_current_bytes}/{pb_total_bytes} ","[{ansi_trimws(pb_rate_bytes)}]")
#> Reading data70 MB/266 MB [14 MB/s]