A JavaScript AST-aware diff and patch toolset
When comparing two JavaScript files, standard diff tools compare the two files line-by-line and output the lines on which the files differ. This tool does not compare the characters of the source files directly but their abstract representation - their abstract syntax trees.
JavaScript source file1 JavaScript source file2
+ +
| |
| |
| |
v v
abstract syntax tree abstract syntax tree
+ +
| |
| |
| |
v v
generated JS source file generated JS source file2
+ +
| |
| ++++ |
+---> diff <---+
----
This enables you to have more meaningfull diffs between files which may be very simmilar but have different source code formatting.
When patching, astii patch will regenerate (original --> AST --> generate) the source file and patch it with the provided diff.
npm install . -g
npm install
npm test
Usage: astii [options] [command]
Commands:
patchSafe <file1> <patchfile> apply an astii-generated diff file to an original in an AST-aware way, losing original formatting, safer
patch <file1> <patchfile> apply an astii-generated diff file to an original in an AST-aware way, preserving original formatting
diff <file1> <file2> compare AST-neutral representations of two JavaScript files line by line
git-diff <file1> <SHA> compare AST-neutral representations of a JavaScript files against its specified git revision
git-diff-version <file1> <SHA1> <SHA2> compare AST-neutral representations of a JavaScript file between two git revisions
Options:
-h, --help output usage information
-V, --version output the version number