logging-package: A tentative logging package.

In logging: R Logging Package

Description

A logging package emulating the Python logging package.

What you find here behaves similarly to what you also find in Python. This includes hierarchic loggers, multiple handlers at each logger, the possibility to specify a formatter for each handler (one default formatter is given), same levels (names and numeric values) as Python's logging package, a simple logging.BasicConfig function to quickly put yourself in a usable situation...

This package owes a lot to my employer, r-forge, the stackoverflow community, Brian Lee Yung Rowe's futile package (v1.1) and the documentation of the Python logging package.

Details

Index:

basicConfig

bootstrapping the logging package

addHandler

add a handler to a logger

getLogger

set defaults and get current values for a logger

removeHandler

remove a handler from a logger

setLevel

set logging.level for a logger

To use this package, include logging instructions in your code, possibly like this:

library(logging)
basicConfig()
addHandler(writeToFile, logger="company", file="sample.log")
loginfo("hello world", logger="")
logwarn("hello company", logger="company.module")

The basicConfig function adds a console handler to the root logger, while the explicitly called addHandler adds a file handler to the 'company' logger. the effect of the above example is two lines on the console and just one line in the sample.log file.

The web pages for this package on r-forge are kept decently up to date and contain a usable tutorial. Check the references.

References

the python logging module: http://docs.python.org/library/logging.html
this package at github: https://github.com/WLOGSolutions/r-logging/

logging documentation built on July 14, 2019, 5:02 p.m.