scpp
v1.0.5
Published
Micro functions to execute asynchronous functions synchronously or in parallel.
Downloads
4
Maintainers
Readme
Forget about bloated libraries, promises, function generators and embrace callbacks.
Why scpp?
- Small (1 file, 20 lines of code, no dependency's)
- Fast (Faster then async.js)
- Tested in production
Install or copy/paste code
npm install --save scpp
const {sync, parallel} = require('scpp')
or
import {sync, parallel} from 'scpp'
sync minification
const sync = (l,c) => (function $(l,c,i,r){l[i]((e,d)=>l[++i]&&!e?$(l,c,i,d):c(e,d),r)})(l,c,0)
parallel minification
const parallel = (l,c) => {let t=l.length,x=1;l.forEach((v,k)=>v((e,d)=>{l[k]=d;return(--t!==0&&x===1&&!e)===true||--x||c(e,l)}))}
How to use sync
Sync accepts 2 arguments
- array, with functions to execute synchronously
[Function, Function, Function]
- callback function, which is executed after all functions in array have finished executing, or any of functions returns error
(error, result) => {
if (error) {
return new Error(error)
}
console.log(result)
}
Sync example
sync([
// Function always shod return callback
// return callback(ERROR, VALUE passing down)
// if ERROR is not null, synchronously execution will stop and error value is returned.
callback => {
console.log('First!')
return callback(null, 'Secound!')
},
// Only one value can be passed down (Which can contain multiple values inside, doh)
(callback, previously) => {
console.log(previously) // Secound!
return callback(null, 'Third!')
}
], (err, result) => {
// err = null, result = 'Third!'
if (err) {return new Error(err)}
console.log(result)
})
How to use parallel
Parallel accepts 2 arguments
- array, with functions to execute in parallel
[Function, Function, Function]
- callback function, which is executed after all functions in array have finished executing, or any of functions returns error
(error, result) => {
if (error) {
return new Error(error)
}
console.log(result)
}
Parallel example
parallel([
// Function always shod return callback
// return callback(ERROR)
// if ERROR is not null, parallel execution will stop and error value is returned.
callback => {
return callback(null, 'First!')
},
// No value can be passed down in parallel execution
callback => {
return callback(null, 'Second!')
},
callback => {
return callback(null, 'Third!')
}
// err = null, result = ['First!', 'Second!', 'Third!']
// result is array, contains all values from parallel execution, in proper order.
], (err, [first, second, third]) => {
if (err) {return new Error(err)}
console.log(first) // First!
console.log(second) // Second!
console.log(third) // Third!
})