Compare commits

..

No commits in common. "4e6b3418df9c3530c46480abdcfef4a5a3d7df80" and "23d880e96d9dc3c0fd7b32ee7f158a7ddc4e44d9" have entirely different histories.

8 changed files with 46 additions and 124 deletions

View File

@ -161,7 +161,7 @@
"no-var": "warn", "no-var": "warn",
"no-void": "warn", "no-void": "warn",
"no-whitespace-before-property": "error", "no-whitespace-before-property": "error",
"nonblock-statement-body-position": ["warn", "below"], "nonblock-statement-body-position": "warn",
"object-curly-spacing": [ "object-curly-spacing": [
"warn", "warn",
"always" "always"

View File

@ -3,6 +3,7 @@
Simple logger I wrote to have a unified system for logging throughout my projects. Simple logger I wrote to have a unified system for logging throughout my projects.
## TODO ## TODO
- Automatic file rotation, currently only rotates files on startup
- Discord webhook, need to write a separate package for that, don't want to add the entirety of d.js as a dep just for a webhook - Discord webhook, need to write a separate package for that, don't want to add the entirety of d.js as a dep just for a webhook
## Features ## Features
@ -18,15 +19,10 @@ The child processes are expected to be attached with the attach() method found i
## Logger Options ## Logger Options
``` ```
{ {
//////// SHARED BETWEEN CLIENT & MASTER
guard: '_logger', // Message guard, e.g this property has to be true in the IPC message for the logger to read it
debug: false, // On the master logger this determines whether the output is written to console (i.e. will always be written to file), on the client this determines whether it is sent to the master at all
customTypes: [], // Log types, defaults are 'error', 'warn', 'info', 'debug', 'status'. Each one of these has an associated shorthand function, the custom ones will receive one too, e.g. adding 'access' to the custom types will add a logger.access() function customTypes: [], // Log types, defaults are 'error', 'warn', 'info', 'debug', 'status'. Each one of these has an associated shorthand function, the custom ones will receive one too, e.g. adding 'access' to the custom types will add a logger.access() function
/////// MASTER EXCLUSIVE
customStreams: [], // File streams, by default there are streams for error and default customStreams: [], // File streams, by default there are streams for error and default
customTypeMapping: {}, // This maps a type to a stream, e.g. adding "warn": "error" will pipe any warnings to the error log file customTypeMapping: {}, // This maps a type to a stream, e.g. adding "warn": "error" will pipe any warnings to the error log file
customColors: {}, // Supports any colours chalk.js supports, e.g. "warn": "green" will turn warning outputs green customColors: {}, // Supports any colours chalk.js supports, e.g. "warn": "green" will turn warning outputs green
fileRotationFreq: 1, // How frequently to roate files in days - will not work with anything less than 1 day currently debug: false
directory: './logs', // Directory in which to write log files
} }
``` ```

View File

@ -1,6 +1,6 @@
{ {
"name": "@navy.gif/logger", "name": "@navy.gif/logger",
"version": "1.2.0", "version": "1.1.9",
"description": "Logging thing", "description": "Logging thing",
"main": "index.js", "main": "index.js",
"author": "Navy.gif", "author": "Navy.gif",

View File

@ -22,20 +22,5 @@ module.exports = {
info: 0x76a9d8, info: 0x76a9d8,
debug: 0xd8abd7, debug: 0xd8abd7,
status: 0x72d4d7 status: 0x72d4d7
},
MasterOptions: {
fileRotationFreq: 1,
directory: './logs',
customTypes: [],
customStreams: [],
customTypeMapping: {},
customColors: {},
debug: false,
guard: '_logger'
},
ClientOptions: {
debug: true,
guard: '_logger',
customStreams: []
} }
}; };

View File

@ -4,15 +4,13 @@ class LoggerClient {
static MaxChars = 0; static MaxChars = 0;
constructor (opts = Defaults.ClientOptions) { constructor (opts) {
this.name = opts.name || opts.constructor.name; this.name = opts.name || opts.constructor.name;
if (this.name === 'Object') if (this.name === 'Object') this.name = 'unknown';
this.name = 'unknown';
this.name = this.name.toUpperCase(); this.name = this.name.toUpperCase();
if (this.name.length > LoggerClient.MaxChars) if (this.name.length > LoggerClient.MaxChars) LoggerClient.MaxChars = this.name.length;
LoggerClient.MaxChars = this.name.length;
const { customTypes = [] } = opts; const { customTypes = [] } = opts;
this.types = [ ...customTypes, ...Defaults.Types ]; this.types = [ ...customTypes, ...Defaults.Types ];
@ -22,23 +20,17 @@ class LoggerClient {
}); });
} }
this.guard = opts.guard || Defaults.ClientOptions.guard;
} }
transport (message, opts) { transport (message, opts) {
if (typeof message !== 'string') if (typeof message !== 'string') message = inspect(message);
message = inspect(message);
const spacer = ' '.repeat(LoggerClient.MaxChars - this.name.length); const spacer = ' '.repeat(LoggerClient.MaxChars - this.name.length);
const header = `${`[${this.name.substring(0, LoggerClient.MaxChars)}]${spacer}`} `; const header = `${`[${this.name.substring(0, LoggerClient.MaxChars)}]${spacer}`} `;
// eslint-disable-next-line no-console // eslint-disable-next-line no-console
if (!process.send || !process.connected) if (!process.send || !process.connected) console.log(`${header} ${message}`);
// eslint-disable-next-line no-console else process.send({ _logger: true, header, message, ...opts });
console.log(`${header} ${message}`);
else
process.send({ [this.guard]: true, header, message, ...opts });
} }

