@megatherium/log NPM

log

See the whole documentation or the coverage report.

Getting started

Install the module:

$ npm install @megatherium/log

Use the module:

import logger from '@megatherium/log';

const log = logger.init({
	app: 'test',
});

// create a logger for a subfolder
const subLog = log.init(null, 'subfolder');
subLog.debug(`A debugging message.`);
subLog.verbose(`A verbose message.`);
subLog.http(`An HTTP message - usually a request or response...`);
subLog.info(`An information.`);
subLog.warn(`A warning.`);
subLog.error(`An error message.`);

API

Exports

Exports an instance of Logger:

clear(): Promise Clears all logs from the current log directory.
debug(message: ...any): Promise<Message> Logs a message on the debugging channel.
error(message: ...any): Promise<Message> Logs a message on the error channel.
http(message: ...any): Promise<Message> Logs a message on the http channel.
info(message: ...any): Promise<Message> Logs a message on the info channel.
init(filenameOrMeta: string | object | null, directoryName: string): Promise<Logger> Initializes the logger.
log(level: string, message: ...any): Promise<Message> Logs a message on any channel.
verbose(message: ...any): Promise<Message> Logs a message on the verbose channel.
warn(message: ...any): Promise<Message> Logs a message on the warn channel.

Environment variables

MEGATHERIUM_QUIET: boolean If true, messages will not be printed on the console.
NODE_ENV: string If 'production', messages on the debug-channel will be ignored.

Scripts

The following scripts can be executed using npm run:

build Builds the module.
build-docs Builds the documentation.
build-source Builds the source code.
build-tests Builds test-cases from jsdoc examples.
clear Clears the module from a previous build.
clear-coverage Clears the coverage reports and caches.
clear-docs Clears the previous documentation build.
clear-source Clears the previous source build.
clear-tests Clears the generated jsdoc example test files.
fix Runs all automated fixes.
fix-lint Automatically fixes linting problems.
release Runs semantic release. Meant to be only executed by the CI, not by human users.
test Executes all tests.
test-coverage Generates coverage reports from the test results using nyc.
test-deps Executes a depcheck.
test-e2e Executes End-to-End-Tests using cucumber.
test-integration Executes integration tests using jest.
test-lint Executes linting tests using eslint.
test-unit Executes unit tests using mocha.
update Checks for dependency updates using renovate.