async-helpers

Use async helpers in templates with engines that typically only handle sync helpers. Handlebars and Lodash have been tested.

Install

Install with npm:

$ npm install async-helpers --save

Usage

var asyncHelpers = require('async-helpers');

API

AsyncHelpers

Create a new instance of AsyncHelpers

Params

• options {Object}: options to pass to instance
• returns {Object}: new AsyncHelpers instance

Example

var asyncHelpers = new AsyncHelpers();

.set

Add a helper to the cache.

Params

• name {String}: Name of the helper
• fn {Function}: Helper function
• returns {Object}: Returns this for chaining

Example

asyncHelpers.set('upper', function(str, cb) {
  cb(null, str.toUpperCase());
});

.get

Get all helpers or a helper with the given name.

Params

• name {String}: Optionally pass in a name of a helper to get.
• options {Object}: Additional options to use.
• returns {Function|Object}: Single helper function when name is provided, otherwise object of all helpers

Example

var helpers = asyncHelpers.get();
var wrappedHelpers = helperAync.get({wrap: true});

.wrap

Wrap a helper with async handling capibilities.

Params

• name {String}: Optionally pass the name of the helper to wrap
• returns {Function|Object}: Single wrapped helper function when name is provided, otherwise object of all wrapped helpers.

Example

var wrappedHelper = asyncHelpers.wrap('upper');
var wrappedHelpers = asyncHelpers.wrap();

.reset

Reset all the stashed helpers.

• returns {Object}: Returns this to enable chaining

Example

asyncHelpers.reset();

.resolveId

Resolve a stashed helper by the generated id. This is a generator function and should be used with co

Params

• key {String}: ID generated when from executing a wrapped helper.

Example

var upper = asyncHelpers.get('upper', {wrap: true});
var id = upper('doowb');

co(asyncHelpers.resolveId(id))
  .then(console.log)
  .catch(console.error);

//=> DOOWB

.resolveIds

After rendering a string using wrapped async helpers, use resolveIds to invoke the original async helpers and replace the async ids with results from the async helpers.

Params

• str {String}: String containing async ids
• cb {Function}: Callback function accepting an err and content parameters.

Example

asyncHelpers.resolveIds(renderedString, function(err, content) {
  if (err) return console.error(err);
  console.log(content);
});

Related projects

You might also be interested in these projects:

• assemble: Assemble is a powerful, extendable and easy to use static site generator for node.js. Used… more | homepage
• co: generator async control flow goodness | homepage
• generate: Fast, composable, highly pluggable project generator with a user-friendly and expressive API. | homepage
• templates: System for creating and managing template collections, and rendering templates with any node.js template engine.… more | homepage
• verb: Documentation generator for GitHub projects. Verb is extremely powerful, easy to use, and is used… more | homepage

Contributing

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

Building docs

Generate readme and API documentation with verb:

$ npm install verb && npm run docs

Or, if verb is installed globally:

$ verb

Running tests

Install dev dependencies:

$ npm install -d && npm test

Author

Brian Woodward

• github/doowb
• twitter/doowb

License

Copyright © 2016, Brian Woodward. Released under the MIT license.

This file was generated by verb, v0.9.0, on June 06, 2016.