dotnet/roslyn
Roslyn
The .NET Compiler Platform is a collection of open-source APIs for C# and Visual Basic that provides deep code analysis, refactoring, and automated source code generation. It serves as the core infrastructure for building development tools, offering a platform to inspect, modify, and understand source code through immutable syntax trees and semantic models.
The platform distinguishes itself by providing full-fidelity syntax trees that preserve every character of source code, including whitespace and comments, alongside an incremental compilation pipeline that enables near-instant feedback during development. It allows developers to build custom diagnostic analyzers and code fixes that integrate directly into the compilation process, as well as source generators that automatically produce and inject code at build time.
Beyond core compilation, the project includes comprehensive workspace management tools that model entire solutions, projects, and assembly references into a unified hierarchy. This infrastructure supports the development of IDE extensions, static analysis tools, and interactive scripting environments by providing deep semantic querying, symbol identification, and real-time code change tracking.
Features
- Source Code Compilers - Serves as the core compiler platform and infrastructure for C# and Visual Basic development.
- Syntax Tree Construction - Parses source code into full-fidelity, immutable syntax trees that preserve every character including whitespace and comments.
- Symbol Binding Engines - Maps syntax nodes to underlying symbols and types by resolving references across the entire project and its dependencies.
- Code Analysis and Transformation - Provides tools to inspect source code structure and logic by accessing detailed object models for deep analysis.
- Static Code Analyzers - Offers a toolkit for building custom diagnostic analyzers and automated code fixes to enforce quality standards.
- Code Transformation Tools - Enables programmatic modification of source code by generating new, modified versions of immutable syntax trees.
- Source Generators - Automatically produces and injects additional source code during the compilation process by inspecting existing syntax and metadata.
- Incremental Compilation Watchers - Minimizes redundant work during development by reusing previous analysis results for near-instant feedback.
- Language Intelligence Services - Provides advanced language intelligence services including semantic querying, symbol navigation, and real-time diagnostics.
- Compiler Infrastructure - Provides core infrastructure for developing custom language services and diagnostic tools that leverage deep semantic understanding.
- Compile-Time Code Generation - Inspects compilation data at compile time to automatically produce and inject additional source code into the build process.
- Compiler Analyzers - Provides a framework for building custom diagnostic analyzers that integrate directly into the compilation process.
- Solution Models - Structures source code into a hierarchy of projects and documents to enable automated analysis and transformation.
- Static Code Analysis - Provides infrastructure for building custom tools that inspect and analyze source code without execution.
- IDE Extensions - Supports the development of IDE plugins that provide real-time feedback, semantic navigation, and intelligent refactoring.
- Concrete Syntax Tree Generators - Parses source code into immutable, full-fidelity syntax trees that preserve every grammatical element including whitespace and comments.
- Workspace Management - Organizes projects and dependencies into a unified model to facilitate large-scale code analysis and refactoring.
- Project Workspaces - Organizes disparate files and assembly references into a unified, queryable hierarchy for large-scale software systems.
- Source Code Bundlers - Creates build-time processes that inspect existing code and metadata to automatically produce and inject new source files.
- Compiler APIs - Models the entire state of a program including source files, assembly references, and compiler options for deep analysis.
- Coding Standards Enforcement - Provides immediate feedback and automated corrections for team-specific style and quality requirements during development.
- Immutable Transformations - Enables efficient, thread-safe code modifications by reusing unchanged nodes in immutable syntax trees.
- Custom Analysis Rules - Integrates user-defined analysis rules into the compilation process to report custom errors and warnings.
- C# Development Tools - Provides rich code analysis APIs for C# and Visual Basic.
- Compiler Infrastructure - Official compiler platform and primary learning resource.
- Compilers and Interpreters - .NET compiler platform.
- Compilers and Languages - Compiler platform for C# and Visual Basic.
- Core Frameworks - Compiler platform providing rich code analysis and refactoring APIs.
- Semantic Querying - Extracts symbol references, expression types, and data flow details to provide deep insights into code behavior.
- Library Diagnostic Bundles - Bundles diagnostic analyzers and automated fixes with software libraries to detect and correct common usage errors.
- Symbol Resolution - Maps namespaces, types, and members to a unified representation that abstracts raw source code from imported metadata.
- Interactive Scripting Environments - Executes code snippets in a persistent runtime environment to test logic and explore APIs without full compilation.
- Binding Analysis - Reveals underlying binding and conversion details by inspecting symbols and types associated with specific code nodes.
- Code Execution Runtimes - Supports interactive code execution within persistent runtime contexts for rapid scripting and testing.
- Language Syntax - Categorizes nodes and tokens using language-specific rules to distinguish structural fragments within source code.
- Real-time Change Tracking - Monitors host environments for source file modifications to maintain an up-to-date internal representation of the codebase.
- Syntax Inspection - Visualizes hierarchical code structures to allow bidirectional navigation between the code editor and the syntax tree.
- Syntax Traversal - Provides tools to traverse syntax trees to inspect specific language constructs and their positions.
