logmatic v2.1.0

CONTRIBUTERS REQUESTED

For anyone interested with supporting this passion project, please check out Contributing.

Logmatic

An overly complicated yet functional logger.

Installation

For all systems, please use:

npm i logmatic --save-exact

For Typescript

Typescript seemingly has a vendetta against index signatures. Whenever possible, set the following setting in your tsconfig.json or such:

{
    "compilerOptions": {
        // ...
        "noPropertyAccessFromIndexSignature": false,
        // ...
    }
}

Or you must use the following to access your logging statements:

log["fatal"]("a");

As logmatic is currently in a very unstable state, many items may change in the future.

Usage

To get started, import the project into your file and initialise the logger:

const { Logger } = require('logmatic');
// OR
// import { Logger } from 'logmatic';

const log = new Logger("name");

For the default added levels, use the following:

For your custom levels, please see Levels below

Options

The following section is expecting you have imported the class. It will then demonstrate how to set the option.

Console

Enabled

Whether console logging is enabled

Default: true

const log = new Logger("name", { console: { enabled: true }})

Log Level

The minimum level to log. This corresponds with the position in the array the level is. See Levels.

Default: 1

const log = new Logger("name", { console: { logLevel: 1 }})

Suppress Warnings

Whether to suppress warnings or errors emitted by the logger

Default: false

WARNING: This option is currently not in use.

const log = new Logger("name", { console: { supressWarnings: false }})

Format

Whether to format and colourise any JSON output

Default: false

const log = new Logger("name", { console: { format: false }})

Indent

Whether to indent any JSON output

Default: 0

const log = new Logger("name", { console: { indent: 0 }})

Files

WARNING: This option is currently not in use.

Note: This module requires that several options are filled in tandem.

Enabled

Whether file logging is enabled

Default: false

const log = new Logger("name", { files: { enabled: false }})

Path

The log directory

In-depth: if path = /path/to/dir/ then logs will be stored as /path/to/dir/log.txt etc.

Default null

const log = new Logger("name", { files: { path: null }})

Naming

How to name the files

Default: null

WARNING: No example for this option as it is undetermined how it will be parsed.

File type

The type of file stored

Default: json

const log = new Logger("name", { files: { type: "json" }})

Web

Enabled

Whether web (POST) logging is enabled

Default: false

const log = new Logger("name", { web: { enabled: false }})

URL

The URL to post to

Default: null

const log = new Logger("name", { web: { url: null }})

Data Type

The data type sent

Default: json

const log = new Logger("name", { web: { type: "json" }})

Every number

How many logs to store before POSTing to avoid getting ratelimited

Default: 5

const log = new Logger("name", { web: { every: 5 }})

Levels

This logger allows you to add your own levels, following out format. Formatted the following:

const log = new Logger("name", { levels: { name: "level", colour:"red" }})
// **OR**
const log = new Logger("name", { levels: [{ name: "level", colour:"red" }]})

The colour should be derived from the package console-log-colors or from a slimmed list included in the types.

Also, you are able to overwrite existing functions. For example, you could overwrite the info logger level by redefining it.

Functions

The logger allows you to pass custom functions or callbacks to handle the logs on your own.

const function = (level: number, ...data: any[]) => {
    return { level, data }
}

const log = new Logger("name", { funcs: function});
// **OR**
const log = new Logger("name", { funcs: [function]});