Deprecated logger functions — create.logger • log4r

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 class 'logger'
logfile(x)

# S3 method for class 'logger'
logfile(x) <- value

logformat(x)

logformat(x) <- value

is.loglevel(x, ...)

loglevel(i)

as.loglevel(i)

# S3 method for class 'loglevel'
print(x, ...)

# S3 method for class 'loglevel'
as.numeric(x, ...)

# S3 method for class '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")
#> Warning: `create.logger()` was deprecated in log4r 0.5.0.
#> ℹ Please use `logger()` instead.
info(logger, "A message.")

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