Share your code. npm Orgs help your team discover, share, and reuse code. Create a free org »

    vopublic

    img

    Minimalist, yet complete control flow library

    What you get

    • new in 4.0 Consistent function signatures
    • Tiny library (16kb minified + gzipped, common modules)
    • 2 different kinds of flows: pipeline & stack
    • Browser & server support
    • Supports promises, generators, & sync functions
    • Serial and parallel execution for every flow
    • Returns a promise that you can yield on or "await"
    • DEBUG=vo for insight into what is being called
    • Easily catch and fix errors anywhere in the pipeline
    • Errors passed as arguments so you know where the failure occurred
    • Early exit support
    • Well-tested

    Installation

    • Node.js or Browserify: npm install vo
    • Standalone: vo.js & vo.min

    Getting Started

    Vo supports 2 kinds of asynchronous flows:

    • pipelines: Transformation pipeline. Return values become the arguments to the next function. As of 4.0.0, only the first argument to vo changes.
    • stacks: Express-style. Arguments are passed in at the top and flow through each middleware function

    Both of these flows support both parallel and serial execution

    Example

    function * get (url) {
      return yield fetch(url)
    }
     
    function map (responses) {
      return responses.map(res => res.status)
    }
     
    vo([
      fetch('https://standupjack.com'),
      fetch('https://google.com')
    ], map).then(function (statuses) {
      assert.deepEqual([ 200, 200 ])
    })

    Learn by example

    There's a lot going on behind the scenes of vo, so lets take these examples one at a time:

    Pipelines

    Behaves like transform streams, where return values become arguments to the next function.

    1. single argument, executed in order
    2. multiple arguments, executed in order
    3. single argument, executed in parallel
    4. multiple arguments, executed in parallel
    5. exit early from the pipeline
    6. error in the pipeline
    7. catch error and continue
    8. pipeline composition using promises
    9. pipeline composition with generators

    Stacks

    Behaves like express middleware, where the initial arguments are arguments to every function, regardless of return value.

    Examples coming soon! Check out the comprehensive test suite for now.

    Compose

    Not implemented yet! Going to use Blake's excellent throwback library to implement this. Also, accepting PRs :-D

    Vo Runtime

    Now you can run generators top-level with the runtime:

    index.js

    var res = yield superagent.get('http://google.com')
    console.log(res.status) // 200 
    vo index.js

    FAQ

    Binding a generator function isn't implemented consistently yet

    Use co-bind just to be safe.

    Test

    We have a comprehensive test suite. Here's how you run it:

    npm install
    make test

    License

    MIT

    install

    npm i vo

    Downloadslast 7 days

    985

    version

    4.0.2

    license

    none

    repository

    github.com

    last publish

    collaborators

    • avatar