Git Product home page Git Product logo

loggit's Introduction

loggit

๐ŸŒฒ A simple and beautiful logging utility for NodeJS.


loggit is a simple yet robust logger utility for NodeJS. To a degree, it is a wrapper around chalk + console.log, so that I don't need to install chalk in every project and to standardize the way I do logging in various projects.

Install

You can install it with NPM or Yarn:

yarn add loggit

npm install loggit

Usage

loggit exposes two modules:

  • log - A very simple logger function.
  • createLogger - Returns a customized logger function.

log

Provide log with a message string, as well as an optional color (of type chalk.ForegroundColor), and it will be logged to the console.

import { log } from 'loggit';


log('hello world');

log('some error', 'red');
Argument Type Default
message string -
color chalk.ForegroundColor 'whiteBright'

createLogger

createLogger allows you to create loggers for various different "tasks" in your app/script. It is more akin to something like winston than a regular console.log, in that it will log a timestamp and make your "task" very visible using a chalk.BackGroundColor.

import { createLogger } from 'loggit';

//  Create a simple logger with default options
const logInfo = createLogger('info');
//  Create a success logger, where the "task" will be logged with a green BG.
const logSuccess = createLogger('success', {
  taskColor: 'bgGreen',
});
//  Create an error logger, where the "task" will be red and the timestamp will be bright magenta.
const logError = createLogger('error', {
  taskColor: 'bgRed',
  timestampColor: 'redBright',
});

//  Use the loggers
logInfo('Started the app');

logSuccess('Things are going well');

logError('Uh oh, something went wrong');

This example would write the following to the console:

An example of createLogger module, displaying three items logged to the console

Argument Type Default
task string -
config CreateLoggerConfig See below.
config.taskColor chalk.BackgroundColor 'bgCyanBright'
config.timestampColor chalk.ForegroundColor 'cyanBright'

Note that createLogger returns the log function, meaning that you can also customize the message color when using your custom logger.

import { createLogger } from 'loggit';

const logInfo = createLogger('info');

logInfo('I will be yellow!', 'yellow');

Contributing

If you have ideas or suggestions on how to improve this package, feel free to file an issue or better yet open a pull request! Please follow the existing code style (enforced by ESLint anyway), and please add/alter unit tests for any new or changed functionality.

License

Licensed under MIT.


โœŒ๏ธ Made by Dave

loggit's People

Contributors

dependabot[bot] avatar fossabot avatar himynameisdave avatar

Stargazers

 avatar

Watchers

 avatar  avatar  avatar

Forkers

fossabot

loggit's Issues

better object logging

Instead of [object Object] it would be nice to get a legit readout of the insides of the object or array, line by line.

Break up on newline

break the incoming message on newlines and then you will be able to fully encapsulate the thing in a "box"

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.