nengine/lib/help.js

The nengine http/https server

/**
 * nengine
 * https://nuintun.github.io/nengine
 *
 * Licensed under the MIT license
 * https://github.com/Nuintun/nengine/blob/master/LICENSE
 */

'use strict';

// external lib
var path = require('path');
var nengine = require('../index');
var colors = require('colors/safe');

// variable declaration
var colwidth = 0; // set column widths
var title = process.title;

// methods to run, in-order
exports.queue = [
  'initCommand',
  'initOptions',
  'header',
  'usage',
  'command',
  'options',
  'footer'
];

exports.firstColWidth = function(str) {
  colwidth = Math.max(colwidth, str.length);
};

// format string to custom length
function pad(str, len, holder) {
  holder = typeof holder === 'string' ? holder : ' ';

  var blink = new Array(len).join(holder);

  return str + blink.slice(str.length);
}

// render an array in table form
exports.table = function(arr) {
  arr.forEach(function(item) {
    console.log(
      colors.yellow.bold(pad(item[0], colwidth + 5)),
      colors.white.bold(item[1])
    );
  });
};

// display help info
exports.help = function() {
  exports.queue.forEach(function(name) {
    exports[name]();
  });
};

// header
exports.header = function() {
  console.log(
    colors.cyan.bold(title + ': ')
    + colors.bold(nengine.description + ' (')
    + colors.green.bold('v' + nengine.version)
    + colors.bold(')')
  );
};

// usage info
exports.usage = function() {
  exports.blankLine();

  console.log(
    colors.magenta.bold('Usage: ')
    + colors.green.bold(title)
    + colors.yellow.bold(' [options] [command]')
  );
};

exports.initCommand = function() {
  var cmdlist = nengine.cli.cmdlist;

  // build 2-column array for table view
  exports._command = Object.keys(cmdlist).map(function(cmd) {
    var cmdinfo = cmdlist[cmd];

    cmd = '  ' + cmd;
    exports.firstColWidth(cmd);

    return [cmd, cmdinfo.info];
  });
};

exports.command = function() {
  exports.blankLine();
  console.log(colors.magenta.bold('Command:'));
  exports.table(exports._command);
};

// options
exports.initOptions = function() {
  var optlist = nengine.cli.optlist;

  // Build 2-column array for table view
  exports._options = Object.keys(optlist).map(function(option) {
    var optinfo = optlist[option],
      negate = optinfo.negate ? 'no-' : '',
      short = optinfo.short ? ', -' + optinfo.short : '',
      tags = '  --' + negate + option + short;

    exports.firstColWidth(tags);

    return [tags, optinfo.info];
  });
};

// blank line
exports.blankLine = function() {
  console.log('');
};

exports.options = function() {
  exports.blankLine();
  console.log(colors.magenta.bold('Options:'));
  exports.table(exports._options);
};

// footer
exports.footer = function() {
  exports.blankLine();

  console.log(
    colors.white.bold('For more information, see: ')
    + colors.magenta.bold('https://nuintun.github.io/nengine')
  );
};

// display nengine-cli version
exports.version = function(verbose) {
  console.log(
    colors.cyan.bold('nengine ')
    + colors.green.bold('v' + nengine.version)
    + (verbose ? ' installed in: ' + colors.magenta.bold(path.dirname(__dirname)) : '')
  );

  process.exit();
};