transform the ast on a recursive walk
npm install fresh-falafelIMPORTANT for fresh-falafel
This is a fork of falafel that adds the ability to set the parser without requiring acorn ahead of time.
If this ever get merged you can use regular
falafel instead.
Original readme below
========
Transform the ast on a
recursive walk.
This modules uses acorn to create an AST from
source code.
Put a function wrapper around all array literals.
`` js
var falafel = require('falafel');
var src = '(' + function () {
var xs = [ 1, 2, [ 3, 4 ] ];
var ys = [ 5, 6 ];
console.dir([ xs, ys ]);
} + ')()';
var output = falafel(src, function (node) {
if (node.type === 'ArrayExpression') {
node.update('fn(' + node.source() + ')');
}
});
console.log(output);
`
output:
`
(function () {
var xs = fn([ 1, 2, fn([ 3, 4 ]) ]);
var ys = fn([ 5, 6 ]);
console.dir(fn([ xs, ys ]));
})()
` js`
var falafel = require('falafel')
Transform the string source src with the function fn, returning a
string-like transformed output object.
For every node in the ast, fn(node) fires. The recursive walk is a
pre-traversal, so children get called before their parents.
Performing a pre-traversal makes it easier to write nested transforms since
transforming parents often requires transforming all its children first.
The return value is string-like (it defines .toString() and .inspect()) sonode.update()
that you can call asynchronously after the function has
returned and still capture the output.
Instead of passing a src you can also use opts.source.
All of the opts will be passed directly to
acorn.
You may pass in an instance of acorn to the opts as opts.parser to use that
version instead of the version of acorn packaged with this library.
`js
var acorn = require('acorn-jsx');
falafel(src, {parser: acorn, plugins: { jsx: true }}, function(node) {
// this will parse jsx
});
`
Aside from the regular esprima data, you can also call
some inserted methods on nodes.
Aside from updating the current node, you can also reach into sub-nodes to call
update functions on children from parent nodes.
Return the source for the given node, including any modifications made to
children nodes.
Transform the source for the present node to the string s.
Note that in 'ForStatement' node types, there is an existing subnode calledupdate. For those nodes all the properties are copied over onto thenode.update() function.
Reference to the parent element or null at the root element.
With npm do:
`
npm install falafel
MIT