🐊Putout engine that parses input.
npm i @putout/engine-parser
Any parser should be installed before use, but you can be sure that @babel/parse always installed.
By default @putout/printer used. It formats code according to eslint-plugin-putout rules but without using ESLint.
But you can also use recast or babel with:
const ast = parse(source, {
printer: 'recast',
});
const code = print(ast, {
printer: 'recast',
});When you need to pass options, use:
const code = print(ast, {
printer: ['putout', {
format: {
indent: ' ',
},
}],
});Print code from ast
You can add default options for custom parser you use.
parse without memoization.
create node using memoization.
create node without memoization.
Extract expression node from ExpressionStatement.
You have two ways to benefit from source map generation:
- using
Recastprint; - using
Babelgenerator;
const source = `const hello = 'world';`;
const ast = parse(source, {
printer: 'recast',
sourceFileName: 'hello.js',
});
print(ast, {
printer: 'recast',
sourceMapName: 'hello.map',
});
// returns
`const hello = 'world';
{"version":3,"sources":["hello.js"],"names":[],"mappings":"AAAA...","file":"hello.map","sourcesContent":["const hello = 'world';"]}`;To generate sourcemap using babel generator, you should use babel parser before.
This is low level transformation, because Babel doesn't preserve any formatting.
const {generate} = require('@putout/engine-parser');
const babel = require('@putout/engine-parser/babel');
const ast = babel.parse(source, {
sourceFilename: 'hello.js',
});
generate(ast, {sourceMaps: true}, {
'hello.js': source,
});
// returns
({
code,
map,
});const {parse} = require('@putout/engine-parser');
const parser = 'acorn';
const code = parse('var t = "hello"', {
parser,
});MIT