Merge branch 'features/plugins' into dev

Conflicts:
	core/lib/patternlab.js
	core/scripts/postinstall.js

Author: bmuenzenmeyer

.eslintrc

@@ -67,7 +67,7 @@
     "no-with": 2,
     "quotes": [0, "single"],
     "radix": 2,
-    "semi": [0, "never"],
+    "semi": [1, "always"],
     "strict": 0,
     "space-before-blocks": 1,
     "space-before-function-paren": [1, {

core/lib/annotation_exporter.js

@@ -59,11 +59,11 @@ var annotations_exporter = function (pl) {
     //take the annotation snippets and split them on our custom delimiter
       var annotationsYAML = annotationsMD.split('~*~');
       for (var i = 0; i < annotationsYAML.length; i++) {
-        var annotation = buildAnnotationMD(annotationsYAML[i], markdown_parser)
+        var annotation = buildAnnotationMD(annotationsYAML[i], markdown_parser);
         annotations.push(annotation);
       }
       return false;
-    }
+    };
   }
 
   /*
@@ -72,7 +72,7 @@ var annotations_exporter = function (pl) {
   function parseAnnotationsMD() {
     var markdown_parser = new mp();
     var annotations = [];
-    var mdFiles = glob.sync(paths.source.annotations + '/*.md')
+    var mdFiles = glob.sync(paths.source.annotations + '/*.md');
 
     mdFiles.forEach(parseMDFile(annotations, markdown_parser));
     return annotations;

core/lib/object_factory.js

@@ -87,14 +87,19 @@ Pattern.prototype = {
   // calculated path from the root of the public directory to the generated html
   // file for this pattern.
   // Should look something like '00-atoms-00-global-00-colors/00-atoms-00-global-00-colors.html'
-  getPatternLink: function (patternlab, suffixType) {
+  getPatternLink: function (patternlab, suffixType, customfileExtension) {
     // if no suffixType is provided, we default to rendered
     var suffixConfig = patternlab.config.outputFileSuffixes;
     var suffix = suffixType ? suffixConfig[suffixType] : suffixConfig.rendered;
 
     if (suffixType === 'rawTemplate') {
       return this.name + path.sep + this.name + suffix + this.fileExtension;
     }
+
+    if (suffixType === 'custom') {
+      return this.name + path.sep + this.name + customfileExtension;
+    }
+
     return this.name + path.sep + this.name + suffix + '.html';
   },
 

core/lib/pattern_assembler.js

@@ -551,7 +551,7 @@ var pattern_assembler = function () {
       parseDataLinks(patternlab);
     },
     parse_data_links_specific: function (patternlab, data, label) {
-      return parseDataLinksHelper(patternlab, data, label)
+      return parseDataLinksHelper(patternlab, data, label);
     },
     parse_pattern_markdown: function (pattern, patternlab) {
       parsePatternMarkdown(pattern, patternlab);

core/lib/patternlab.js

@@ -14,8 +14,12 @@ var diveSync = require('diveSync'),
   glob = require('glob'),
   _ = require('lodash'),
   path = require('path'),
-  plutils = require('./utilities'),
-  cleanHtml = require('js-beautify').html;
+  cleanHtml = require('js-beautify').html,
+  inherits = require('util').inherits,
+  pm = require('./plugin_manager'),
+  plutils = require('./utilities');
+
+var EventEmitter = require('events').EventEmitter;
 
 function buildPatternData(dataFilesPath, fs) {
   var dataFiles = glob.sync(dataFilesPath + '*.json', {"ignore" : [dataFilesPath + 'listitems.json']});
@@ -74,6 +78,28 @@ function checkConfiguration(patternlab) {
   patternlab.config.outputFileSuffixes = _.extend(outputFileSuffixes, patternlab.config.outputFileSuffixes);
 }
 
+/**
+ * Finds and calls the main method of any found plugins.
+ * @param patternlab - global data store
+ */
+function initializePlugins(patternlab) {
+  var plugin_manager = new pm(patternlab.config, path.resolve(__dirname, '../../patternlab-config.json'));
+  var foundPlugins = plugin_manager.detect_plugins();
+
+  if (foundPlugins && foundPlugins.length > 0) {
+
+    for (var i = 0; i < foundPlugins.length; i++) {
+      var plugin = plugin_manager.load_plugin(foundPlugins[i]);
+      plugin(patternlab);
+    }
+  }
+}
+
+function PatternLabEventEmitter() {
+  EventEmitter.call(this);
+}
+inherits(PatternLabEventEmitter, EventEmitter);
+
 var patternlab_engine = function (config) {
   'use strict';
 
@@ -93,9 +119,13 @@ var patternlab_engine = function (config) {
 
   patternlab.package = fs.readJSONSync(path.resolve(__dirname, '../../package.json'));
   patternlab.config = config || fs.readJSONSync(path.resolve(__dirname, '../../patternlab-config.json'));
+  patternlab.events = new PatternLabEventEmitter();
 
   checkConfiguration(patternlab);
 
+  //todo: determine if this is the best place to wire up plugins
+  initializePlugins(patternlab);
+
   var paths = patternlab.config.paths;
 
   function getVersion() {
@@ -237,6 +267,9 @@ var patternlab_engine = function (config) {
   }
 
   function buildPatterns(deletePatternDir) {
+
+    patternlab.events.emit('patternlab-build-pattern-start', patternlab);
+
     try {
       patternlab.data = buildPatternData(paths.source.data, fs);
     } catch (ex) {
@@ -269,9 +302,13 @@ var patternlab_engine = function (config) {
 
     pattern_assembler.combine_listItems(patternlab);
 
+    patternlab.events.emit('patternlab-build-global-data-end', patternlab);
+
     // diveSync once to perform iterative populating of patternlab object
     processAllPatternsIterative(pattern_assembler, paths.source.patterns, patternlab);
 
+    patternlab.events.emit('patternlab-pattern-iteration-end', patternlab);
+
     //diveSync again to recursively include partials, filling out the
     //extendedTemplate property of the patternlab.patterns elements
     processAllPatternsRecursive(pattern_assembler, paths.source.patterns, patternlab);
@@ -385,6 +422,9 @@ var patternlab_engine = function (config) {
 
       var footerHTML = pattern_assembler.renderPattern(patternlab.userFoot, allFooterData);
 
+      patternlab.events.emit('patternlab-pattern-write-begin', patternlab, pattern);
+
+      //write the compiled template to the public patterns directory
       var patternPage = headHTML + pattern.patternPartialCode + footerHTML;
 
       //beautify the output if configured to do so
@@ -401,6 +441,8 @@ var patternlab_engine = function (config) {
       //write the encoded version too
       fs.outputFileSync(paths.public.patterns + pattern.getPatternLink(patternlab, 'markupOnly'), cleanedPatternPartialCode);
 
+      patternlab.events.emit('patternlab-pattern-write-end', patternlab, pattern);
+
       return true;
     });
 

core/lib/plugin_manager.js

@@ -0,0 +1,79 @@
+"use strict";
+
+var plugin_manager = function (config, configPath) {
+  var path = require('path'),
+    fs = require('fs-extra'),
+    util = require('./utilities');
+
+  function loadPlugin(pluginName) {
+    return require(path.join(process.cwd(), 'node_modules', pluginName));
+  }
+
+  function installPlugin(pluginName) {
+    try {
+      var pluginPath = path.resolve(
+        path.join(process.cwd(), 'node_modules', pluginName)
+      );
+      console.log('Attempting to load plugin from', pluginPath);
+      try {
+        var pluginDirStats = fs.statSync(pluginPath);
+      } catch (ex) {
+        util.logRed(pluginName + ' not found, please use npm to install it first.');
+        util.logRed(pluginName + ' not loaded.');
+        return;
+      }
+      var pluginPathDirExists = pluginDirStats.isDirectory();
+      if (pluginPathDirExists) {
+
+        //write config entry back
+        var diskConfig = fs.readJSONSync(path.resolve(configPath), 'utf8');
+        diskConfig[pluginName] = false;
+        fs.outputFileSync(path.resolve(configPath), JSON.stringify(diskConfig, null, 2));
+
+        util.logGreen('Plugin ' + pluginName + ' installed.');
+
+        //todo, tell them how to uninstall or disable
+
+      }
+    } catch (ex) {
+      console.log(ex);
+    }
+  }
+
+  function detectPlugins() {
+    var node_modules_path = path.join(process.cwd(), 'node_modules');
+    return fs.readdirSync(node_modules_path).filter(function (dir) {
+      var module_path = path.join(process.cwd(), 'node_modules', dir);
+      return fs.statSync(module_path).isDirectory() && dir.indexOf('plugin-node-') === 0;
+    });
+  }
+
+  function disablePlugin(pluginName) {
+    console.log('disablePlugin not implemented yet. No change made to state of plugin', pluginName);
+  }
+
+  function enablePlugin(pluginName) {
+    console.log('enablePlugin not implemented yet. No change made to state of plugin', pluginName);
+  }
+
+  return {
+    install_plugin: function (pluginName) {
+      installPlugin(pluginName);
+    },
+    load_plugin: function (pluginName) {
+      return loadPlugin(pluginName);
+    },
+    detect_plugins: function () {
+      return detectPlugins();
+    },
+    disable_plugin: function (pluginName) {
+      disablePlugin(pluginName);
+    },
+    enable_plugin: function (pluginName) {
+      enablePlugin(pluginName);
+    }
+  };
+
+};
+
+module.exports = plugin_manager;

core/lib/starterkit_manager.js

@@ -58,14 +58,14 @@ var starterkit_manager = function (config) {
       if (contentType && contentType.indexOf('application/json') === -1) {
         throw new TypeError("StarterkitManager->listStarterkits: Not valid JSON");
       }
-      return res.json()
+      return res.json();
     }).then(function (json) {
       if (!json.items || !Array.isArray(json.items)) {
         return false;
       }
       return json.items
         .map(function (repo) {
-          return {name: repo.name, url: repo.html_url}
+          return {name: repo.name, url: repo.html_url};
         });
     }).catch(function (err) {
       console.error(err);

core/lib/ui_builder.js

@@ -246,7 +246,7 @@ var ui_builder = function () {
       patternState: pattern.patternState,
       patternSrcPath: encodeURI(pattern.subdir + '/' + pattern.fileName),
       patternPath: patternPath
-    }
+    };
   }
 
   /**
@@ -553,8 +553,8 @@ var ui_builder = function () {
     //viewAllPaths
     output += 'var viewAllPaths = ' + JSON.stringify(patternlab.viewAllPaths) + ';' + eol;
 
-    //plugins someday
-    output += 'var plugins = [];' + eol;
+    //plugins
+    output += 'var plugins = ' + JSON.stringify(patternlab.plugins) + ';' + eol;
 
     //smaller config elements
     output += 'var defaultShowPatternInfo = ' + (patternlab.config.defaultShowPatternInfo ? patternlab.config.defaultShowPatternInfo : 'false') + ';' + eol;
@@ -645,7 +645,7 @@ var ui_builder = function () {
 
   return {
     buildFrontend: function (patternlab) {
-      buildFrontend(patternlab)
+      buildFrontend(patternlab);
     },
     isPatternExcluded: function (pattern, patternlab) {
       return isPatternExcluded(pattern, patternlab);

core/scripts/postinstall.js

@@ -5,8 +5,10 @@ try {
   var path = require('path');
   var fs = require('fs-extra');
   var smPath = path.resolve(__dirname, '..', 'lib/starterkit_manager.js');
+  var pmPath = path.resolve(__dirname, '..', 'lib/plugin_manager.js');
   var uPath = path.resolve(__dirname, '..', 'lib/utilities.js');
   var sm = require(smPath);
+  var pm = require(pmPath);
   var u = require(uPath);
 
   //get the config
@@ -21,8 +23,21 @@ try {
   if (foundStarterkits && foundStarterkits.length > 0) {
     starterkit_manager.load_starterkit(foundStarterkits[0], true);
   } else {
-    console.log('No starterkits found to automatically load.')
+    console.log('No starterkits found to automatically load.');
   }
+
+  //determine if any plugins are already installed
+  var plugin_manager = new pm(config, configPath);
+  var foundPlugins = plugin_manager.detect_plugins();
+
+  if (foundPlugins && foundPlugins.length > 0) {
+
+    for (var i = 0; i < foundPlugins.length; i++) {
+      console.log('Found plugin', foundPlugins[i]);
+      plugin_manager.install_plugin(foundPlugins[i]);
+    }
+  }
+
   u.logGreen('Pattern Lab postinstall complete.');
 
 } catch (ex) {