Introducation

A simple logging library yet with powerful functionalities. Customizable appenders and rich output format. Share configurations through application.

Installation

npm i reflect-metadata @t2ee/core @t2ee/sl4js -S

Usage

Basic Example

  default: ConsoleDebug
  level: LogLevel.DEBUG
  appenders:
  - name: ConsoleDebug
    appender: console
      pattern: '%d{YYYY-MM-DD HH:mm:ss.SSS} %-7c{[%l]} %10n %5p - %2w  %m'
      level: LogLevel.DEBUG
  - name: FileLog
    appender: file
    pattern: '%d{YYYY-MM-DD HH:mm:ss.SSS} [%l] %10n %5p - %2w  %m'
    level: LogLevel.INFO
    file: relative(file.log)

ConfigurationStore.loadFile(PATH_TO_LOGGING_CONFIGURATION);
LogManager.getLogger().debug('Hello World');

Custom Appender

interface Configuration extends AppenderConfiguration {

}

class ConsoleAppender extends Appender<Configuration> {
    public log(layout: Layout): void {
        let message: string = this.patternLayout.parse(layout);
        console.log(message);
    }
}

Pattern

Pattern refers to what you put in appenders’ pattern field, e.g, '%d{YYYY-MM-DD HH:mm:ss.SSS} %-7c{[%l]} %10n %5p - %2w %m'

As you can see in the example, any prefix digit, e.g, %7d, %-7d, refers to padding, positive means left, vice versa.

As for chacaters(placeholders) supported, see chart below.