You're Invited:Meet the Socket Team at BlackHat and DEF CON in Las Vegas, Aug 7-8.RSVP
Socket
Socket
Sign inDemoInstall

@matrixai/logger

Package Overview
Dependencies
Maintainers
3
Versions
16
Alerts
File Explorer

Advanced tools

Install Socket

Detect and block malicious and high-risk dependencies

Install

@matrixai/logger

Python-like JavaScript Logger


Version published
Maintainers
3
Created

Readme

Source

js-logger

staging:pipeline status master:pipeline status

This library provides a JavaScript/TypeScript logger inspired by Python's logger.

  • Simple logging with default handlers supporting console.log, console.error, and process.stderr.
  • Fast, logging level checks or log filters are applied before log records are created
  • Complex log records properties ssupport lazy evaluation, so they evaluated only when they need to be rendered
  • Flexible composition of loggers, handlers and formatters
  • Custom formatting using template literals
  • Supports structured logging through a JSON formatter
  • Supports hierarchical logging through parent-child logger graph
  • CI/CD tests on Linux, MacOS and Windows
  • Zero runtime dependencies!
  • Comprehensive continuous benchmarks in CI/CD

Installation

npm install --save @matrixai/logger

Usage

import Logger, { LogLevel, StreamHandler, formatting } from '@matrixai/logger';

const logger = new Logger('root', LogLevel.INFO, [
  new StreamHandler(
    formatting.format`${formatting.date}:${formatting.level}:${formatting.key}:${formatting.msg}:${formatting.data}`,
  ),
]);

logger.debug('Hello world', { a: { b: [123, 456] } });
logger.info('Hello world', { 123: { b: [123, 456] } });
logger.warn('Hello world', { lazy: () => 'string' });
logger.error('Hello world', formatting.format`my custom format`);

const loggerChild = logger.getChild('child');

loggerChild.info(
  'Hello world',
  { 123: { b: [123, 456] } },
  formatting.format`${formatting.keys}:${formatting.msg}:${formatting.data}`,
);

There's lots more options available in the source code. See the docs and see the source code for more details.

Development

Run nix-shell, and once you're inside, you can use:

# install (or reinstall packages from package.json)
npm install
# build the dist
npm run build
# run the repl (this allows you to import from ./src)
npm run tsx
# run the tests
npm run test
# lint the source code
npm run lint
# automatically fix the source
npm run lintfix

Docs Generation

npm run docs

See the docs at: https://matrixai.github.io/js-logger/

Publishing

Publishing is handled automatically by the staging pipeline.

Prerelease:

# npm login
npm version prepatch --preid alpha # premajor/preminor/prepatch
git push --follow-tags

Release:

# npm login
npm version patch # major/minor/patch
git push --follow-tags

Manually:

# npm login
npm version patch # major/minor/patch
npm run build
npm publish --access public
git push
git push --tags

FAQs

Package last updated on 15 Nov 2023

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap
  • Changelog

Packages

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc