praan v1.4.0

Praan

The same stream of life that runs through my veins night and day runs through the world and dances in rhythmic measures.

praan is a Functor for reactive programming. if you like functional programming, you can use of/map/flatMap/flat/ap as you like, and all the function will return a new stream.

you can associate a stream with an array that expose it's element at the right time. for example, a stream of 1,2,3,4 is an array expose 1,2,3,4 immediately. and a stream of user input is an array that expose a data when user input a value.

you can observe a stream stream.observe(fn), and fn will be call every time there is a value in the stream to be exposed.

Install

npm install praan

// es6 
import praan from 'praan';

// es5
var praan = require('praan');

example

var stream = praan.of([1,2,3,4]);
    .then(item=>item+1);
stream.observe(console.info);   // 1,2,3,4


/**
 * promise
 */
praan.fromPromise(Promise.resolve('praan'));

/**
 * exception catch
 */
praan.fromPromise(Promise.reject({msg:'opps! promise reject at beginning!!'})))
    .then(data=>data+1)
    .then(data=> praan.of(getPromise(data)))
    .catch(e=>{
        console.info(e)    //{msg:'opps! promise reject at beginning!!'}
    })
    .start()
// -----praan----