This package extends the message()
,
warning()
and stop()
functions by adding
levels of messages and the option to record them in a log
file.
Messages come in three types: “INFO”, “WARNING” and “ERROR”,
as produced by the functions info()
, warn()
and error()
, which are equivalent to
message()
, warning()
and stop()
.
respectively. When executing code the types to display can be
specified as an option. For example, you can ignore “INFO” and only show
“WARNING”s and “ERROR”s by setting:
options(msgr.types = c("WARNING", "ERROR"))
Whenever info()
, warn()
or
error()
are used a level can be specified, and when
executing the code the levels to display can be specified as an
option. The message is only shown if its level is less than, or equal
to, the level option.
options(msgr.level = 1)
warn("This is an important warning!", level = 1)
info("This is useful information, but not important!", level = 3)
Message can also be written to a log file. The log file can be
specified each time you use info()
, warn()
or
error()
, or you can specify it as an option.
options(msgr.log_path = "~/msgr.log")
info("This is written to console and log file")
error("This is written to console and an error log", log_path = "~/msgr-errors.log")