@magic/log

@magic/log

simple server side logging.

basically console.log + loglevels + process.env awareness

html-docs

installation:

  npm install @magic/log

usage:

import

import log from '@magic/log'

log levels

// set logLevel to all
log.setLevel('all')
log.setLevel(0)

// logLevel warn
log.setLevel('warn')
log.setLevel(1)

// only log errors:
log.setLevel('error')
log.setLevel(2)

// if production, set logLevel to "warn", if development, "all"
log.resetLevel()

// get current logLevel
log.getLevel()

log functions

// only outputs if logLevel === 'all'
log.info('Some interesting yet useless information')

// only outputs if logLevel === 'all'.
// output of first argument is green.
log.success('yay', 'only the first', 'argument was green')

// always outputs. first argument will be red
log.error('ERROR:', 'error messsage')

// outputs if logLevel === 'warn' || 'all'
log.warn('WARN:', 'warn message')

// make a message greyed out
log.annotate('Annotate this message')

// return process.hrtime to use in log.timeTaken
const start = log.hrtime()

// get delta between one hrtime and another
const delta = log.hrtime(start)

// print the s, ms or ns since start
log.timeTaken(start, 'before', 'after')
// logs 'before xns after'

changelog

#####v0.0.3 log.error now converts errors for better logging

0.1.0

use ecmascript modules

0.1.1

bump to get this version to be the default for install. 0.1.0-cjs was preferred, but is deprecated.

0.1.2

add log.hrtime and log.timeTaken

0.1.3

require node >= 13.5.0

0.1.4

log.timeTaken(time, pre, post): if pre ends and post starts with a string delimiter, the time value between those string delimiters does not get spaces added around it.

0.1.5

bump required node version to 14.2.0

0.1.6 - unreleased

...