log4r (version 0.5.0)

create.logger: Deprecated logger functions

Description

• create.logger() and logfile() are deprecated in favour of logger(). They issue deprecation warnings when used.

• debug(), info(), warn(), error(), and fatal() are deprecated in favour of log_debug(), log_info(), log_warn(), log_error(), and log_fatal(), respectively. For performance reasons they do not yet issue deprecation warnings when used.

• levellog() is deprecated in favour of log_at(). It issues a deprecation warning when used.

• logformat() is incompatible with Layouts and has been nonfunctional for many years. It issues a deprecation error when used.

• is.loglevel(), as.loglevel(), its alias loglevel(), and S3 generics for the "loglevel" class are now considered an implementation detail and are no longer part of the public API. They issue deprecation warnings when used.

• verbosity() is similar, in that there is no longer a stable mapping between priority integers and levels. It issues a deprecation warning when used.

Usage

create.logger(logfile = "logfile.log", level = "FATAL", logformat = NULL)
logfile(x)
logfile(x) <- value
# S3 method for logger
logfile(x)
# S3 method for logger
logfile(x) <- value
logformat(x)
logformat(x) <- value
is.loglevel(x, ...)
loglevel(i)
as.loglevel(i)
# S3 method for loglevel
print(x, ...)
# S3 method for loglevel
as.numeric(x, ...)
# S3 method for loglevel
as.character(x, ...)
verbosity(v)
levellog(logger, level, ...)
debug(logger, ...)
info(logger, ...)
warn(logger, ...)
error(logger, ...)
fatal(logger, ...)

Value

logformat() and logformat<-() always throw an error. logfile()

returns the path the logger writes to and logfile<-() returns the modified logger. The remaining functions return the same values as their replacements.

Examples

# Deprecated: configure a logger with create.logger().
logger <- create.logger(logfile = tempfile(), level = "INFO")
info(logger, "A message.")

# Instead, use logger() with an appender:
logger <- logger("INFO", appenders = file_appender(tempfile()))
log_info(logger, "A message.")