Skip to content
JavaScript asynchronous control flow utility library.
JavaScript
Pull request Compare This branch is 7 commits behind samholmes:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
test
.gitattributes
.gitignore
Makefile
README.md
index.js
package.json
testem.err
testem.json
testem.log

README.md

lace

Lace is a control flow library that doesn't get in your way. Here's how it works

// Require the lib
var lace = require('lace');

// Call lace. Create a lacing (series of functions).
lace
(function(){
    // Within each of these functions are some helpers contained in the lace global.
    lace.next(); // This calls the next function in the series.
}) // Lace supports currying to create the lacing.
(function(){
    // Helpers are also available here.
    // All arguments are directly from the invocation of the previous lace.next (no appending or prepending of arguments).
    // The `this` context will be what the context of lace.next's context was applied to.

    // Inner lacings are supported
    lace
    (function(){
        // Helpers will work reference the inner lacing
        lace.next();
    })
    (function(){
        // Access to the outer lace is done through the lace.outer helper property
        lace.outer.next();
    });
})
(function(){
    // This was called from the lace.outer.next.
    // Everything should just work, without getting in your way.
});

Lace is all about asynchronous control flow. You can pass lace.next to asynchronous function such as setTimout, database query callbacks, etc.

Another thing to keep in mind, is that the first function is called asynchronously:

console.log('Called before initial lacing function.');

lace
(function(){
    console.log('Initial lacing funciton.');
})

console.log('Also, called before initial lacing function.')

Terminology

Lace

Library name. Global exported object and helper.

Lacing

The lacing is the series of functions or function sets. A lacing function is one of the "steps" in the control flow.

Something went wrong with that request. Please try again.