npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

bows

v1.7.2

Published

Rainbowed console logs for chrome, opera and firefox in development.

Downloads

7,242

Readme

Bows

Colors Safe, production happy, colourful logging - makes reading your logs much easier.

(Rain)bows makes logging debug messages in your apps much nicer.

  • It allows you to create custom loggers for each module in your app, that prefix all log messages with the name of the app, so that you can scan the messages more easily.
  • It colors the prefix differently and distinctly for each logger/module so that it's even easier to read.
  • It can be safely used in production, where logging will be disabled by default, so that you can leave log messages in your code.
  • Loggers safely wrap console.log, to maintain the line number from where they are called in the console output.

Example Output

Installation

If you are using browserify, you'll want something like:

npm install bows --save

If you use Bower:

bower install bows --save

Otherwise, download either bows.js or bows.min.js.

Features

  • Easily create prefixes for your logs, so that you can distinguish between logs from different parts of your app easily.
  • If supported, prefixes will be color coded for even easier identification.
  • Can be safely used in production, as logs will be disabled for your users, but can be enabled by you with a local storage flag.
  • Greppable logs by setting localStorage.debug = /Foo/ to only display logs for modules matching the regex to help you focus in development.
    • Invert regex to remove logs matching with: localStorage.debug ='!/Foo/
  • Customize the localStorage key by setting localStorage.andlogKey and you can use localStorage.<anyKeyYouWant> to set your log grepping.

Browser Support

  • Works in all reasonable browsers
  • Supports colors in chrome, opera, firefox >= 31.0, electron

Usage

  • Works great in browserify and the browser.

  • Creating a new logger:

    • Browserify: var log = require('bows')("My Module Name")
    • Browser: var log = bows("My Module Name")
  • Then using it is easy:

    • log("Module loaded") //-> "My Module Name | Module Loaded"
    • log("Did something") //-> "My Module Name | Did something"
  • Typically each seperate module/view/etc in your app would create it's own logger. It will be assigned it's own color to make it easy to spot logs from different modules.

  • You can pass additional arguments to bows which will be automatically prepended to each message, e.g.:

    var log = bows("My App", "[ChuckNorris]");
    log("Kicks ass!");
    //outputs:
    //My App         | [ChuckNorris] Kicks ass!
  • Logging is disabled by default. To enable logging, set localStorage.debug = true in your console and refresh the page.

  • To disable logging again, you must do delete localStorage.debug (localStorage.debug = false will not work).

  • You can leave the code in in production, and log() will just safely no-op unless localStorage.debug is set.

  • Where colors are not supported, bows will just log plain text, but still with the module prefix.

    • If you wish to manually disable colors in an environment because detection is incorrect, set localStorage.debugColors = false, to reenable delete localStorage.debugColors.

Example

  //Should be set in your console to see messages
  localStorage.debug = true
  //Configure the max length of module names (optional)
  bows.config({ padLength: 10 })

  var logger1 = bows('Module 1')
  var logger2 = bows('Module 2')
  var logger3 = bows('Module 3')

  logger1("We started up")
  logger2("We did something too")
  logger3("I'm here")
  logger3("I'm still here")
  logger2("I'm tired")
  logger1("We're done here")

Result:

Example Output

Test

Status: Build Status

This project uses phantomjs for tests. To run the tests install the development dependencies and then run:

npm test

New tests

Add a file in test, refer to enabled.html/disabled.html, then add the script to the array in test/index.js.

License & Credits

MIT

Copyright @philip_roberts / latentflip.com.

With contributions from:

Bows depends on andlog, a nice little logging module by @HenrikJoreteg.

Contributing

Please feel free to raise issues, or make contributions:

git clone https://github.com/latentflip/bows.git
cd bows
npm install #install dependencies
#edit bows.js
npm test
npm run build.js #build dist/bows.js and dist/bows.min.js, also done by `npm test`