Sparallel

Super parallel function runner.

Simply pass functions to sparallel and call the done (or resolve) callback when each finishes. Sparallel returns a promise so the then method takes a callback that will run after all other functions have called the done callback.

Sounds confusing, so here's an example:

import sparallel from 'sparallel';
 
sparallel(
    done => {
        console.log('code 1');
        done();
    },
    done => {
        console.log('code 2');
        done();
    },
    done => {
        console.log('code 3');
        done();
    }
).then(() => {
    console.log('all done.');
});

The Best Part

The best part of sparallel is that you can pass an object to each done callback and all of the objects will be merged into a single object and passed to the then callback.

Example

sparallel(
    done => {
        setTimeout(function() {
            done({name: 'sam'});
        }, 1000);
    },
    done => {
        setTimeout(function() {
            done({color: 'blue'});
        }, 1100);
    },
    done => {
        setTimeout(function() {
            done({fat: 'probably not'});
        }, 5);
    }
).then(resObj => {
    console.log(resObj); // {name: 'sam', color: 'blue', fat: 'probably not'}
});

Error Handling

The second parameter to each function is an optional error handler.

Example

sparallel(
    resolve => {
        setTimeout(function() {
            resolve({name: 'sam'});
        }, 1000);
    },
    (resolve, error) => {
        setTimeout(function() {
            error('i failed :(');
        }, 1100);
    },
    resolve => {
        setTimeout(function() {
            resolve({fat: 'probably not'});
        }, 5);
    }
)
// will NOT run
.then(resObj => {
    console.log(resObj); // {name: 'sam', fat: 'probably not'}
})
// will run
.catch(error => {
    console.log(error); // "i failed :("
});