Learn R Programming

progressr (version 0.15.1)

An Inclusive, Unifying API for Progress Updates

Description

A minimal, unifying API for scripts and packages to report progress updates from anywhere including when using parallel processing. The package is designed such that the developer can to focus on what progress should be reported on without having to worry about how to present it. The end user has full control of how, where, and when to render these progress updates, e.g. in the terminal using utils::txtProgressBar(), cli::cli_progress_bar(), in a graphical user interface using utils::winProgressBar(), tcltk::tkProgressBar() or shiny::withProgress(), via the speakers using beepr::beep(), or on a file system via the size of a file. Anyone can add additional, customized, progression handlers. The 'progressr' package uses R's condition framework for signaling progress updated. Because of this, progress can be reported from almost anywhere in R, e.g. from classical for and while loops, from map-reduce API:s like the lapply() family of functions, 'purrr', 'plyr', and 'foreach'. It will also work with parallel processing via the 'future' framework, e.g. future.apply::future_lapply(), furrr::future_map(), and 'foreach' with 'doFuture'. The package is compatible with Shiny applications.

Copy Link

Version

Install

install.packages('progressr')

Monthly Downloads

199,429

Version

0.15.1

License

GPL (>= 3)

Issues

Pull Requests

Stars

Forks

Maintainer

Henrik Bengtsson

Last Published

November 22nd, 2024

Functions in progressr (0.15.1)

handler_ntfy

Progression Handler: Progress Reported via the Ntfy.sh Messaging Service
handler_rpushbullet

Progression Handler: Progress Reported via the Pushbullet Messaging Service
handler_pbcol

Progression Handler: Progress Reported as an ANSI Background Color in the Terminal
global_progression_handler

A Global Calling Handler For 'progression':s
handler_pbmcapply

Progression Handler: Progress Reported via 'pbmcapply' Progress Bars (Text) in the Terminal
handler_rstudio

Progression Handler: Progress Reported in the RStudio Console
register_global_progression_handler

Add or Remove a Global 'progression' Handler
slow_sum

Slowly Calculate Sum of Elements
handler_ascii_alert

Progression Handler: Progress Reported as ASCII BEL Symbols (Audio or Blink) in the Terminal
handler_shiny

Progression Handler: Progress Reported via 'shiny' Widgets (GUI) in the HTML Browser
handler_progress

Progression Handler: Progress Reported via 'progress' Progress Bars (Text) in the Terminal
handler_txtprogressbar

Progression Handler: Progress Reported as Plain Progress Bars (Text) in the Terminal
handler_cli

Progression Handler: Progress Reported via 'cli' Progress Bars (Text) in the Terminal
handler_debug

Progression Handler: Progress Reported as Debug Information (Text) in the Terminal
handler_tkprogressbar

Progression Handler: Progress Reported as a Tcl/Tk Progress Bars in the GUI
handler_filesize

Progression Handler: Progress Reported as the Size of a File on the File System
handler_winprogressbar

Progression Handler: Progress Reported as a MS Windows Progress Bars in the GUI
progress_aggregator

Aggregate Progression Conditions
progression

A Progression Condition
handlers

Control How Progress is Reported
progressr

progressr: A Unifying API for Progress Updates
progress_progressr

Use Progressr with Plyr Map-Reduce Functions
handler_void

Progression Handler: No Progress Report
progressr.options

Options and environment variables used by the 'progressr' packages
progressor

Create a Progressor Function that Signals Progress Updates
make_progression_handler

Creates a Progression Calling Handler
progress

Creates and Signals a Progression Condition
withProgressShiny

Use Progressr in Shiny Apps: Plug-in Backward-Compatible Replacement for shiny::withProgress()
with_progress

Report on Progress while Evaluating an R Expression
handler_beepr

Progression Handler: Progress Reported as 'beepr' Sounds (Audio)
handler_newline

Progression Handler: Progress Reported as a New Line (Text) in the Terminal
handler_notifier

Progression Handler: Progress Reported via the Operating-System Notification Framework (GUI, Text)