nicklockwood/SwiftFormat

Features

• Code Formatting Tools - Provides a comprehensive tool for automatically enforcing consistent visual styling and formatting rules across Swift source files.
• Code Quality Linting - Checks source files for style violations and reports required changes without modifying the code.
• Automatic Code Formatters - Automatically rewrites Swift source code to adhere to consistent visual style and syntax standards.
• Brace Placement Standardization - Wraps curly braces according to specific style guides and manages spacing inside and around them.
• Code Refactoring Tools - Modernizes code interactions by updating outdated environment values and initializers with modern language macros.
• Formatting Configurations - Provides mechanism to toggle formatting rules via command-line arguments or shared configuration files.
• Horizontal Spacing Normalization - Replaces consecutive spaces with single spaces and manages gaps around operators and delimiters for consistent density.
• Import Sorters - Alphabetizes and groups import statements based on access control, length, or test status.
• Indentation Rules - Indents code based on scope levels using configurable space counts and tab widths.
• Line Wrapping Engines - Breaks lines exceeding a maximum width for function arguments and collection elements to prevent horizontal scrolling.
• Swift Linters - Provides a static analysis tool that identifies style violations in Swift code without modifying the source.
• Swift Refactoring Tools - Simplifies language constructs and modernizes API usage within Swift source code.
• Swift Code Formatters - Applies a consistent visual style to Swift source files to ensure a uniform appearance.
• Swift Refactoring Tools - Simplifies Swift language constructs and removes redundant code to improve maintainability.
• Language Feature Updates - Updates legacy Swift patterns and API usage to align with the latest language features.
• Sequential Formatting Passes - Applies a sequence of discrete formatting rules to source code through multiple passes over the text.
• Declaration Sorting - Sorts members within classes and structs by visibility or type and inserts category markers for navigation.
• Language Construct Simplification - Simplifies code readability by converting functional calls to loops and map closures to key paths.
• Rule-Based Pattern Matching - Employs regular expression patterns to identify code structures and trigger targeted text replacements for styling.
• Project Configuration Management - Uses shared configuration files to maintain consistent formatting standards across teams and project directories.
• Static Analysis - Examines Swift source code without execution to identify style violations and quality issues.
• Xcode Plugins - Provides an Xcode extension that brings automated code formatting directly into the Apple IDE.
• Command Line Interfaces - Ships a terminal-based utility for batch processing and formatting Swift files across projects.
• Development Workflow Integration - Integrates automated code styling into Xcode and command-line pipelines for consistent team standards.
• Style Inference - Analyzes an existing codebase to suggest formatting settings that match the project's current style.
• Hash-Based Change Detection - Uses cryptographic checksums to detect modified files and skip processing for unchanged source code.
• File Header Templates - SwiftFormat replaces or removes header comments using templates with dynamic placeholders for dates and author information.
• Type Declaration Optimization - Optimizes type definitions by converting namespace types to enums and replacing generic constraints with opaque types.
• Whitespace Management - SwiftFormat inserts or removes blank lines around imports, guard statements, and scope boundaries to improve vertical readability.
• Access Control Standardization - Standardizes the order of member modifiers and removes redundant access modifiers from internal or private types.
• Test Suite Modernization - Migrates test cases to modern testing libraries and replaces unsafe unwraps with structured requirement checks.
• Configuration-Driven Logic - Provides a system where formatting behavior is determined by shared settings files and command-line arguments.
• Naming Conventions - Enforces standardized rules for naming identifiers and test case names to ensure consistency across the codebase.
• Redundant Keyword Removal - Removes unnecessary return keywords, explicit void types, and unused private declarations to simplify source files.
• Code Quality - Formats and cleans up Swift source code.
• Code Quality Tools - Formats Swift code automatically.
• Command Line Utilities - Library and CLI for formatting Swift code.
• Static Analysis Tools - Formatting tool for Swift code.

Star history