plugins

Run a value through a plugin stack.

Install

Install with npm

1$ npm i plugins --save

See the examples.

Table of contents

• Docs
• Creating plugins
  • sync
  • async
  • Directly run plugins
• API
• Related projects
• Running tests
• Contributing
• Author
• License

(Table of contents generated by verb)

Docs

See the examples.

Creating plugins

A plugin can take any arguments and must return a function.

sync

Plugins just return a value.

Example:

1var plugins = new Plugins();
2
3plugins
4  .use(function (str) {
5    return str + 'a';
6  })
7  .use(function (str) {
8    return str + 'b';
9  })
10  .use(function (str) {
11    return str + 'c';
12  });
13
14console.log(plugins.run('alphabet-'));
15//=> 'alphabet-abc'

async

Pass next as the last argument to run plugins asynchronously.

Example:

1var plugins = new Plugins();
2
3plugins
4  .use(function (str, next) {
5    next(null, str + 'a');
6  })
7  .use(function (str, next) {
8    next(null, str + 'b');
9  })
10  .use(function (str, next) {
11    next(null, str + 'c');
12  });
13
14plugins.run('alphabet-', function (err, str) {
15  console.log(str); //=> 'alphabet-abc'
16});

Directly run plugins

To run plugins without .use(), pass an array of functions as a section argument to .run().

sync example:

1var plugins = new Plugins();
2
3var a = function(val) {
4  return val + 'a';
5};
6var b = function(val) {
7  return val + 'b';
8};
9var c = function(val) {
10  return val + 'c';
11};
12
13console.log(plugins.run('alphabet-', [a, b, c]));
14//=> 'alphabet-abc'

async example:

1var plugins = new Plugins();
2
3var a = function (str, next) {
4  next(null, str + 'a');
5};
6var b = function (str, next) {
7  next(null, str + 'b');
8};
9var c = function (str, next) {
10  next(null, str + 'c');
11};
12
13plugins.run('alphabet-', [a, b, c], function (err, str) {
14  console.log(str); //=> 'alphabet-abc'
15});

API

See the examples.

Plugins

Initialize Plugins

Example

1var Plugins = require('plugins');
2var plugins = new Plugins();

.use

Add a plugin fn to the plugins stack.

Params

• fn {Function}: Plugin function to add to the plugins stack.
• returns {Object} Plugins: to enable chaining.

Example

1plugins
2  .use(foo)
3  .use(bar)
4  .use(baz)

.run

Call each fn in the plugins stack to iterate over val.

Params

• val {Array|Object|String}: The value to iterate over.

Example

1plugins.run(value)

.iterator

Register an iterator fn by its type.

Params

• type {String}: The iterator type.
• fn {Function}: Iterator function

.pipeline

Add each plugin to a pipeline to be used with streams. Plugins must either be a stream or a function that returns a stream.

Params

• val {Array|Object|String}: The value to iterate over.

Example

1var pipeline = plugins.pipeline(plugin());

Related projects

async-array-reduce: Async reduce.

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 © 2015 Jon Schlinkert Released under the MIT license.

---

This file was generated by verb-cli on August 14, 2015.