esdoc-plugin-escomplex/dist/plugin.js

A plugin for ESDoc that produces complexity analysis reports via typhonjs-escomplex.

'use strict';

Object.defineProperty(exports, "__esModule", {
  value: true
});

var _typeof = typeof Symbol === "function" && typeof Symbol.iterator === "symbol" ? function (obj) { return typeof obj; } : function (obj) { return obj && typeof Symbol === "function" && obj.constructor === Symbol ? "symbol" : typeof obj; }; /**
                                                                                                                                                                                                                                                   * esdoc-plugin-escomplex -- In development / creates complexity analysis reports with ESComplex.
                                                                                                                                                                                                                                                   */

// import cheerio    from 'cheerio';
// import fs         from 'fs-extra';

// import { taffy }  from 'taffydb';

exports.onStart = onStart;
exports.onHandleAST = onHandleAST;
exports.onComplete = onComplete;

var _path = require('path');

var _path2 = _interopRequireDefault(_path);

var _typhonjsEscomplexModule = require('typhonjs-escomplex-module');

var _typhonjsEscomplexModule2 = _interopRequireDefault(_typhonjsEscomplexModule);

function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }

// Must store ESDoc configuration file and options to use later with ReportDocBuilder.
// let config;
var options = void 0;
// let tags;

// ESDoc plugin callbacks -------------------------------------------------------------------------------------------

/**
 * Sanitizes optional parameters.
 *
 * @param {object}   ev - Event from ESDoc containing data field.
 */
function onStart(ev) {
  // Stores sanitized option map.
  options = _typeof(ev.data.option) === 'object' ? ev.data.option : {};

  // Stores option that if true silences logging output.
  options.silent = typeof options.silent === 'boolean' ? options.silent : true;
  options.verbose = typeof options.verbose === 'boolean' ? options.verbose : false;
}

/**
 * Stores the ESDoc configuration file for later use with ReportDocBuilder.
 *
 * @param {object}   ev - Event from ESDoc containing data field.
 */
// export function onHandleConfig(ev)
// {
//   config = ev.data.config;
// }

/**
 * Must save tags to eventually feed ReportDocBuilder with taffydb converted data.
 *
 * @param {object}   ev - Event from ESDoc containing data field
 */
// export function onHandleTag(ev)
// {
//   tags = ev.data.tag;
// }

/**
 * Processes the AST through ESComplex writing these files via given relative path under `<docs destination>/escomplex`.
 *
 * @param {object}   ev - Event from ESDoc containing data field.
 */
function onHandleAST(ev) {
  try {
    var filePath = '';

    if (ev.data.filePath) {
      filePath = _path2.default.relative(process.cwd(), ev.data.filePath);
    }

    var result = _typhonjsEscomplexModule2.default.analyze(ev.data.ast);

    console.log('esdoc-plugin-escomplex - onHandleAST - filePath: ' + filePath + ' - result: ' + JSON.stringify(result));
  } catch (err) {
    console.log('esdoc-plugin-escomplex - onHandleAST - err: ' + err);
  }
}

/**
 * Process all HTML files adding a `Complexity` link to the top header navigation bar.
 *
 * @param {object}   ev - Event from ESDoc containing data field
 */
// export function onHandleHTML(ev)
// {
//    if (ev.data.fileName.endsWith('.html'))
//    {
//       const $ = cheerio.load(ev.data.html, { decodeEntities: false });
//
//       $('<a href="complexity/report/index.html">Complexity</a>').insertAfter('header a[href="identifiers.html"]');
//
//       ev.data.html = $.html();
//    }
// }

/**
 * Completes report generation and then builds the HTML index pages.
 */
function onComplete() {}

/**
 * Provides a callback for ReportDocBuilder to export HTML files delegating to the local `onHandleHTML` function.
 *
 * @param {string}   html - HTML to save.
 * @param {string}   fileName - name for file output.
 */
// const s_WRITE_HTML = (html, fileName) =>
// {
//    // Must match plugin event data format.
//    const ev = { data: { html, fileName } };
//
//    onHandleHTML(ev);
//
//    const filePath = path.resolve(config.destination, fileName);
//    fs.outputFileSync(filePath, ev.data.html, { encoding: 'utf8' });
// };