Make it easy to develop large, complex Node.js app. With Tas, we are free to combine async tasks and sync tasks, all of them are performed in the order we arranged, which greatly simplifies the development, and the code is clear, and easy to maintain. Tas means "tasks".

Most people use the nested callback approach for handling asynchronous Node.js operations, this lead to an untameable callback hell. Now, with Tas, there is no callback hell any more, and it is extremely easy for writing a lot of asynchronous code.

A blocking call can cause a significant reduction in performance. Now, with Tas, we can completely and easily use async api instead of blocking api in Node.js, which will make the overall performance of the app greatly improved.

Install

$ npm install tas --save

Test

Clone the Tas repo first:

$ git clone https://github.com/tasjs/tas.git
$ cd tas
$ npm install

Run the tests:

$ npm test

Demo

The results are as follows:

Try it:

$ cd /path/to/tas
$ node examples/demo/index.js

Quick Example

// Use .begin() at the beginning of main js file.
var tas = require('tas').begin();
var a;

var tasks = function(){
    
    // Put sync code before tas().
    // Or put them in tas() like doSomething() at below.
    a = 0;
    
    // Use tas() to join the task(s) into Tas queue.
    // Tas will perform it in the order we arranged 
    // instead of running it immediately.
    tas({
        doSomething: function(){
          
            a ++; // 1

            // Go to the next task
            tas.next();
        },

        waitAndContinue: function(){
            a ++; // 2

            // Simulate an async task
            setTimeout(function(){
                a ++; // 3

                // Go to the next task when this async task is done.
                tas.next(2);
            }, 1000);
        }
    });

    tas(function(a0){
        a += a0 ; // 5
        console.log(a); // 5

        // Use tas.end() at the ending of main js file.
        tas.end();
    });
};

tas(tasks);

Full Examples

See the examples/usage folder. Try to run index.js and index.test.js (if exists) in each sub folder.

• Beginning
• The order of tasks
• Mixing sync tasks and async tasks
• Passing data
• Fixing callback hell / callback pyramid with Tas
• Performing multiple async tasks concurrently
• --
• Abort the current task stream
• Break the current tasks
• --
• Simple log tree
• Complex log tree

API

See the examples/api folder. Try to run each file in each sub folder.

Task Stream

| Usage | Functions | Example | | ----------- | ---------------------------------------- | ---------------------------------------- | | tas.begin() | Use it at the beginning of main js file. | Example | | tas() | Add an async task(s) or a sync task(s) to task stream. | Example | | tas.sync() | Add a sync task(s) to task stream. | Example | | tas.next() | Go to the next task. Use tas.pass() to improve performance. | Example | | tas.all() | Add multiple async tasks and perform them concurrently. | Example | | tas.end() | Use it at the ending of main js file. | Example |

Breaking Flow

| Usage | Functions | Example | | ----------- | ---------------------------------------- | ---------------------------------------- | | tas.abort() | Abort the current task stream. | Example | | tas.break() | Break the current tasks. | Example |

Log Tree

| Usage | Functions | Example | | ----------------- | ---------------------------------------- | ---------------------------------- | | tas.enableTree() | Enable printing log tree. | Example | | tas.disableTree() | Disable printing log tree. | Example | | tas.log() | Print custom log with indent of log tree. | Example | | tas.load() | Print log tree with header and footer in submodule. | Example |

Performance

Tas can performs more than 1 million async tasks per second. With Tas, we can write server app with clear structure and excellent performance in Node.js. See details

License

MIT

Copyright (c) 2017, Owen Luke