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

@peter.naydenov/log

v1.1.0

Published

Controlable log message system

Downloads

12

Readme

Log ( @peter.naydenov/log )

version license

Log message system with customizable log-function and controllable message activity levels.

Why?

You need a messages during debug process but you don't want to see them in production. Log system has single point of setting it as active or not active and how verbose should be.

Another option is to modify your log-function to send messages to your external logging solution.

Take a look on Alternative Ideas section for other ideas how to use it.

How to use it?

Simplest possible use case:

const log = createLog ();  // Create a log function with all default settings
log ({message:'hello'})
// -> console message '[debug]: hello'  
// if you don't provide your log-function, there is a default function that will create and send a console message.

// If we want to stop all messages to console, change a log definition
// was -> const log = createLog ();
// to -> const log = createLog ({level:0});
// log-level 0 definition will ignore all the messages provided to the log

Let's see a another example:

const log = createLog ({level:2});
log ({message: 'Sweet'}, level:3 )
// log will ignore message 'sweet', because message level is lower then log-level. This definition of the log will show only level 1 and level 2 of the messages.
log ({message:'again'})
// Message 'again' will not be ignored because default message level is 1

Installation

Write into the console:

npm i @peter.naydenov/log

Import in your project

import createLog from '@peter.naydenov/log'

or require it

const createLog = require('@peter.naydenov/log')

createLog ()

The function createLog will generate log function for you. You have defaults, so you can call createLog without parameters. Providing a parameters can customize your 'log' behaviour. Result of calling createLog is a function.

import createLog from '@peter.naydenov/log'

const log = createLog ( options, logFunction )   // Create a log

/**
 *  options - object. If you need to provide logFunction but no options -> set it to empty object. {} 
 *  option properties:
 *   - level: Available to logFunction as 'logLevel'.
 *   - type: Overwrite default message type
 *   - deffaultMessageLevel: Overwrite default message level
 *   - all custom props are available in logFunction
 * 
 * 
 *  logFunction: 
 *   - a function that will be returned on calling a 'log' with a log-object
 *   - the logFunction could return a promise if it's needed 
 *  
 *  Note: options and logFunction are optional arguments.
 * 
 *  log is a function that expect a log-object
 *  log ( logObject ) -> will return the result of logFunction
 */

log ({ 
          message: 'Hello'  // (required) Provide a message
        // level : 2 // (optional) Activity level of this specific message. Deffault is 1.
        // type : 'error' // (optional). Type of the message: 'error', 'warning', or 'log'
    })

Activity levels

Default activity levels works like that:

  • Setup a log-level by setting a property level in option object during 'createLog' function call. If it's not defined, log-level will be 1000. Idea behind log-level is to minimize the amount of messages by setting smaller log-level. If you want to ignore all messages, set log-level to 0;
  • If message has a level property, it will be used as message level. If not, default message level will be used. Default message level is 1;
  • If message level is higher then log-level, message will be ignored. If message level is equal or lower then log-level, message will be processed;

You have the power to build your own activity levels. Here is how:

const
      msg = 'My message' // Some message
    , msgDefault = ['basic','warning', 'all' ] // Define default message level
    , log = createLog (
                          { 
                                level: 'basic'                    // Setup a log-level
                              , defaultMessageLevel: msgDefault   // Setup default message level if not defined
                          }
                        , ({ message, level, logLevel }) => { // Custom log-function
                                  if ( level.includes(logLevel) ) {   // Test if log-level is included in message level
                                            return message
                                      }   
                                  return null
                            }) 
    ;
 let 
         res1 = log ({ message: msg, level: [ 'basic', 'warning', 'all'] })
      ,  res2 = log ({ message: msg, level: [ 'warning', 'all'] }) // Log-level is not included in message level, so the message will be ignored. Will return null
      ,  res3 = log ({ message: msg }) // Message level is not set and will get default message level
      ;
// res1 -> 'My message'
// res2 -> null
// res3 -> 'My message'

Alternative Ideas

Library log is prety abstract, so we can use it in different ways. Here are some ideas:

  • Wrap code for execute it only for specific user role;
let
      a = 'not changes'
    , user = { role: 'guest' }
    ;
const roleSpecific = createLog (
                                  { 
                                        defaultMessageLevel: [ 'guest', 'admin', 'owner' ] 
                                      , level : user.role
                                    },
                                  ({ level, logLevel, fn }) => {
                                          if ( level.includes(logLevel)  ) {   // execute user role specific code..
                                                  return fn()
                                              }
                                    return null
                              });

roleSpecific ({ level: [ 'admin', 'owner'], fn: () => a = 'admin changed' }) // We don't need a message property here...
// ->  a === 'not changes'
roleSpecific ({ level: [ 'guest'], fn: () => a = 'guest changed' })
// -> a === 'guest changed'

roleSpecific ({ fn: () => a = 'general code' }) // When level is not provided, default message level will be used: [ 'guest', 'admin', 'owner' ]
// -> a === 'general code'

Credits

'@peter.naydenov/log' was created and supported by Peter Naydenov.

License

'@peter.naydenov/log' is released under the MIT License.