tas

    1.6.7 • Public • Published


    Linux Build Status Windows Build Status Coverage Status Version License

    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.

    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

    Install

    npm i tas

    DownloadsWeekly Downloads

    57

    Version

    1.6.7

    License

    MIT

    Unpacked Size

    627 kB

    Total Files

    214

    Last publish

    Collaborators

    • avatar