Asyncer.js NPM

asyncer.js

Run groups of (a)sync functions.

:cloud: Installation

# Using npm
npm install --save asyncer.js

# Using yarn
yarn add asyncer.js

:clipboard: Example

const asyncer = require("asyncer.js");

let log = console.log;

let tasks = [
    // Execute this sync function
    () => { log("First"); }

    // *Then* execute an async one
  , cb => {
        setTimeout(() => {
            log("Waited a second");
            cb();
        }, 1000);
    }

    // Another async function
  , cb => {
        setTimeout(() => {
            log("Waited another second");
            cb();
        }, 1000);
    }

    // *Then* Execute the following group
  , [
        // ...containing a sync function
        () => { log("First in nested group"); }
      , {
            // ...and a group of parallel functions
            // to run in the same time
            parallel: [
                cb => {
                    setTimeout(() => {
                        log("In parallel 1");
                        cb();
                    }, 1000);
                }
              , cb => {
                    setTimeout(() => {
                        log("Second one in parallel, but I'll be faster.");
                        cb();
                    }, 100);
                }
            ]
        }

        // After that group of parallel function, execute
        // this group of parallel functions
      , {
            parallel: [
               cb => {
                    setTimeout(() => {
                        log("Waited a second in another parallel group.");
                        cb();
                    }, 1000);
                }
              , cb => {
                    setTimeout(() => {
                        log("Waited 100ms ");
                        cb();
                    }, 100);
                }
            ]
        }
    ]

    // Run another sync function
  , () => { log("Almost done."); }

    // An another async one
  , cb => {
        setTimeout(() => {
            log("Last");
            cb();
        }, 1000);
    }
];

// Pass the array above to asyncer
asyncer(tasks, err => {
    console.log("Everything was done.");
    // =>
    // First
    // Waited a second
    // Waited another second
    // First in nested group
    // Second one in parallel, but I'll be faster.
    // In parallel 1
    // Waited 100ms
    // Waited a second in another parallel group.
    // Almost done.
    // Last
    // Everything was done.
});

:question: Get Help

There are few ways to get help:

Please post questions on Stack Overflow. You can open issues with questions, as long you add a link to your Stack Overflow question.
For bug reports and feature requests, open issues. :bug:
For direct and quick help, you can use Codementor. :rocket:

:memo: Documentation

`asyncer(tasks, cb)`

Run groups of (a)sync functions.

Params

Array|Object tasks: The tasks to run in parallel or one by one.
Function cb: The callback function.

:yum: How to contribute

Have an idea? Found a bug? See how to contribute.

:sparkling_heart: Support my projects

I open-source almost everything I can, and I try to reply to everyone needing help using these projects. Obviously, this takes time. You can integrate and use these projects in your applications for free! You can even change the source code and redistribute (even resell it).

However, if you get some profit from this or just want to encourage me to continue creating stuff, there are few ways you can do it:

Starring and sharing the projects you like :rocket:
—I love books! I will remember you after years if you buy me one. :grin: :book:
—You can make one-time donations via PayPal. I'll probably buy a ~~coffee~~ tea. :tea:
—Set up a recurring monthly donation and you will get interesting news about what I'm doing (things that I don't share with everyone).
Bitcoin—You can send me bitcoins at this address (or scanning the code below): 1P9BRsmazNQcuyTxEqveUsnf5CERdq35V6