benjamn/recast
Recast
Recast este un parser și printer AST JavaScript conceput pentru refactorizarea automată a codului. Acesta convertește codul sursă în arbori sintactici abstracti care pot fi modificați și apoi imprimați înapoi în cod sursă.
Proiectul se concentrează pe transformări care păstrează formatarea, stocând metadatele originale de spațiu alb și indentare în interiorul nodurilor arborelui sintactic pentru a reconstrui codul fără a pierde layout-ul original. De asemenea, generează source map-uri la nivel de caracter pentru a menține corespondențe precise între input-ul original și output-ul transformat.
Toolkit-ul include utilitare pentru manipularea arborelui sintactic folosind un visitor pattern, precum și opțiuni pentru pretty-printing de stil generic. Este furnizată o interfață în linie de comandă pentru a executa aceste funcții de transformare pe fișierele țintă și a scrie rezultatele pe disc.
Features
- Automated Code Refactoring - Automates structural changes to JavaScript source code through programmatic AST manipulation to update patterns across codebases.
- AST Structure Modification - Provides utilities for replacing, inserting, and removing nodes within the abstract syntax tree structure.
- AST-Based Source Transformations - Provides structural modifications of source code by replacing matched syntax tree nodes while preserving original formatting.
- JavaScript AST Transformations - Performs structural modifications of JavaScript source code represented as an abstract syntax tree.
- Formatting-Preserving Transformers - Modifies JavaScript syntax trees while preserving original whitespace and indentation in the resulting output.
- Code Refactoring Tools - Automates JavaScript code refactoring by manipulating AST nodes and regenerating source files.
- Format-Preserving Printing - Retains original whitespace and formatting tokens within the AST to reconstruct source code without losing layout.
- JavaScript AST Printers - Provides a complete system for parsing JavaScript into ASTs and printing them back to source code.
- Source Code Generators - Programmatically generates valid JavaScript source code from modified abstract syntax tree representations.
- Abstract Syntax Tree Parsing - Converts JavaScript source code into a structured tree representation while retaining formatting metadata.
- Tree Traversal - Utilizes a visitor pattern to programmatically navigate and apply transformations to nodes within the syntax tree.
- Non-Destructive Source Printing - Splices original source text fragments around modified syntax tree nodes to maintain existing indentation during printing.
- Syntax Tree Transformers - Provides tools for modifying and rewriting syntax trees to perform complex code transformations.
- Source Map Generation - Implements character-level source maps to maintain precise correspondences between original input and transformed output.
- Pretty Printing Algorithms - Offers a generic style pretty-printer that applies consistent global indentation rules regardless of original formatting.
- JavaScript Source Maps - Generates precise character-level source maps specifically for transformed JavaScript files.
- Source Map Generation - Creates character-by-character mappings between original source files and generated output for debugging.
- Source Map Generators - Provides character-level source maps that link transformed output back to the original JavaScript source files.
- AST & Language Tools - JavaScript AST transformer with source map support.
- Development Utilities - Syntax tree transformer and source map generator.
