plato

This is a fork of the original

FOR ES6 (EcmaScript2015) source file compatibility.

It uses a fork of the escomplex-js module, and passes it custom ES options.

In addition it allows setting the 'ignoreDecorators' option, which when set true removes all ES7+ (non-standard) decorators from your source files before handing them to the parser, to avoid errors due to them. The analysis should be good enough even so.

options.ecmaOptions= {
	ecmaVersion: 6, 			// the version preset to use
	sourceType: 'module',		// module or script
	tolerant: true,				// whether tolerant mode is enabled
	ecmaFeatures: { ... }		// specific list of features to enable/disable
	
	ignoreDecorators: true		// special flag to use to tell plato to remove all decorators before parsing
}

plato.inspect(files, outputFolder, options)

Visualize JavaScript source complexity with plato.

Example report on popular projects

• jquery
• grunt
• marionettejs

Installation

Install the module with: npm install -g plato

Usage

From the commandline

Usage : plato [options] -d <output_dir> <input files>
  -h, --help
      Display this help text.
  -q, --quiet
      Reduce output to errors only
  -v, --version
      Print the version.
  -x, --exclude : String
      File exclusion regex
  -d, --dir : String *required*
      The output directory
  -r, --recurse
      Recursively search directories
  -l, --jshint : String
      Specify a jshintrc file for JSHint linting
  -e, --eslint : String
      Specify a eslintrc file for ESLint linting
  -t, --title : String
      Title of the report
  -D, --date : String
      Time to use as the report date (seconds, > 9999999999 assumed to be ms)
  -n, --noempty
      Skips empty lines from line count

Example

plato -r -d report src

Extended example

plato -r -d report -l .jshintrc -t "My Awesome App" -x .json routes/*.js

From scripts

var plato = require('plato');

var files = [
  'path/to/javascript/file1.js',
  ...
  'path/to/javascript/fileN.js'
];

var outputDir = './output/dir';
// null options for this example
var options = {
  title: 'Your title here'
};

var callback = function (report){
// once done the analysis,
// execute this
};

plato.inspect(files, outputDir, options, callback);

Data sources

• Complexity data by Phil Booth's complexity-report
• Lint data from jshint and eslint

Contributors

• Jarrod Overson
• Craig Davis
• David Linse

Release History

• 1.3.0 Merged 107,130,128,119,114. Numerous bug fixed.
  • Minor bumped for changes to parsing of files passed. Technically a breaking change but effectively a bug fix + feature so bumping minor.
• 1.2.1 Bumping versions for jshint and lodash
• 1.2.0 add ability to disable jshint
• 1.1.0 fix issue with running casperjs tests
• 1.0.1 fix issue with first line hashbang
• 1.0.0 promote to 1.0.0 with bug fixes
• 0.6.2 Added sortable file list, updated to bootstrap 3
• 0.6.1 Fixed width overflow issues in file reports
• 0.6.0 updated major dependency complexity-report
• 0.5.0 Added historical reports
• 0.4.7 Updated jshint to 1.1.0 (via #22) to jshint to address #16
• 0.4.6 Performance improvements on file view
• 0.4.5 Updated complexity-report to 0.7.0 to prefer the 0-100 based maintainability index
• 0.4.4 Added quiet mode, exclusion regex, description popovers
• 0.4.3 Updated dependencies to fix reporting issues
• 0.4.2 Fixed overview links to files
• 0.4.1 Fixed jshint option passing
• 0.4.0 Added summary stats, Casper tests, nodunit tests
  • Breaking : plato api
• 0.3.1 Added graphs
• 0.3.0 Formatting changes, refactoring.
  • Breaking : jshint reporting api
• 0.2.0 added jshint reporting.
  • Breaking : options api, cli api
• 0.1.0 initial release

License

Copyright (c) 2012 Jarrod Overson Licensed under the MIT license.