README.md

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!
})