Support for loading plugins

Author: nknapp

.thought/config.js

@@ -0,0 +1,5 @@
+module.exports = {
+  plugins: [
+    require('thought-plugin-jsdoc')
+  ]
+}

.thought/partials/usage.md.hbs

@@ -116,6 +116,33 @@ Thought implicitly uses the [promised-handlebars](https://github.com/nknapp/prom
 to allow helpers that return promises. So, in your helpers, you will never receive a promise as parameter or 
 as context data, but if you return promises, they will be resolved seamlessly. 
 
+## Plugin modules
+
+The customizations described above can be extracted into reusable modules. A thought-plugin is just a 
+{{npm 'customize'}}-module that is loaded using the [customize.load()](https://github.com/bootprint/customize#module_customize..Customize+load) 
+function.
+
+### Authoring modules
+
+Have a look at {{npm 'customize-engine-handlebars'}} for an example on how to write a module. For 
+a real example have a look at {{npm 'thought-plugin-jsdoc'}}.
+
+### Using modules
+
+* Include you favorite plugins in the `devDependencies` of your `package.json`
+* Place a file `config.js` into the `.thought`-folder in your project: 
+
+{{include '.thought/snippets/config.js'}}
+
+This file loads multiple plugins that are applied to the `customize`-instance one after another.
+
+You can also load plugins from other-plugins. The following example uses plugins that do not yet exist, but the 
+application is thinkable:
+
+{{include '.thought/snippets/plugin-loading-plugins.js'}}
+
+This allows you to create building-blocks that can then be assembled to a single plugin which can be included in your
+projects...
 
 
 

.thought/snippets/config.js

@@ -0,0 +1,10 @@
+module.exports = {
+  plugins: [
+    // JsDoc-Support
+    require('thought-plugin-jsdoc'),
+    // Some other feature plugin
+    require('thought-plugin-something-else'),
+    // Plugin containing my (nknapp's) personal preferences
+    require('thought-plugin-nknapp-preferences')
+  ]
+}

.thought/snippets/plugin-loading-plugins.js

@@ -0,0 +1,10 @@
+module.exports = function (customize) {
+
+  return customize
+    // jsdoc-support
+    .load(require('thought-plugin-jsdoc'))
+    // include open-open-source disclaimer in CONTRIBUTING.md
+    .load(require('thought-plugin-open-open-source'))
+    // include standardjs-disclaimer in CONTRIBUTING.md
+    .load(require('thought-plugin-standardjs'))
+}

README.md

@@ -222,6 +222,59 @@ Thought implicitly uses the [promised-handlebars](https://github.com/nknapp/prom
 to allow helpers that return promises. So, in your helpers, you will never receive a promise as parameter or 
 as context data, but if you return promises, they will be resolved seamlessly. 
 
+## Plugin modules
+
+The customizations described above can be extracted into reusable modules. A thought-plugin is just a 
+[customize](https://npmjs.com/package/customize)-module that is loaded using the [customize.load()](https://github.com/bootprint/customize#module_customize..Customize+load) 
+function.
+
+### Authoring modules
+
+Have a look at [customize-engine-handlebars](https://npmjs.com/package/customize-engine-handlebars) for an example on how to write a module. For 
+a real example have a look at [thought-plugin-jsdoc](https://npmjs.com/package/thought-plugin-jsdoc).
+
+### Using modules
+
+* Include you favorite plugins in the `devDependencies` of your `package.json`
+* Place a file `config.js` into the `.thought`-folder in your project: 
+
+```js
+module.exports = {
+  plugins: [
+    // JsDoc-Support
+    require('thought-plugin-jsdoc'),
+    // Some other feature plugin
+    require('thought-plugin-something-else'),
+    // Plugin containing my (nknapp's) personal preferences
+    require('thought-plugin-nknapp-preferences')
+  ]
+}
+
+```
+
+
+This file loads multiple plugins that are applied to the `customize`-instance one after another.
+
+You can also load plugins from other-plugins. The following example uses plugins that do not yet exist, but the 
+application is thinkable:
+
+```js
+module.exports = function (customize) {
+
+  return customize
+    // jsdoc-support
+    .load(require('thought-plugin-jsdoc'))
+    // include open-open-source disclaimer in CONTRIBUTING.md
+    .load(require('thought-plugin-open-open-source'))
+    // include standardjs-disclaimer in CONTRIBUTING.md
+    .load(require('thought-plugin-standardjs'))
+}
+
+```
+
+
+This allows you to create building-blocks that can then be assembled to a single plugin which can be included in your
+projects...
 
 
 

customize.js

@@ -7,7 +7,13 @@
 
 'use strict'
 
-var path = require('path')
+const path = require('path')
+const fs = require('fs')
+
+// Default config if the file `.thought/config.js` does not exist
+const defaultConfig = {
+  plugins: []
+}
 
 /**
  *
@@ -18,6 +24,8 @@ var path = require('path')
  */
 module.exports = function createSpec (workingDir) {
   return function thoughtSpec (customize) {
+    const configFile = path.resolve('.thought', 'config.js')
+    var config = fs.existsSync(configFile) ? require(configFile) : defaultConfig
     return customize
       .registerEngine('handlebars', require('customize-engine-handlebars'))
       .merge({
@@ -35,6 +43,13 @@ module.exports = function createSpec (workingDir) {
           }
         }
       })
+      // Apply any customization from the config-files (such as loading modules)
+      .load(function (customize) {
+        const result = config.plugins.reduce((prev, plugin) => {
+          return prev.load(plugin)
+        }, customize)
+        return result
+      })
       .merge({
         handlebars: {
           partials: path.join(workingDir, '.thought', 'partials'),

test/fixtures/plugin-module/index.js

@@ -0,0 +1,15 @@
+const path = require('path')
+
+module.exports = function plugin (customize) {
+  return customize.merge({
+    handlebars: {
+      partials: path.resolve(__dirname, 'partials'),
+      templates: path.resolve(__dirname, 'templates'),
+      helpers: {
+        npm: function (name) {
+          return `[${name.toUpperCase()}](https://npmjs.com/package/${name})`
+        }
+      }
+    }
+  })
+}

test/fixtures/plugin-module/partials/license.md

@@ -0,0 +1 @@
+Overridden partial license.md

test/fixtures/plugin-module/templates/CONTRIBUTING.md.hbs

@@ -0,0 +1 @@
+This file is overridden in the plugin-module

test/fixtures/plugin-module/templates/README.md.hbs

@@ -0,0 +1 @@
+This file is overridden in the plugin-module