logda

logda

logda is a lightweight efficient logger thought for developers who use to debug their libraries running in production when something goes wrong, without worrying about global objects or reconfigurations.

• It works as a console wrapper but with level capabilites, so no logs will be written down the desired level.
• It receives arrow functions instead of built messages, so when running under the configured level, no heavy log operations will be executed. Also, these operations will never break your app as they run into a catcheable block.

Features

• :rocket: Efficient logger: Will not run unnecessary operations, as all logger operations are delegated with an arrow function
• :sparkles: Pretty printer: When enabled, distinguish different modules or files using tags
• :bulb: Developer ready: Set the logda.level into your window.localStorage to enable logda loggers for the apps you're reviewing (if you don't remove it from the local storage, you'll be able to review logs the next time you visit the page!)

Usage

Install

npm install logda --save

Create a root logger for your module: (optional but recommended for better log messages)

logger.js

import {logda} from 'logda'

const LOG = logda('my-app')

LOG.info(() => 'Logda log initialized')

export default LOG

• The exported LOG is a logda logger already, you can call all level methods on it, but also allows creating sub-loggers by calling the logger method. In this case, the .info call (if info is enabled) will print:

  [INFO] my-app> Logda log initialized
  

Import this root logger to all files requiring a logger: (for example, MyService.js)

MyService.js

import LOG from './logger.js

const log = LOG.logger('MyService')

class MyService {
    // ...
    aMethod(params) {
      log.debug(() => ['aMethod', {params}])
    }
}

• The created log is a LOG sub-logger that when debug is enabled will print a message like:

  [DEBUG] my-app|MyService> aMethod {...}
  

Write logs

Logda is intended to be used with arrow functions, so to log messages, call the level method with an arrow function:

log.debug(() => 'log messages as simple strings')
log.debug(() => ['log complex data inside an array', {
  aKey: 'aValue',
  another: calculatedData()
}])

Encapsulating data into an object {} will help you to review it correlating key-valued data in message logs

Change the log level

Logda accepts 'trace', 'debug', 'info', 'warn', 'error', 'off' levels.

Console correspondency:

• log.trace => console.trace
• log.debug => console.log
• log.info => console.info
• log.error => console.error

'off' is intended to disable all logs including 'error' logs.

• Developer-only level:

In your browser's console, write:

window.localStorage.setItem('logda.level', 'debug')

• Application level:

In case that you want a lower level to log messages (Node environments, loc/dev builds, ...), you can enable a specific logda level programmatically:

logger.js

import {logda, setLogdaLevel} from 'logda'

setLogdaLevel('info')

const LOG = logda('my-app')

LOG.info(() => 'Logda log initialized')

export default LOG

In this case, 'Logda log initialized' will be printed directly

In browser environments, the localStorage 'logda.level' (if set) will override the application level

Contributing

:wrench: Maintenance info

Available Scripts

npm run...

• phoenix to reset the project reinstalling its dependencies
• lint to check the code format
• test to run the project tests
• check to run both lint&test
• coverage to get an html test coverage report
• build to build the project
• versiona to publish a new version of the library (in Travis CI)

Create a PR

Use the PR template to explain the better possible:

• Why the PR should be merged
• How can be checked

Deploying

This project uses Travis CI for:

• PR validation
• Merge to master validation
• NPM publications on Release tag creation

To create a new Release, take in mind:

• The Release Tag must be named vX.Y.Z where X.Y.Z are the semver numbers that will correspond to the published package's version.
• Travis CI will launch the versiona.js script which will:
  • Update the package.json to the X.Y.Z version set in the Release Tag
  • Publish the NPM package with the X.Y.Z version