docs » hs.logger

Default log level for new logger instances.

Returns the global log history

• None

• a list of (at most hs.logger.historySize()) log entries produced by all the logger instances, in chronological order; each entry is a table with the following fields:
  • time - timestamp in seconds since the epoch
  • level - a number between 1 (error) and 5 (verbose)
  • id - a string containing the id of the logger instance that produced this entry
  • message - a string containing the logged message

Sets or gets the global log history size

• size - (optional) the desired number of log entries to keep in the history; if omitted, will return the current size; the starting value is 0 (disabled)

• the current or new history size

• if you change history size (other than from 0) after creating any logger instances, things will likely break

Creates a new logger instance

• id - a string identifier for the instance (usually the module name)
• loglevel - (optional) can be 'nothing', 'error', 'warning', 'info', 'debug', or 'verbose', or a corresponding number between 0 and 5; uses hs.logger.defaultLogLevel if omitted

• the new logger instance

• the logger instance created by this method is not a regular object, but a plain table with "static" functions; therefore, do not use the colon syntax for so-called "methods" in this module (as in mylogger.setLogLevel(3)); you must instead use the regular dot syntax: mylogger.setLogLevel(3)

Example:

local log = hs.logger.new('mymodule','debug')
log.i('Initializing') -- will print "[mymodule] Initializing" to the console```

Prints the global log history to the console

• entries - (optional) the maximum number of entries to print; if omitted, all entries in the history will be printed
• level - (optional) the desired log level (see hs.logger.setLogLevel()); if omitted, defaults to verbose
• filter - (optional) a string to filter the entries (by logger id or message) via string.find plain matching
• caseSensitive - (optional) if true, filtering is case sensitive

• None

Sets the log level for all logger instances (including objects' loggers)

• lvl

• None

Sets the log level for all currently loaded modules

• lvl

• None

• This function only affects module-level loggers, object instances with their own loggers (e.g. windowfilters) won't be affected; you can use hs.logger.setGlobalLogLevel() for those

The log level of the logger instance, as a number between 0 and 5

Logs debug info to the console

• ... - one or more message strings

• None

Logs formatted debug info to the console

• fmt - formatting string as per string.format
• ... - arguments to fmt

• None

Logs an error to the console

• ... - one or more message strings

• None

Logs a formatted error to the console

• fmt - formatting string as per string.format
• ... - arguments to fmt

• None

Logs formatted info to the console

• fmt - formatting string as per string.format
• ... - arguments to fmt

• None

Gets the log level of the logger instance

• None

• The log level of this logger as a number between 0 and 5

Logs info to the console

• ... - one or more message strings

• None

Sets the log level of the logger instance

• loglevel - can be 'nothing', 'error', 'warning', 'info', 'debug', or 'verbose'; or a corresponding number between 0 and 5

• None

Logs verbose info to the console

• ... - one or more message strings

• None

Logs formatted verbose info to the console

• fmt - formatting string as per string.format
• ... - arguments to fmt

• None

Logs a warning to the console

• ... - one or more message strings

• None

Logs a formatted warning to the console

• fmt - formatting string as per string.format
• ... - arguments to fmt

• None