rust-lang-nursery/rustfmt
Rustfmt
rustfmt is a tool that automatically rewrites Rust source code to adhere to a consistent and standardized style guide. It functions as both a code formatter for transforming source files and a style linter used to verify if code matches required formatting rules.
The system is configurable, allowing for the definition of custom formatting rules and language editions through configuration files to override default styles. It also supports selective formatting by using dedicated skip markers to prevent specific blocks of code from being modified.
The tool provides capabilities for both source code rewriting across project directories and style compliance verification to identify non-compliant source during automated builds.
Features
- Source Code Rewriting - Automatically rewrites Rust source code to adhere to a consistent style guide across project directories.
- Source Code Formatters - Preventing specific blocks of Rust code from being modified by the formatter using dedicated skip markers.
- Automatic Code Formatters - Automatically rewrites Rust source code to adhere to a consistent and standardized style guide.
- Coding Style Tools - Includes a verification utility to check if source code matches the required style guide for automated builds.
- Formatting Configurations - Allows customization of formatting behavior and language editions via a configuration file.
- Formatting Engines - Provides a rule-based engine that determines the final layout of tokens and whitespace based on configuration.
- Style Compliance Tools - Verifies that Rust code matches required style guidelines to prevent errors during CI processes.
- Style Linters - Verifies if Rust code matches required formatting rules and returns errors for non-compliant source.
- Formatter Configurations - Utilizes external configuration files to define formatting rules and file exclusion patterns.
- Formatting Exclusion Directives - Provides mechanisms to selectively disable code formatting for specific blocks using skip markers.
- Formatting Exclusion Markers - Identifies specific attributes or comments in the source to skip the transformation process for those code segments.
- Token Stream Preservation - Maintains a mapping of original tokens to ensure comments and attributes remain attached to their related expressions.
- Idempotency Patterns - Employs an idempotent formatting cycle to ensure stable and consistent style application through repeated processing.
- Language-Specific Formatting Overrides - Supports defining specific formatting overrides and language editions for Rust projects.
- Recursive Tree Transformers - Uses a recursive tree transformer to walk the syntax tree and apply indentation and line-breaking rules.
- 开发者工具 - Tool for enforcing consistent code formatting.
