HackMyResume/src/core/error-handler.js

/**
Error-handling routines for HackMyResume.
@module error-handler.js
@license MIT. See LICENSE.md for details.
*/



(function() {



  var HACKMYSTATUS = require('./status-codes')
    , PKG = require('../../package.json')
    , FS = require('fs')
    , FCMD = require('../hackmyapi')
    , PATH = require('path')
    , chalk = require('chalk');



  /**
  An amorphous blob of error handling code for HackMyResume.
  @class ErrorHandler
  */
  var ErrorHandler = module.exports = {



    err: function( ex, shouldExit ) {

      var msg = '', exitCode, log = console.log, showStack = false;

      // If the exception has been handled elsewhere and shouldExit is true,
      // let's get out of here, otherwise silently return.
      if( ex.handled ) {
        if( shouldExit )
          process.exit( exitCode );
        return;
      }

      // Get an error message -- either a HackMyResume error message or the
      // exception's associated error message
      if( ex.fluenterror ){
        var errInfo = get_error_msg( ex );
        msg = errInfo.msg;
        exitCode = ex.fluenterror;
        showStack = errInfo.showStack;
      }
      else {
        msg = ex.toString();
        exitCode = -1;
        // Deal with pesky 'Error:' prefix.
        var idx = msg.indexOf('Error: ');
        msg = idx === -1 ? msg : msg.substring( idx + 7 );
      }

      // Log non-HackMyResume-handled errors in red with ERROR prefix. Log HMR
      // errors as-is.
      ex.fluenterror ?
        log( msg.toString() ) :
        log( chalk.red.bold('ERROR: ' + msg.toString()) );

      // Usually emit the stack
      ( showStack && ex.code !== 'ENOENT' ) && log( chalk.gray(ex.stack) );

      // Let the error code be the process's return code.
      ( shouldExit || ex.shouldExit ) && process.exit( exitCode );
    }

  };



  function get_error_msg( ex ) {
    var msg = '', withStack = false;
    switch( ex.fluenterror ) {

      case HACKMYSTATUS.themeNotFound:
        msg = "The specified theme couldn't be found: " + ex.data;
        break;

      case HACKMYSTATUS.copyCSS:
        msg = "Couldn't copy CSS file to destination folder";
        break;

      case HACKMYSTATUS.resumeNotFound:
        msg = chalk.yellow('Please ') + chalk.yellow.bold('feed me a resume') +
          chalk.yellow(' in FRESH or JSON Resume format.');
        break;

      case HACKMYSTATUS.missingCommand:
        msg = chalk.yellow("Please ") + chalk.yellow.bold("give me a command") +
          chalk.yellow(" (");

        msg += Object.keys( FCMD.verbs ).map( function(v, idx, ar) {
          return (idx === ar.length - 1 ? chalk.yellow('or ') : '') +
            chalk.yellow.bold(v.toUpperCase());
        }).join( chalk.yellow(', ')) + chalk.yellow(").\n\n");

        msg += chalk.gray(FS.readFileSync( PATH.resolve(__dirname, '../use.txt'), 'utf8' ));
        break;

      case HACKMYSTATUS.invalidCommand:
        msg = chalk.yellow('Invalid command: "') + chalk.yellow.bold(ex.attempted) + chalk.yellow('"');
        break;

      case HACKMYSTATUS.resumeNotFoundAlt:
        msg = chalk.yellow('Please ') + chalk.yellow.bold('feed me a resume') +
          chalk.yellow(' in either FRESH or JSON Resume format.');
        break;

      case HACKMYSTATUS.inputOutputParity:
        msg = chalk.yellow('Please ') + chalk.yellow.bold('specify an output file name') +
          chalk.yellow(' for every input file you wish to convert.');
        break;

      case HACKMYSTATUS.createNameMissing:
        msg = chalk.yellow('Please ') + chalk.yellow.bold('specify the filename of the resume') +
          chalk.yellow(' to create.');
        break;

      case HACKMYSTATUS.wkhtmltopdf:
        msg = chalk.red.bold('ERROR: PDF generation failed. ') + chalk.red('Make sure wkhtmltopdf is ' +
        'installed and accessible from your path.');
        if( ex.inner ) msg += chalk.red('\n' + ex.inner);
        withStack = true;
        break;

      case HACKMYSTATUS.invalid:
        msg = chalk.red.bold('ERROR: Validation failed and the --assert option was specified.');
        break;

      case HACKMYSTATUS.invalidTarget:
        ex.data.forEach(function(d){
          msg += chalk.red.bold('The ' + ex.theme.name + " theme doesn't support the " + d.format + " format.\n");
        });
        break;

    }
    return {
      msg: msg,
      withStack: withStack
    };
  }



}());