loglady

One Day the Sadness Will End - Log Lady - Art Print - 8x10, by DecisionandRevision at Etsy

Utility for logging categorized and formatted output in cli apps or when debugging.

• Installation
• Usage
• Examples
• Roadmap

Installation

npm install loglady

Usage

const loglady = require('loglady');
 
loglady.setMuted(isMuted);
loglady.setVerbose(isVerbose);
loglady.setLogFunc(logFunc);
loglady.setIgnoreFuncRegex(regex);
loglady.clearHistory();
loglady.log(...args);
loglady.logVerbose(...args);
loglady.json(json);
loglady.error(err);
loglady.pipeStdout(data);
loglady.section(heading);
loglady.action(heading);
loglady.command(cmd);
loglady.fncall(fn);
loglady.intermediate(message);
loglady.showIntroHeader(title, barChar = '#');
loglady.endWithABang(msg);
loglady.endInTotalDespair(err);
loglady.spyOn(obj, name = null);

Examples

Get a taste of loglady by running node examples/log-all-the-things.js and you'll see something like:

Roadmap

• Some sort of (configurable) timestamps
• Log data sets as ascii tables
• Customizable styling (colors and text-decoration)
• Customizable ascii images
• Browser support
• Log history
• Saving log history to a file
• Option to buffer output and log later
• Smart logging based on type of input (string, error etc)
• Spy on an object and log all its function calls
• Styled boolean logging
• Ability to theme output using TextMate/Sublime/Atom color schemes

Developing

Tasks

Building the distributed version

npm run dist

Releasing a new version

npm run release -- (major|minor|patch|x.x.x)

Todo

• Watch -> build
• JS linting
• Visual examples in README
• Interactive tryout