Skip to content

adamrecsko/bonnet

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

20 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

bonnet

Bonnet is a simple tool for distributing your long running blocking tasks in time using ES6 generators in node.

Using Bonnet you are able to split your computation into pieces with yield and in the end return your result. Bonnet returns a promise and resolves it, if your function finished or rejects it, if you throw an error. The benefit of this is that you won't block your event loop if you are working on small fast parts.

Installation

$ npm install bonnet

And after:

var bonnet = require('bonnet');
bonnet(myGenerator);

How to use

Simple example

var bonnet = require('bonnet');
bonnet(function* () {
     var sum = 0;
     for (var i = 0; i <= 10000; i++) {
            yield sum = sum + i;
     }
     return sum;
}).then(function (data) {
    console.log(data);
}, function (error) {
    console.log(error);
});

Combine with promises

var bonnet = require('bonnet');
var Promise = require('promise');


function myAsynchronousTask() {
    return new Promise(function (resolve, reject) {
        setTimeout(function () {
            resolve("bar");
        }, 10);
    });
}

bonnet(function* () {
    var result = "foo";
    result += yield myAsynchronousTask();
    result += yield "foo";
    return result;
}).then(function (data) {
    console.log(data); //foobarfoo
});

Error handling

var bonnet = require('bonnet');
bonnet(function* () {
    var somethingWrong = true;
    if(somethingWrong){
       throw new Error("ERROR");
    }  
}).then(null, function (error) {
    console.log(error);
});

Wrapper

var wrap = require('bonnet').wrap;
var wrappedFunction = wrap(function* (a,b) {
      var str = "";
      for (var i=0; i<=10000; i++){
        str =  yield (new Array(5)).join(b);
      }
      return a+str;
});

wrappedFunction("foo","bar").then(function(data){
    console.log(data);  //foobarbarbarbar
});

Test

  $ npm test

About

Bonnet is a simple tool for distribute your long running blocking tasks in time using ES6 generators.

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors