SwiftLint Rule Analyzer

The SwiftLint Rule Analyzer ingests Swift source code and an optional SwiftLint configuration, then applies configured rules to identify style, correctness, and safety violations. It outputs a structured report with counts per rule family, severity, and pinpointed locations for remediation. This tool targets developers, code reviewers, build engineers, and CI systems working on Swift projects, including monorepos and multi-target apps. It supports incremental analysis to re-check only changed files in a commit.

Conceptually, it parses the source, normalizes identifiers, and checks each rule condition against the AST and token stream. It supports common rule families such as naming, line length, force unwrapping, availability checks, and Swift API usage patterns, returning a machine-readable list of violations with file, line, column, and snippet context. It can group violations by rule category, provide suggested fixes, and rank issues by impact. Optional rules can be toggled to reflect project standards.

Unique value comes from combining a lightweight analysis engine with a configurable, exportable report format suitable for downstream tooling. It integrates with local toolchains, including pre-commit hooks and CI pipelines, to stop builds on critical violations or to emit warnings for non-blocking issues. It also supports a dry-run mode to profile results without changing code, and a JSON schema for compatibility with external analyzers.

Core features include granular violation counts, per-file breakdown, optional auto-fix hints, and an exportable JSON payload with metadata such as analysis timestamp and Swift version. Use cases cover enforcing style guides, onboarding new Swift codebases, migrating legacy code, and maintaining consistent quality across teams. The tool is designed to run in isolated environments, providing deterministic results and minimal performance impact on large repositories.