You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
rdrew 1440706ce3 fixed gulp 6 years ago
..
node_modules fixed gulp 6 years ago
src fixed gulp 6 years ago
LICENSE fixed gulp 6 years ago
README.md fixed gulp 6 years ago
index.js fixed gulp 6 years ago
package.json fixed gulp 6 years ago
yarn-error.log fixed gulp 6 years ago
yarn.lock fixed gulp 6 years ago

README.md

debug-fabulous NPM version build status

Install

npm install --save debug-fabulous

Purpose:

Wrapper / Extension around visionmedia's debug to allow lazy evaluation of debugging via closure handling.

Why would I consider using this library?

The main utilities added to this library is lazy log level evaluation. This allows whatever logged strings to only be created and evaluated if a log level is active. This can considerably reduce the amount of memory used in logging when you are not using.

With this in mind, there are no excuses to not log anything and everything as performance can be kept in check easily (via log levels).

Proof

For analysis of the performance results are in perfWith.out and perfWithout.out.

In summary, the tests using this library are using 3 times less memory for the same logging statements (when the log levels are disabled).

This library essentially wraps two things:

  • lazy-eval: debug closure handling
  • spawn: spawns off existing namespaces for a sub namespace.

Example:

For usage see the tests or the example below.

var debug = require('')();
// force namespace to be enabled otherwise it assumes process.env.DEBUG is setup
// debug.save('namespace');
// debug.enable(debug.load())
debug = debug('namespace'); // debugger in the namespace
debug(function(){return 'something to log' + someLargeHarryString;});
debug(() => 'something to log ${someLargeHarryString}');
debug('small out'); // prints namespace small out
var childDbg = debug.spawn('child'); // debugger in the namespace:child
childDbg('small out'); // prints namespace:child small out
var grandChildDbg = debug.spawn('grandChild'); // debugger in the namespace:child:grandChild
grandChildDbg('small out'); // prints namespace:child:grandChild small out