0.3.0 • Published 5 years ago

@bnguyensn/logger v0.3.0

Weekly downloads
20
License
MIT
Repository
github
Last release
5 years ago

Logger 📝

Provides basic logging functionality. Built on top of the wonderful chalk.

Opinionated for my own usage.

Install

Using npm:

$ npm install -D @bnguyensn/logger

Using yarn:

$ yarn add -D @bnguyensn/logger

Usage

Basic usage:

const logger = require('@bnguyensn/logger')();

logger.info('I am blue');
logger.success('I am green');
logger.warn('I am yellow');
logger.error('I am red');

With a base prefix and timestamp:

const logger = require('@bnguyensn/logger')({ base: 'LOG', timestamp: true });

logger.info("I will have 'LOG' prepended and also have a timestamp");

API

createLogger(config)

This is the function exported by the module. You get this from calling require('@bnguyensn/logger').

createLogger(), when called, will return a Logger instance.

The config object by default is undefined.

config

PropertyTypeDescription
basestringA string to be prepended to each logging message.
timestampbooleanIf true, will add a timestamp to each logging message.
timestampOptionsobjectSee below.

timestampOptions

This object describes how the timestamp for each logging message should look like. We use Node's toLocaleDateString() under the hood.

PropertyTypeDescription
localestring \| undefinedSee toLocaleDateString()'s locales parameter. If undefined, will attempt to use the system's locale.
localeOptionsobjectSee toLocaleDateString()'s options parameter.
custombooleanIf true, will ignore both the locale and localeOptions above and use a custom date format. If Node's toLocaleDateString() is not supported, we will fall back to this custom date format.

Logger

An instance of Logger is returned from calling createLogger().

This Logger instance can then be used to log stuff to the terminal.

Each Logger has the following methods:

MethodDescription
info(msg)Log the provided msg in the color blue.
infoEOL(msg)Log the provided msg in the color blue and append a new line at the end.
success(msg)Log the provided msg in the color green.
successEOL(msg)Log the provided msg in the color green and append a new line at the end.
warn(msg)Log the provided msg in the color yellow.
warnEOL(msg)Log the provided msg in the color yellow and append a new line at the end.
error(msg)Log the provided msg in the color red.
errorEOL(msg)Log the provided msg in the color red and append a new line at the end.