Skip to content

log ​

Logger factory that emits normalized records through an optional custom handler. When opts.handler is omitted, records are written to io.stderr.

Usage ​

lua
log = require "mods.log"

local logger = log.new()
logger:warn("config missing") --> writes: [WARN]: config missing

Functions ​

Factory:

FunctionDescription
new(opts?)Create a new logger.

Logger Methods:

FunctionDescription
debug(...)Emit a debug record.
error(...)Emit an error record.
info(...)Emit an info record.
log(levelname, ...)Emit a record for level when it passes the logger filter.
warn(...)Emit a warn record.

Factory ​

new(opts?) ​

Create a new logger. Parameters:

  • opts? (mods.log.new.opts): Logger configuration.

Return:

  • logger (mods.log.logger): Logger instance.

Logger Methods ​

debug(...) ​

Emit a debug record. Parameters:

  • ... (any): Additional values joined with spaces.

error(...) ​

Emit an error record. Parameters:

  • ... (any): Additional values joined with spaces.

info(...) ​

Emit an info record. Parameters:

  • ... (any): Additional values joined with spaces.

log(levelname, ...) ​

Emit a record for level when it passes the logger filter. Parameters:

  • levelname (string|"debug"|"info"|"warn"|"error"|"off"): Log level to emit.
  • ... (any): Additional values joined with spaces.

warn(...) ​

Emit a warn record. Parameters:

  • ... (any): Additional values joined with spaces.