@liplum/log

Installation

Install this package.

npm i @liplum/log

Getting started

import { createLogger } from "@liplum/log"

const log = createLogger("Main")

log.info("hello, world!")
log.warn("hello, warning!")
log.error("hello, error!")
log.verbose("hello, hello, hello!")
log.debug("hello, bug!")

Features

• [x] Configuration
• [x] Custom log levels
• [x] Logger events
• [x] Logging to console and file
• [ ] Multi-channel logger

Configuration

You can configure the log format and entry format.

const logProvider = createLoggerProvider({
  logFormat: ({time, level, channel, messages}) => {
    return `[${time.toISOString()}] [${level}] [${channel}] ${messages.join(", ")}`
  },
  entryFormat: (entry) => `${entry}`,
})
const log = logProvider.createLogger("ChannelName")

Custom log levels

You can define your own log levels in a string.

const log = createLogger("Main")
log.log("CUSTOM", "hello, warning!")

Logging to console and file

The log messages can be output into console and file with logger level filter.

You can create a console logger with createConsoleLogging function.

const log = createLogger("Main")
const consoleLogging = createConsoleLogging({
  logLevels: ["INFO", "WARN", "ERROR"]
})
consoleLogging.on(log)
log.info("hello, world!")
log.warn("hello, warning!")
log.error("hello, error!")
log.verbose("hello, hello, hello!")
log.debug("hello, bug!")
consoleLogging.off(log)

You can also create a log provider with createLoggerProvider function, which can manage multiple loggers.

const logProvider = createLoggerProvider()
const consoleLogging = createConsoleLogging({
  logLevels: ["INFO", "WARN", "ERROR"]
})
consoleLogging.on(logProvider)
const logA = logProvider.createLogger("ProviderA")
const logB = logProvider.createLogger("ProviderB")
logA.info("hello, world!")
logA.warn("hello, warning!")
logA.error("hello, error!")
logA.verbose("hello, hello, hello!")
logA.debug("hello, bug!")

logB.info("hello, world!")
logB.warn("hello, warning!")
logB.error("hello, error!")
logB.verbose("hello, hello, hello!")
logB.debug("hello, bug!")
consoleLogging.off(logProvider)

Logging into local file.

const fileLogging = createFileLogging({
  logLevels: ["INFO", "WARN", "ERROR"],
  logDir: path.join(os.tmpdir(), randomUUID()),
  filePath: "./test.log",
})
const log = createLogger("FileLogger")
fileLogging.on(log)
log.info("hello, world!")
log.warn("hello, warning!")
log.error("hello, error!")
log.verbose("hello, hello, hello!")
log.debug("hello, bug!")
fileLogging.off(log)

Logger events

The loggers can emit events like log when a log message comes out.

The Logger emits log event when a message is logged on it.

const log = createLogger("Main")
log.on("log", (e) => {
  console.log("!Log!", e.id, e.channel, e.level, e.rawMessages)
})
log.info("hello, world!")
log.warn("hello, warning!")
log.error("hello, error!")
log.verbose("hello, hello, hello!")
log.debug("hello, bug!")

The LogProvider emits logger-created when a logger is created from it, and log when its loggers emit a log message.

const logProvider = createLoggerProvider()
logProvider.on("logger-created", (e) => {
  console.log("!Logger Created!", e.id, e.rawMessages)
})
logProvider.on("log", (e) => {
  console.log("!Log!", e.id, e.channel, e.level, e.rawMessages)
})
const log = logProvider.createLogger("Provider")
log.info("hello, world!")
log.warn("hello, warning!")
log.error("hello, error!")
log.verbose("hello, hello, hello!")
log.debug("hello, bug!")

You can create your own LoggingListener.

const messages = []
const listener = createLoggingListener({
  onLogged: (target,{channel, level, rawMessages}) => {
    messages.push({ channel, level, rawMessages })
  },
})
const log = createLogger("Main")
listener.on(log)
log.info("hello, world!")
log.warn("hello, warning!")
log.error("hello, error!")
log.verbose("hello, hello, hello!")
log.debug("hello, bug!")
listener.off(log)
console.log("Logged Messages:", messages)