load-plugins

Load plugins for gulp, grunt, assemble, verb any node.js app that needs to load plugins from node_modules or local folders.

Install

Install with npm

1$ npm i load-plugins --save

Usage

with gulp

1var plugin = require('load-plugins')('gulp-*');
2
3gulp.task('default', function () {
4  gulp.src('test/*.js')
5    .pipe(plugin.jshint());
6    .pipe(plugin.mocha());
7});

with assemble

1var plugin = require('load-plugins')('assemble-*');
2
3assemble.task('default', function () {
4  assemble.src('templates/*.hbs')
5    .pipe(plugin.paginate());
6    .pipe(plugin.collections());
7    .pipe(assemble.dest('dist/'));
8});

with verb

1var plugin = require('load-plugins')('verb-*');
2
3verb.task('default', function () {
4  verb.src('docs/*.md')
5    .pipe(plugin.toc());
6    .pipe(plugin.reflinks());
7    .pipe(verb.dest('./'));
8});

Options

See resolve-dep for additional options.

options.require

Pass a custom function for requireing files.

1plugins('gulp-*', {
2  require: function(filepath) {
3    // do stuff to filepath
4  }
5});

options.camelize

Make plugin names camelcased. By default this is true.

options.rename

Pass a rename function to change how plugins are named.

1plugins('my-plugins-*', {
2  rename: function (filepath) {
3    return path.basename(filepath);
4  }
5});

options.strip

Omit strings from plugin names. This is a complement to the .rename() option, it's easiest to understand by way of example:

1plugins('gulp-*', {strip: 'gulp'});

Returns {mocha: [Function]} instead of {'gulp-mocha': [Function]}, and so on.

You may also pass an array of strings to strip, or use braces, e.g.:

1// note that the `strip` option doesn't work with full glob patterns, just braces
2plugins('{foo,bar}-*', {strip: ['foo', 'bar']});

Related

• load-templates: Load templates.
• plugins: Run a string through a plugin stack.

Running tests

Install dev dependencies:

1$ npm i -d && npm test

Contributing

Pull requests and stars are always welcome. For bugs and feature requests, please create an issue

Author

Jon Schlinkert

• github/jonschlinkert
• twitter/jonschlinkert

License

Copyright © 2014-2015 Jon Schlinkert Released under the MIT license.

---

This file was generated by verb-cli on July 05, 2015.