View File

@ -8,67 +8,41 @@ const { inspect } = require('node:util');
const Defaults = require('./Defaults'); const Defaults = require('./Defaults');
const DAY = 1000 * 60 * 60 * 24;
const DefaultOpts = {
fileRotationFreq: 1,
directory: './logs',
customTypes: [],
customStreams: [],
customTypeMapping: {},
customColors: {},
debug: false,
guard: '_logger'
};
// TODO: // TODO:
// - File rotation
// - Discord webhook, need to write a separate package for that, don't want to add the entirety of d.js as a dep just for a webhook // - Discord webhook, need to write a separate package for that, don't want to add the entirety of d.js as a dep just for a webhook
class MasterLogger { class MasterLogger {
constructor ({ constructor (options = {}) {
directory = './logs',
customTypes = [],
customStreams = [],
customTypeMapping = {},
customColors = {},
debug = false,
guard = '_logger',
fileRotationFreq = 1
} = DefaultOpts) {
this.directory = path.resolve(directory); this.directory = path.resolve(options.directory || './logs');
if (!fs.existsSync(this.directory)) if (!fs.existsSync(this.directory)) fs.mkdirSync(this.directory, { recursive: true });
fs.mkdirSync(this.directory, { recursive: true }); const { customTypes = [], customStreams = [], customTypeMapping = {}, customColors = {}, debug = false } = options;
this._debug = debug; this._debug = debug;
this.types = [ ...customTypes, ...Defaults.Types ]; this.types = [ ...customTypes, ...Defaults.Types ];
for (const type of this.types) { for (const type of this.types) {
Object.defineProperty(this, type, { Object.defineProperty(this, type, {
value: (msg, opts) => this.write(type, msg, opts) // Only write debug outputs if debug mode is enabled
value: (msg, opts) => msg.type === 'debug' && debug || msg.type !== 'debug'
? this.write(type, msg, opts) : null
}); });
} }
this.colours = { ...Defaults.Colours, ...customColors }; this.colours = { ...Defaults.Colours, ...customColors };
this.streamTypes = [ ...customStreams, 'error', 'default' ]; this.streamTypes = [ ...customStreams, 'error', 'default' ];
this.streamTypeMapping = { ...Defaults.TypeStream, ...customTypeMapping }; this.streamTypeMapping = { ...Defaults.TypeStream, ...customTypeMapping };
// eslint-disable-next-line no-return-assign
this.writeStreams = this.streamTypes.reduce((acc, type) => { this.writeStreams = this.streamTypes.reduce((acc, type) => {
acc[type] = this.loadFile(type); acc[type] = this.loadFile(type);
return acc; return acc;
}, {}); }, {});
// Startup day, used to keep track of file rotation
this.rotationFreq = fileRotationFreq * DAY;
this.startDay = Math.floor(Date.now() / this.rotationFreq) * this.rotationFreq;
this.rotateTO = setTimeout(this.rotateLogFiles.bind(this), this.startDay + this.rotationFreq - Date.now());
this.guard = guard;
} }
attach (shard) { attach (shard) {
shard.on('message', (msg) => { shard.on('message', (msg) => {
if (!msg[this.guard]) if (!msg._logger) return;
return;
const { message, type, header, broadcast } = msg; const { message, type, header, broadcast } = msg;
this[type](message, { subheader: header, shard, broadcast }); this[type](message, { subheader: header, shard, broadcast });
}); });
@ -78,17 +52,14 @@ class MasterLogger {
type = type.toLowerCase(); type = type.toLowerCase();
let colour = this.colours[type]; let colour = this.colours[type];
if (!colour) if (!colour) colour = this.colours.info;
colour = this.colours.info;
if (typeof text !== 'string') if (typeof text !== 'string') text = inspect(text);
text = inspect(text);
const header = `[${this.date}] [${this._shard(shard)}]`; const header = `[${this.date}] [${this._shard(shard)}]`;
const maxChars = Math.max(...this.types.map(t => t.length)); const maxChars = Math.max(...this.types.map(t => t.length));
const spacer = ' '.repeat(maxChars - type.length); const spacer = ' '.repeat(maxChars - type.length);
if (type === 'debug' && this._debug || type !== 'debug')
console.log(`${chalk[colour](type)}${spacer} ${chalk[colour](header)}: ${chalk.bold(subheader)}${text}`); // eslint-disable-line no-console console.log(`${chalk[colour](type)}${spacer} ${chalk[colour](header)}: ${chalk.bold(subheader)}${text}`); // eslint-disable-line no-console
if (broadcast) { if (broadcast) {
@ -96,44 +67,27 @@ class MasterLogger {
} }
const streamType = this.streamTypeMapping[type] || 'default'; const streamType = this.streamTypeMapping[type] || 'default';
if (this.writeStreams[streamType]) if (this.writeStreams[streamType]) this.writeStreams[streamType].write(`\n${type}${spacer} ${header}: ${subheader}${text}`);
this.writeStreams[streamType].write(`\n${type}${spacer} ${header}: ${subheader}${text}`); else console.log(`${chalk.red(`[LOGGER] Missing file stream for ${streamType}`)}`); // eslint-disable-line no-console
else
console.log(`${chalk.red(`[LOGGER] Missing file stream for ${streamType}`)}`); // eslint-disable-line no-console
} }
rotateLogFiles () { loadFile (type) {
const streams = Object.keys(this.writeStreams); if (!type) throw new Error('Missing file type');
for (const type of streams) {
this.writeStreams[type].write('\nRotating log file');
this.writeStreams[type].end();
this.writeStreams[type] = this.loadFile(type);
}
const nextTime = Math.floor(Date.now() / this.rotationFreq) * this.rotationFreq + this.rotationFreq;
this.rotateTO = setTimeout(this.rotateLogFiles.bind(this), nextTime - Date.now());
}
loadFile (type, date = Date.now()) { const fileName = `${moment().format('YYYY-MM-DD')}-${type}.log`;
if (!type)
throw new Error('Missing file type');
const fileName = `${moment(date).format('YYYY-MM-DD')}-${type}-${date}.log`;
const filePath = path.join(this.directory, fileName); const filePath = path.join(this.directory, fileName);
if (!fs.existsSync(filePath)) if (!fs.existsSync(filePath)) fs.writeFileSync(filePath, '');
fs.writeFileSync(filePath, '');
return fs.createWriteStream(filePath, { flags: 'a' }); return fs.createWriteStream(filePath, { flags: 'a' });
} }
_shard (shard) { _shard (shard) {
if (!shard) if (!shard) return 'controller';
return 'controller';
let id = '??'; let id = '??';
if ('id' in shard) if ('id' in shard) id = `${shard.id < 10 ? `0${shard.id}` : shard.id}`;
id = `${shard.id < 10 ? `0${shard.id}` : shard.id}`;
return `shard-${id}`; return `shard-${id}`;
} }

View File

@ -8,17 +8,9 @@ const logger = new LoggerClient({
customColors: { access: 'green' } customColors: { access: 'green' }
}); });
const main = async () => { logger.info('Info test');
for (let i = 0; i < 10000; i++) { logger.status('Status test');
if (i % 500 === 0) logger.debug('Debug test');
await new Promise(resolve => setTimeout(resolve, 1000)); logger.warn('Warn test');
logger.info('Info test'); logger.error('Error test');
logger.status('Status test'); logger.access('Access test');
logger.debug('Debug test');
logger.warn('Warn test');
logger.error('Error test');
logger.access('Access test');
}
};
main();

View File

@ -15,8 +15,7 @@ const main = async () => {
customTypes: [ 'access' ], customTypes: [ 'access' ],
customStreams: [ 'access' ], customStreams: [ 'access' ],
customTypeMapping: { access: 'access', warn: 'error' }, customTypeMapping: { access: 'access', warn: 'error' },
customColors: { access: 'green' }, customColors: { access: 'green' }
fileRotationFreq: 0.0001
}); });
const child = ChildProcess.fork('./test/otherProcess.js'); const child = ChildProcess.fork('./test/otherProcess.js');
logger.attach(child); logger.attach(child);
@ -26,9 +25,13 @@ const main = async () => {
const { types, colours, streamTypes, streamTypeMapping } = logger; // , writeStreams const { types, colours, streamTypes, streamTypeMapping } = logger; // , writeStreams
console.log(types, colours, streamTypes, streamTypeMapping); // , writeStreams console.log(types, colours, streamTypes, streamTypeMapping); // , writeStreams
for (let i = 0; i < 10; i++) { logger.info('Info test');
await new Promise((resolve) => setTimeout(resolve, 1000)); logger.status('Status test');
logger.info(`Iteration ${i}`); logger.debug('Debug test');
} logger.warn('Warn test');
logger.error('Error test');
logger.access('Access test');
for (let i = 0; i < 10; i++) await new Promise((resolve) => setTimeout(resolve, 1000));
}; };
main(); main();