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

@samislam/log

v1.1.4

Published

log is a simple utility that helps in logging colorful outputs to the console. This module depends on the popular, colors module.

Downloads

54

Readme

logJS

Origiinally Created in 19 - 01 - 2021

log is a simple utility that helps in logging colorful outputs to the console. This module depends on the popular, colors module.

Setup:

In your work directory:

npm i @samislam/log

In your NodeJS app:

const log = require("@samislam/log");

Usage

log is very simple and stright forward, it's not a new learning curve that you have to master. let's start with the first function which is log()


log([arg1, arg2, arg3...])

rather than writing console.log() all the time, you can now write log() only, for example:

log(1, 2, 3)
log("hi")
log("Hello", "Everyone")
log({ name: "mr.X" })

screenshot_1.png

log.SOMETHING()

logJS have a pre-defined themes for you, however you can create your own themes, we'll see how you can do that later in this guide. The following are all of the pre-defined themes for you by logJS.

log.error("Testing the log module")
log.err("Testing the log module")
log.e("Testing the log module")
log.f("Testing the log module")
log.fail("Testing the log module")
log.faild("Testing the log module")
log.danger("Testing the log module")
log.success("Testing the log module")
log.ok("Testing the log module")
log.s("Testing the log module")
log.w("Testing the log module")
log.warn("Testing the log module")
log.warning("Testing the log module")
log.note("Testing the log module")
log.i("Testing the log module")
log.info("Testing the log module")
log.information("Testing the log module")
log.done("Testing the log module")

screenshot_2.png


log.label

along with the pre-defined themes, logJS have pre-defined labels for you. There are some kind of things that are simpler to see in order to understand, see the following example:

log.error(log.label, "Testing the log module");
log.err(log.label, "Testing the log module");
log.e(log.label, "Testing the log module");
log.f(log.label, "Testing the log module");
log.fail(log.label, "Testing the log module");
log.faild(log.label, "Testing the log module");
log.danger(log.label, "Testing the log module");
log.success(log.label, "Testing the log module");
log.ok(log.label, "Testing the log module");
log.s(log.label, "Testing the log module");
log.w(log.label, "Testing the log module");
log.warn(log.label, "Testing the log module");
log.warning(log.label, "Testing the log module");
log.note(log.label, "Testing the log module");
log.i(log.label, "Testing the log module");
log.info(log.label, "Testing the log module");
log.information(log.label, "Testing the log module");
log.done(log.label, "Testing the log module");

screenshot_3.png

  • You can only use log.label as the first argument in a log.SOMETHING() function.
  • You can't use log.label on log(), you can only use it on log.SOMETHING().
  • "Not valid" doesn't mean it's going to throw an error, it just means that doing it this wrong way doesn't have sence.

~ The following examples are not valid:

log(log.label, "Hello world!"); // Symbol() "Hello world!"
log.error("Test", log.label) // Test Symbol()

Custom Theming

logJS is shipped to your project with pre-defined themes such as the "error", "success" and so on, however, you're not limited to use these, you can create your own themes and use them accross multiple files, thanks to logJS singleton pattern design.

How?

Pass two arguments and an optional last one to the log.set function,

log.set(name, theme [, label])

log.set(name, theme [, label]);

| Parameter | Description | | --- | --- | | name | The name of the method that you want to call, for example, setting this to "hello" will make your method looks like log.hello() | | theme | For example, you can write "red" or "bold" or "yellow" | | label | Setting this is optional, for example, you can set this to "Hello: ", therefore, when you use your log function with log.label passed to it as the first argument, (ex: log.yourCustomName(log.label, "Application is launched"))  then the output on the shell will be Hello: Application is launched. - If you didn't set the label argument, it will be the name of your method capitalized by default. |

For Example:

Let's say we have the following code:

const log = require("log");
log.set("merhaba", "blue", "Hello: ");
log.merhaba("The application is now launched")
log.merhaba(log.label, "The application is now launched")

screenshot_4.png

FAQ:

Q1: From where I can know the list of accepted colors?

A: Remember, this module is depending on the popular colors module, you can pickup one of the styles from there, and here are some additional ones for you "underline", "brightRed", "bgRed".

  • Please Note, You can't mix styles all together, for example you can't do something like this:
const colors = require('colors/safe') // say for example you decided to install the colors module and generate a new style to apply it on logJS
const myTheme = colors.red().bold();
log.set("wrongOne", myTheme, "Don't try me again"); 
log.wrongOne(log.label, "Testing the log module") // TypeError: colors[theme[style]] is not a function (this is an internal module error)

Q2: It seems like logJS is unable to memorize my themes from one module to another?

A: Please make sure that your module that have the themes defined inside of it is being loaded an invoked by your code before the the other modules, this is very logical, you have to call log.set() first, and then you can use your log.myCustomTheme() afterwards.