node package manager
Painless code sharing. npm Orgs help your team discover, share, and reuse code. Create a free org »

supercli

THIS PROJECT HAS BEEN DEPRECATED AND MOVED TO REX-SHELL. ALL FUTURE DEVELOPMENT WILL BE ON REX-SHELL.

SuperCLI (DEPRECATED, RETIRED, DEAD, etc.)

A lightweight library for Node.js that will help developers display nice, pretty, colored messages in the console.

Note for NPM Viewers:

For some reason, NPM has not implemented anything more than the most basic Markdown rendering engine for these readme files. As such, the API reference tables at the bottom of this readme are literally unusable. It's much better to view this readme on GitHub directly here: GitHub Readme

How to use it

  1. Require it
var scli = require('supercli');
  1. Use that sheezy like this:

At its most simple, you can just send messages directly from that.

scli("This will send a log message to the console");

Remember: Log as many things as you want!

Don't worry about whether the message is a string, object, integer, whatever. It doesn't matter at all. Any arguments you pass to SuperCLI will get logged properly, no matter what. It's all about rapid development, baby!

scli("String", 42, false, ["a", 1, {foo : bar}], { baz : { bax : zap } });

Outputs

[ SuperCLI: Log ] String 42 false [a, 1, {foo : bar}] { baz : { bax : zap } }

sigh Yeah, I know. Soak it up, baby. SuperCLI gon' be gooood to you.

Alright let's get to the good stuff.

Simple logs

scli.log("An event happened that you shouldn't be worried about");
scli.lg("Save yourself a whole letter when calling this! You're welcome.");

Rather Important Note: As far as I can tell, most of the time people just need basic log messages. The above 3 functions will make that happen, and are identical. I just tried to get more options for people to be comfortable.

scli("Your log message here!");
scli.log("Your log message here!");
scli.lg("Your log message here!");

So yeah. Just giving you a heads up. Because I'm a nice guy like that. Anyway, carry on.

Warnings

scli.warn("Something happened that wasn't an error that you should be worried about.";

Errors

scli.error("Yeah, something actually went wrong here :(");

Success / OK

scli.ok("This is a message telling you it is all good in the hood!");
scli.success("This is an identical message, just using the word success to make people feel better");

Note: Similar to the log() functions above, these two success functions have identical output.

scli.ok("Success message");
scli.success("Success message");

That's not enough for you, eh? Ugh. Fine.

Extensible configuration options

The configuration file looks a little like this

var config = {
  nameVisible : true,
  app : {
    name : "SuperCLI",
    showName : true
  },
  messages : {
    log : "Log",
    error : " Error",
    success : "Success",
    warning : "Warning",
    ok : "OK"
  }
};

And HERE is how you can make this module work better for you.

Change the application name that shows in log messages

Right now, all messages are prepended with SuperCLI when they are displayed. If you want to set that to your own application name, and I highly recommend that you do, you can run this command:

scli.config.appName("Your App Name Here");

Which will change the output of scli.log("Your log here"); to

[ Your App Name Here: Log ] Your log here

If you want to just hide the name entirely, you can!

scli.config.hideName();

Which will change the output of scli.log("Your log here"); to

[ Log ] Your log here

And if you already hid it but want to bring it back, you can do that too!

scli.config.showName();

Which will change the output of scli.log("Your log here"); back to

[ Your App Name Here: Log ] Your log here

Change the message names!

Want to get crazy and change the default words that are used in console messages? Being a generous guy, I am going to let you do that as well.

scli.config.set({
  messages : {
    log : "LOGGY LOG!",
    error : "You fucked up.",
    success : "Shit went right!",
    warning : "WATCH YO ASS FOO!",
    ok : "Shit went right!"
  }
});

Now, running a basic scli.log("Your log message here"); command (assuming you already changed your application name) will output:

[ Your App Name Here: LOGGY LOG! ] Your log message here

Is that seriously still not enough? YOU are a pain in the ass. Fine.

Directly access color functions using $.

Note: The lowercase functions are regular text, the UPPERCASE functions are the bolded versions

IMPORTANT: Unlike the standard calls, the direct $ color functions only accept a single string as an argument. No objects, no arrays, none of it. Just one single thing that you can put in the center of a string. Sorry.

scli.$.red("All this text will be red");
scli.$.MAGENTA("All this text will be bolded magenta");

Here's the full list of colors and their functions:

Color Light Bold/Bright
Red scli.$.red() scli.$.RED()
Green scli.$.green() scli.$.GREEN()
Yello scli.$.yellow() scli.$.YELLOW()
Blue scli.$.blue() scli.$.BLUE()
Magenta scli.$.magenta() scli.$.MAGENTA()
Cyan scli.$.cyan() scli.$.CYAN()
White scli.$.white() scli.$.WHITE()

Full API Reference

All functions below assume that you have already required SuperCLI as var scli = require('supercli');

Function Parameters Output Color Purpose
scli() Anything Cyan Standard log message
scli.log() Anything Cyan Standard log message
scli.lg() Anything Cyan Standard log message
scli.ok Anything Green Success message
scli.success() Anything Green Success message
scli.error() Anything Red Error message
scli.warn() Anything Yellow Warning message
scli.config.appName() String: New Name -- Sets application name used in output
scli.config.set() Object: New Settings -- Changes configuration object. See above!
scli.config.hideName() -- -- Removes application name from future console output
scli.config.showName() -- -- Shows application name in future console output
scli.$.red() String: Message Light Red Log message without frills in one color
scli.$.RED() String: Message Bright/Bold Red Log message without frills in one color
scli.$.green() String: Message Light Green Log message without frills in one color
scli.$.GREEN() String: Message Bright/Bold Green Log message without frills in one color
scli.$.yellow() String: Message Light Yellow Log message without frills in one color
scli.$.YELLOW() String: Message Bright/Bold Yellow Log message without frills in one color
scli.$.blue() String: Message Light Blue Log message without frills in one color
scli.$.BLUE() String: Message Bright/Bold Blue Log message without frills in one color
scli.$.magenta() String: Message Light Magenta Log message without frills in one color
scli.$.MAGENTA() String: Message Bright/Bold Magenta Log message without frills in one color
scli.$.cyan() String: Message Light Cyan Log message without frills in one color
scli.$.CYAN() String: Message Bright/Bold Cyan Log message without frills in one color
scli.$.white() String: Message Light White Log message without frills in one color
scli.$.WHITE() String: Message Bright/Bold White Log message without frills in one color

Pierce Moore

Email : me@prex.io
Twitter : @kiapierce