extruder

> Functional, promise-based tools for processing node-task input objects.

API

$3

Iterate over node-task inputs and map their sources for transformation by a provided callback. Return a promise which resolves to the modified input.

``js
extruder.map(input, fn, context)
`

* input A node-task input object.
* fn A method to be invoked for each source item. Its return value (can be a promise) will replace each source item. fn(source, dest)
* context The context the fn will be called with.

`js
var extruder = require('./lib/extruder');
var sources = ['path/to/source1', 'path/to/source2'];
extruder.map(sources, function(source, dest) {
return source+'mapped';
}).then(function(result) {
console.log(result); // ['path/to/source1mapped', 'path/to/source2mapped'];
});

var sourceDestPairs = [
{ src: 'path/to/source1', dest: 'path/to/dest' },
{ src: ['path/to/source2', 'path/to/source3'], dest: 'path/to/dest' }
];
extruder.map(sourceDestPairs, function(source, dest) {
return source+'mapped';
}).then(function(result) {
console.log(result); // [ { src: 'path/to/source1', dest: 'path/to/dest' },
// { src: 'path/to/source2-path/to/source3, dest: 'path/to/dest' } ]
});
`

$3

Iterate over node-task inputs and reduce their sources with a provided callback. Return a promise which resolves to the modified input.

`js
extruder.reduce(input, fn, context)
`

* input A node-task input object.
* fn A method to be invoked for each source array. Its return value (can be a promise) will replace each source array. fn(source, dest)
* context The context the fn will be called with.

`js
var extruder = require('extruder');
var sources = ['path/to/source1', 'path/to/source2'];
extruder.reduce(sources, function(sources, dest) {
return sources.join('-');
}).then(function(result) {
console.log(result); // 'path/to/source1-path/to/source2';
});

var sourceDestPairs = [
{ src: 'path/to/source1', dest: 'path/to/dest' },
{ src: ['path/to/source2', 'path/to/source3'], dest: 'path/to/dest' }
];
extruder.reduce(sourceDestPairs, function(sources, dest) {
return sources.join('-');
}).then(function(result) {
console.log(result); // [ { src: 'path/to/source1', dest: 'path/to/dest' },
// { src: 'path/to/source2-path/to/source3', dest: 'path/to/dest' } ]
});
``