Lightweight Logging for R Scripts

Provides flexible but lightweight logging facilities for R scripts. Supports priority levels for logs and messages, flagging messages, capturing script output, switching logs, and logging to files or connections.


Lightweight logging for R scripts.

luzlogr is available from CRAN, and can be installed using install.packages(). To install the latest, developmental version from this GitHub repository:

  1. Make sure you have devtools installed from CRAN and loaded.
  2. install_github("bpbond/luzlogr")

Either way, you can then do:

library(luzlogr)
help(package = 'luzlogr')

Three functions - openlog(), printlog(), closelog() - provide logging of script output. They provide features including priority levels for logs and messages; optionally capturing all output (via sink); switching between logs; and logging to a text file or arbitrary connection. For example:

openlog("test.log")
printlog("message")
closelog()

The resulting log file test.log looks something like this:

Thu Sep 17 08:46:59 2015  Opening ./test.log
Thu Sep 17 08:46:59 2015  message
Thu Sep 17 08:46:59 2015  Closing test.log  flags = 0
-------
R version 3.2.0 (2015-04-16)
Platform: x86_64-apple-darwin13.4.0 (64-bit)
Running under: OS X 10.10.5 (Yosemite)

For more details, see the vignette and documentation.

News

luzlogr 0.2

  • Added option to automatically close all log files if an error occurs; see ?closelog.

luzlogr 0.1.3

  • Log files now properly tracked even if working directory changes.
  • Added option to flush (immediately write) log messages.

luzlogr 0.1.1

  • Vignette added.

luzlogr 0.1

  • First release of the luzlogr package.
  • More information at https://github.com/bpbond/luzlogr.

Reference manual

It appears you don't have a PDF plugin for this browser. You can click here to download the reference manual.

install.packages("luzlogr")

0.2.0 by Ben Bond-Lamberty, a year ago


Browse source code at https://github.com/cran/luzlogr


Authors: Ben Bond-Lamberty [aut, cre]


Documentation:   PDF Manual  


MIT + file LICENSE license


Imports assertthat

Suggests testthat, knitr, rmarkdown


See at CRAN