ci-logger
v7.0.0
Published
Very simple logger for CI environments.
Downloads
32,018
Maintainers
Readme
CI Logger
CI Logger is a simple logger designed for CI environments - no colors, no timestamps - just data. Log entries can be formatted to indicate the results of a previous message, and the process can be terminated of an error is logged.
Usage
const { log, Levels } = require('ci-logger');
log({ message: 'Retrieving data from somewhere...' });
// Retrieving data from somewhere...
log({
message: 'Error retrieving data',
isResult: true,
level: 'warn'
});
// ⮡ Error retrieving data
log({
message: 'Error retrieving data',
isResult: true,
level: Levels.Error,
exitOnError: true,
errorCode: 2
});
// ⮡ Error retrieving data
// Fatal error - exiting (2)
The log
function must be passed an object with the following possible
properties:
- The
message
property contains the message to be logged and is the only required property. It can be any value exceptundefined
ornull
. - The
level
property must be one of the stringsinfo
,warn
, orerror
(which are the values of theLevels
enumeration exposed by the module -Levels.Info
,Levels.Warn
,Levels.Error
). The default value isinfo
(Levels.Info
). - The
isResult
property is a Boolean value intended to indicate the result of an operation, primarily intended to simplify reading busy CI console logs. IfisResult
is true, the logged message is indented and prefixed with theresultPrefix
string value to indicate it's the result of the preceding message. If false, the message isn't altered. The default value ofisResult
isfalse
. The default value forresultPrefix
is '\u2BA1' ('⮡ '). - The
exitOnError
property is a Boolean value indicating whether the process should exit if an error is logged. If true, the error is logged, a fatal error message is logged, andprocess.exit
is called with theerrorCode
value (an integer). The default value ofexitOnError
is true, and the default value oferrorCode
is 1.
The getLogEntry
function can be used to retrieve a complete log entry as it
would be logged, with default values populating any unspecified values.
const { getLogEntry } = require('ci-logger');
const logEntry = getLogEntry({
message: 'Retrieving data from somewhere...'
});
// logEntry = {
// message: 'Retrieving data from somewhere...',
// isResult: false,
// level: 'info',
// exitOnError: true,
// errorCode: 1,
// resultPrefix: '\u2BA1'
// }
Default log entry values
The default values for errorCode
, exitOnError
, isResult
, level
, and
resultPrefix
, as detailed previously, are used when they're not specified for
a specific log entry. If desired, those defaults can be changed using the
setLogEntryDefaults
function. This function accepts an object with any or all
of these values.
const { setLogEntryDefaults, Levels } = require('ci-logger');
setLogEntryDefaults({ errorCode: 2, level: Levels.Warn });
The default values can be set back to the original values via the
resetLogEntryDefaults
function.
const { resetLogEntryDefaults } = require('ci-logger');
resetLogEntryDefaults();