apple/swift-syntax
Swift Syntax
swift-syntax is a library for parsing, manipulating, and generating Swift source code. It provides a source-accurate abstract syntax tree representation of Swift code, acting as a parser, transformer, and code generator.
The project serves as the infrastructure for Swift macro development, enabling the expansion and transformation of source code during compilation. It is used to build compiler tooling for static analysis, formatting, and automated refactoring.
The system covers a broad range of source analysis capabilities, including the ability to convert source code into structured trees for inspection and the ability to programmatically modify those trees to generate updated source files.
Features
- Source Code Analysis Tools - Provides a comprehensive parser to convert Swift source code into structured trees for programmatic analysis.
- Swift Source Code Transformers - Provides the primary infrastructure for programmatically modifying and transforming Swift source code via a source-accurate syntax tree.
- Swift Code Generators - Converts structured tree representations into plain text files to generate valid Swift source code.
- Macro Expansion Frameworks - Acts as the underlying infrastructure for parsing and expanding Swift macros through structural source transformation.
- Source Code Abstract Syntax Trees - Provides a source-accurate abstract syntax tree that maps every character and token for precise reconstruction.
- Source Code Transformation Engines - Transforms Swift source code by manipulating the abstract syntax tree to generate updated files.
- Source Code Generators - Programmatically generates source-accurate tree representations of code for insertion into existing Swift files.
- Swift Source Analysis - Parses Swift code into structured trees to enable programmatic inspection of the program's logic and structure.
- Swift Source Parsers - Provides a library for converting Swift source code into a structured tree for programmatic analysis.
- Lossless Semantic Trees - Provides a lossless semantic tree that preserves all whitespace and comments for exact source code reconstruction.
- Recursive Descent Parsers - Employs recursive descent parsing to organize Swift source code into a hierarchical structure of expressions and statements.
- Swift Refactoring Tools - Enables automated refactoring of Swift source code by modifying its structure programmatically.
- C-Based Parsers - Implements a low-level C parser for high-efficiency conversion of Swift source text into an abstract syntax tree.
- Lexical Tokenizers - Implements a lexical tokenizer to break raw Swift input strings into discrete tokens for the structural tree.
- Swift Development Tooling - Serves as the foundation for building custom Swift tools for static analysis and code formatting.
- Immutable Transformations - Uses an immutable node hierarchy to ensure thread safety and stable transformations during syntax tree manipulation.
- Macro Development Tools - Official library for parsing and manipulating Swift source code.
