ask-cli
Version:
Alexa Skills Kit (ASK) Command Line Interfaces
249 lines (230 loc) • 7.73 kB
JavaScript
const chalk = require('chalk');
const path = require('path');
const fs = require('fs');
// A map used to define message levels
// and set their display styles
const MESSAGE_CATEGORY_MAPPING = {
TRACE: {
level: 10,
display: {}
},
DEBUG: {
level: 20,
display: {
color: 'gray',
bold: false,
prefix: '[Debug]: ',
method: 'warn',
}
},
INFO: {
level: 30,
display: {
color: null,
bold: false,
prefix: '',
method: 'log'
}
},
WARN: {
level: 40,
display: {
color: 'yellow',
bold: true,
prefix: '[Warn]: ',
method: 'warn'
}
},
ERROR: {
level: 50,
display: {
color: 'red',
bold: true,
prefix: '[Error]: ',
method: 'error'
}
},
FATAL: {
level: 60,
display: {
color: 'rgb(128, 0, 0)',
bold: true,
prefix: '[Fatal]: ',
method: 'error'
}
}
};
let instance = null;
class Messenger {
// Make this class as a singleton
constructor({ doDebug }) {
if (!instance) {
instance = this;
}
// TODO: change buffer data type to avoid overflow
// Used to record all CLI std behaviors
this._buffer = [];
// This flag is for debug use in order to
// determine whether commands is working on debug mode
this.doDebug = doDebug || false;
return instance;
}
static getInstance() {
return instance || new Messenger({});
}
// If the commander works under debug mode, write all debug level messages to local file
// when the messanger instance get disposed and set to null
dispose() {
if (this.doDebug) {
this.writeLogToFile();
}
instance = null;
}
// Used to track http request behaviors
// Record information to buffer
trace(data) {
const operation = 'TRACE';
this._buffer.push({
time: Messenger.getTime(),
operation,
level: MESSAGE_CATEGORY_MAPPING[operation].level,
msg: data
});
}
// Used to track CLI internal debug messages
// Record CLI behaviors to buffer and
// expose debug messages immediately when user have --debug option set
debug(data) {
const operation = 'DEBUG';
this._buffer.push({
time: Messenger.getTime(),
operation,
level: MESSAGE_CATEGORY_MAPPING[operation].level,
msg: data
});
if (this.doDebug) {
Messenger.displayMessage(operation, data);
}
}
// Used to display the information during the CLI command execution
info(data) {
const operation = 'INFO';
this._buffer.push({
time: Messenger.getTime(),
operation,
level: MESSAGE_CATEGORY_MAPPING[operation].level,
msg: data
});
Messenger.displayMessage(operation, data);
}
// record warn message to buffer and
// print to console
warn(data) {
const operation = 'WARN';
this._buffer.push({
time: Messenger.getTime(),
operation,
level: MESSAGE_CATEGORY_MAPPING[operation].level,
msg: data
});
Messenger.displayMessage(operation, data);
}
// record error message to buffer and
// print to console
error(data) {
const msg = data.constructor.name === 'Error' ? data.message : data;
const operation = 'ERROR';
this._buffer.push({
time: Messenger.getTime(),
operation,
level: MESSAGE_CATEGORY_MAPPING[operation].level,
msg,
});
Messenger.displayMessage(operation, msg);
}
// record fatal message to buffer and
// print to console
fatal(data) {
const msg = data.constructor.name === 'Error' ? data.stack.substring(7) : data;
const operation = 'FATAL';
this._buffer.push({
time: Messenger.getTime(),
operation,
level: MESSAGE_CATEGORY_MAPPING[operation].level,
msg,
});
Messenger.displayMessage(operation, msg);
}
/**
* A view wrapper, print std in different styles according to different message category
* @param {string} operation The message category
* @param {string} data The text content to be displayed
*/
static displayMessage(operation, data) {
const { color, method, bold, prefix } = MESSAGE_CATEGORY_MAPPING[operation].display;
const msg = prefix + data;
Messenger.displayWithStyle(color, method, bold, msg);
}
/**
* The print function to display message in different styles
* @param {string} color set the color of the text
* @param {string} method set the console method, could be log, warn and error
* @param {boolean} bold a boolean value decide whether the font should be bold
* @param {string} msg The text content to be displayed
*/
static displayWithStyle(color, method, bold, msg) {
if (color) {
if (bold) {
console[method](chalk`{bold.${color} ${msg}}`);
} else {
console[method](chalk`{${color} ${msg}}`);
}
} else {
if (bold) {
console[method](chalk`{bold ${msg}}`);
} else {
console[method](msg);
}
}
}
// Read Trace level info from buffer,
// modify the structure to make it easy to read,
// write restructured info to a log file
writeLogToFile() {
const time = Messenger.getTime();
const filePath = path.join(process.cwd(), `ask-cli-${time}.log`);
const content = [];
for (const item of this._buffer) {
if (item.operation === 'TRACE') {
content.push(`\n[${item.time}] - ${item.operation} - ${item.msg.activity.toUpperCase()}`);
if (item.msg['request-id']) {
content.push(`\nrequest-id: ${item.msg['request-id']}`);
}
content.push(`\n${item.msg.request.method} ${item.msg.request.url}`);
content.push(`\nstatus code: ${item.msg.response.statusCode} ${item.msg.response.statusMessage}`);
if (item.msg.error) {
content.push(`\nerror: ${item.msg.error}\n`);
}
content.push(`\nRequest headers: ${JSON.stringify(item.msg.request.headers)}`);
if (item.msg.request.body) {
content.push(`\nRequest body: ${item.msg.request.body}`);
}
content.push(`\nResponse headers: ${JSON.stringify(item.msg.response.headers)}`);
if (item.msg.body) {
content.push(`\nResponse body: ${JSON.stringify(item.msg.body)}`);
}
content.push('\n----------------------------------------');
}
}
if (content.length >= 1) {
fs.writeFileSync(filePath, content);
console.log(`\nDetail log has been recorded at ${filePath}`);
}
}
// Used to get system time and format the time into the pattern of "week-month-day-year-hour:minute:second-time zone".
// eg: Mon-Apr-01-2019-11:31:21-GMT-0700-(PDT)
static getTime() {
return new Date().toString().replace(/ /g, '-');
}
}
module.exports = Messenger;