JSPM

  • Created
  • Published
  • Downloads 16
  • Score
    100M100P100Q57884F
  • License MIT

Verbose logging features for ttys or any writable stream.

Package Exports

  • verbosity

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (verbosity) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

verbosity

An augmented drop-in console replacement that supports logging levels.

Publishing Status

npm Libraries.io
Travis Rollup

Development Status

Travis Libraries.io
Snyk Code-Climate Code-Climate Coverage

Documentation/Help

Inch.io Twitter

Usage

About

I wanted to be able to have chattier daemons running in development, and more succinct logging in production but wanted to keep the simplicity of using console.log() etc.

Normally I pass in a granular verboseness level via arguments to control the verbosity level for the running process.

Installation

npm install --save verbosity

Examples

Simply override the built in console object:

import {createConsole} from 'verbosity'

const console = createConsole({
  outStream: process.stdout,
  errorStream: process.stderr,
  verbosity: 5
})

console.log('Works like normal...')
console.debug('...but now controllable.')

console.verbosity(3) // Use numbered levels 5 (debug) to 1 (error)

console.debug('...this isn’t printed now.')

console.canWrite(5) && console.dir({print: 'this won’t.'})

console.verbosity('debug') // Use named levels [debug, info, log, warning, error]

console.canWrite(5) && console.dir({print: 'this will now.'})

This will direct all console output to stderr, but silence 'info' and 'debug' messages.

import {createConsole} from 'verbosity'

const console = createConsole({
  outStream: process.stderr,
  verbosity: 3
})

console.log('Picked brown jacket...') // Printed
console.debug('Purple tie chosen...') // Not printed
console.warn("That tie doesn't go with that jacket.") // Printed

Or go mad with making up any number of custom console writers.

import {createConsole} from 'verbosity'

const myUberConsole = createConsole({
  outStream: myFancyWriteableStream,
  verbosity: 5
})

myUberConsole.panic('Core Flux Capacitor Meltdown!')

Documentation

Full documentation can be found at https://thebespokepixel.github.io/verbosity/