feat(plugins): Accept object literal as plugin + options

Author: shakyShane

lib/async.js

@@ -69,18 +69,19 @@ module.exports = {
             }
 
             if (Immutable.Map.isMap(item)) {
-                item.forEach(function (value, key) {
-                    loadPlugin(key, value);
-                });
+                loadPlugin(item.get("module"), item.get("options"));
             }
         });
 
         function loadPlugin (name, opts) {
             try {
                 opts = opts ? opts.toJS() : {};
-                opts.moduleName = name;
-                bs.registerPlugin(require(name), opts);
-
+                if (_.isString(name)) {
+                    opts.moduleName = name;
+                    bs.registerPlugin(require(name), opts);
+                } else {
+                    bs.registerPlugin(name.toJS(), opts);
+                }
             } catch (e) {
                 if (e.code === "MODULE_NOT_FOUND") {
                     return bs.logger.setOnce("useLevelPrefixes", true).error("Plugin {yellow:`%s`} was not found, did you forget to {cyan:npm install} it?", name);

package.json

@@ -60,6 +60,7 @@
   },
   "devDependencies": {
     "browser-sync-spa": "^1.0.2",
+    "bs-html-injector": "^2.0.1",
     "bs-snippet-injector": "^2.0.1",
     "chai": "^2.1.0",
     "chalk": "^1.0.0",

test/specs/plugins/user.plugins.inline.enabled.js

@@ -14,12 +14,15 @@ describe("Plugins: Setting the default state (false) if given in options", funct
 
         var config = {
             logLevel: "silent",
-            plugins: [{
-                "bs-snippet-injector": {
-                    enabled: false,
-                    file: ""
+            plugins: [
+                {
+                    module:  "bs-snippet-injector",
+                    options: {
+                        enabled: false,
+                        file:    ""
+                    }
                 }
-            }]
+            ]
         };
 
         instance = browserSync(config, done).instance;
@@ -44,11 +47,14 @@ describe("Plugins: Setting the default state (true) if given in options", functi
 
         var config = {
             logLevel: "silent",
-            plugins: [{
-                "bs-snippet-injector": {
-                    enabled: true
+            plugins: [
+                {
+                    module: "bs-snippet-injector",
+                    options: {
+                        enabled: true
+                    }
                 }
-            }]
+            ]
         };
 
         instance = browserSync(config, done).instance;

test/specs/plugins/user.plugins.inline.obj.js

@@ -0,0 +1,53 @@
+"use strict";
+
+var browserSync = require("../../../");
+
+var assert  = require("chai").assert;
+
+describe("Plugins: Retrieving user plugins when given inline as object", function () {
+
+    var instance;
+    var PLUGIN_NAME    = "Test Plugin";
+
+    before(function (done) {
+
+        browserSync.reset();
+
+        var config = {
+            logLevel: "silent",
+            plugins: [
+                {
+                    module: {
+                        plugin: function () {
+                            done();
+                        },
+                        "plugin:name": PLUGIN_NAME
+                    },
+                    options: {
+                        files: "*.html"
+                    }
+                }
+            ]
+        };
+
+        instance = browserSync(config).instance;
+    });
+    after(function () {
+        instance.cleanup();
+    });
+    it("Should access to only the user-specified plugins", function (done) {
+        console.log(instance.getUserPlugins());
+        assert.equal(instance.getUserPlugins().length, 1);
+        done();
+    });
+    it("Should have access to only the user-specified plugins", function (done) {
+        var plugin = instance.getUserPlugins()[0];
+        assert.equal(plugin.name, PLUGIN_NAME);
+        done();
+    });
+    it("should have access to user provided opts", function (done) {
+        var plugin = instance.getUserPlugins()[0];
+        assert.equal(plugin.opts.files, "*.html");
+        done();
+    });
+});

test/specs/plugins/user.plugins.inline.options.js

@@ -18,7 +18,8 @@ describe("Plugins: Retrieving user plugins when given inline with options", func
             logLevel: "silent",
             plugins: [
                 {
-                    "bs-snippet-injector": {
+                    module: "bs-snippet-injector",
+                    options: {
                         files: "*.html"
                     }
                 }
@@ -34,7 +35,7 @@ describe("Plugins: Retrieving user plugins when given inline with options", func
         assert.equal(instance.getUserPlugins().length, 1);
         done();
     });
-    it("Should access to only the user-specified plugins", function (done) {
+    it("Should have access to only the user-specified plugins", function (done) {
         var plugin = instance.getUserPlugins()[0];
         assert.equal(plugin.name, PLUGIN_NAME);
         done();