consoleplusplus

Console++ - enhance your console

Console++ - enhance your console

Console++ makes your console awesomeR. Colours, logging level and shit like that.

And it works with both PhantomJS and NodeJS (and pretty much any proper JavaScript runtime).

npm install consoleplusplus

Like this:

// here console is not that awesomeR 
 
require("consoleplusplus");
// or 
require("./console++.js"); //< if downloaded locally 
 
// now console is very awesomeR!!! 

Console++ adds a bit of sparkling power to your shy little console. It's not a fancy logging library with all the bells and whistles - it's a "poor man" logger that you can drop in your code without having to rewrite it.

Here is for the lazy developer!

Ehm, like a console genius! Just type stuff like:

console.log("A (boring) console.log message");
 
console.debug("An (irrelevant) console.debug message");
 
console.info("A (somewhat important) console.info message");
 
console.warn("A (quite important) console.warning message");
 
console.error("A (critical!) console.error message");

and you get:

Yes, it manipulates the console object (oh, the horror!) so that you can have some fancy colours, timestamped messages and a bit more. Output looks like:

[LEVEL - TIMESTAMP] THE_MESSAGE

Not all messages are printed. It introduces the concept of level (set via console.setLevel(level)): as you would expect, it goes from DEBUG (lowest, that corresponds to print all the things) to ERROR (highest, that corresponds to print only the errors).

By default the LEVEL portion of the message is coloured (see below how to disable this). Also, you can enable matching colouring for THE_MESSAGE (see methods listing below).

One nifty feature (I think) it's that you have fine-grained control over THE_MESSAGE. You can wrap text within #COLOR{TEXT_TO_COLOR} like:

var message = "#red{this} is #cyan{a} #yellow{nice} message";
console.debug(message);

to print something like:

PLEASE, do read the code to learn more.

Console++ adds some few little methods to the console so you can tune it a bit, based on your taste.

I'd like to be very lazy and say "go read the code", but I guess I can list here those methods.

javascript console.LEVELS = _LEVELS;

// Set/Get Level console.setLevel(level); //< default DEBUG console.getLevel(); console.getLevelName(level); console.getLevelColor(level); console.isLevelVisible(levelToCompare);

// Enable/Disable Colored Output console.enableColor(); //< default enabled console.disableColor(); console.isColored();

// Enable/Disable Colored Message Output console.enableMessageColor(); //< default disabled console.disableMessageColor(); console.isMessageColored();

// Enable/Disable Timestamped Output console.enableTimestamp(); //< default enabled console.disableTimestamp(); console.isTimestamped();

// Set OnOutput Callback (useful to write to file or something) // Callback: function(formattedMessage, levelName) console.onOutput(callback); //< default null

 
## Limitations
* Characters `{` and `}` are reserved: using those will produce an undefined result
 
## Links
 
* On NPM: https://npmjs.org/package/consoleplusplus
* On GitHub: https://github.com/detro/consoleplusplus
 
_Keep calm and make awesome_.