swiftlint

SwiftLint is the industry-standard linter and formatter for Swift code that enforces style guidelines and best practices based on the community-driven Swift Style Guide. It serves as an essential tool for maintaining high-quality, consistent Swift codebases.

Key Features:

Comprehensive Rule Set: Over 200 built-in rules covering code style, performance, best practices, and potential bug detection
SourceKit Integration: Leverages Apple's SourceKit for accurate AST-based analysis and precise error detection
Automatic Fixing: Intelligent auto-correction for many rule violations, saving manual effort
Highly Configurable: Extensive configuration options with support for enabling/disabling rules and custom severity levels
Custom Rules: Support for project-specific custom rules using regular expressions and AST patterns
Xcode Integration: Seamless integration with Xcode projects through build phases and scheme actions
Performance Optimized: Fast analysis even for large Swift projects with incremental linting support
Multiple Output Formats: Supports various report formats including JSON, HTML, and checkstyle for tool integration

swiftlint documentation

Version in MegaLinter: 0.59.1
Visit Official Web Site
Docker image: ghcr.io/realm/swiftlint:SWIFT_SWIFTLINT_VERSION
- arguments: -v {{WORKSPACE}}:/tmp/lint:rw -w /tmp/lint
See How to configure swiftlint rules
See How to disable swiftlint rules in files
See Index of problems detected by swiftlint

Configuration in MegaLinter

Enable swiftlint by adding SWIFT_SWIFTLINT in ENABLE_LINTERS variable
Disable swiftlint by adding SWIFT_SWIFTLINT in DISABLE_LINTERS variable

Enable autofixes by adding SWIFT_SWIFTLINT in APPLY_FIXES variable

Variable	Description	Default value
SWIFT_SWIFTLINT_DOCKER_IMAGE_VERSION	Docker image version	`SWIFT_SWIFTLINT_VERSION`
SWIFT_SWIFTLINT_ARGUMENTS	User custom arguments to add in linter CLI call Ex: `-s --foo "bar"`
SWIFT_SWIFTLINT_COMMAND_REMOVE_ARGUMENTS	User custom arguments to remove from command line before calling the linter Ex: `-s --foo "bar"`
SWIFT_SWIFTLINT_CLI_LINT_MODE	Override default CLI lint mode ⚠️ As default value is project, overriding might not work - `file`: Calls the linter for each file - `list_of_files`: Call the linter with the list of files as argument - `project`: Call the linter from the root of the project	`project`
SWIFT_SWIFTLINT_FILE_EXTENSIONS	Allowed file extensions. `"*"` matches any extension, `""` matches empty extension. Empty list excludes all files Ex: `[".py", ""]`	`[".swift"]`
SWIFT_SWIFTLINT_FILE_NAMES_REGEX	File name regex filters. Regular expression list for filtering files by their base names using regex full match. Empty list includes all files Ex: `["Dockerfile(-.+)?", "Jenkinsfile"]`	Include every file
SWIFT_SWIFTLINT_PRE_COMMANDS	List of bash commands to run before the linter	None
SWIFT_SWIFTLINT_POST_COMMANDS	List of bash commands to run after the linter	None
SWIFT_SWIFTLINT_UNSECURED_ENV_VARIABLES	List of env variables explicitly not filtered before calling SWIFT_SWIFTLINT and its pre/post commands	None
SWIFT_SWIFTLINT_CONFIG_FILE	swiftlint configuration file nameUse `LINTER_DEFAULT` to let the linter find it	`.swiftlint.yml`
SWIFT_SWIFTLINT_RULES_PATH	Path where to find linter configuration file	Workspace folder, then MegaLinter default rules
SWIFT_SWIFTLINT_DISABLE_ERRORS	Run linter but consider errors as warnings	`false`
SWIFT_SWIFTLINT_DISABLE_ERRORS_IF_LESS_THAN	Maximum number of errors allowed	`0`
SWIFT_SWIFTLINT_CLI_EXECUTABLE	Override CLI executable	`['swiftlint']`

IDE Integration

Use swiftlint in your favorite IDE to catch errors before MegaLinter !

	IDE	Extension Name	Install
	IDEA	swiftlint
	xcode	Configure manually	Visit Web Site

MegaLinter Flavors

This linter is available in the following flavors

Flavor	Description	Embedded linters
all	Default MegaLinter Flavor	126
cupcake	MegaLinter for the most commonly used languages	87
swift	Optimized for SWIFT based projects	50

Behind the scenes

How are identified applicable files

Activated only if one of these files is found: .swiftlint.yml
File extensions: .swift

How the linting is performed

swiftlint is called once on the whole project directory (project CLI lint mode)

filtering can not be done using MegaLinter configuration variables,it must be done using swiftlint configuration or ignore file (if existing)
VALIDATE_ALL_CODEBASE: false doesn't make swiftlint analyze only updated files

Example calls

docker run -v /tmp/lint:/tmp/lint:rw ghcr.io/realm/swiftlint:latest swiftlint --strict

docker run -v /tmp/lint:/tmp/lint:rw ghcr.io/realm/swiftlint:latest swiftlint --fix --strict

Help content

OVERVIEW: A tool to enforce Swift style and conventions.

USAGE: swiftlint <subcommand>

OPTIONS:
  --version               Show the version.
  -h, --help              Show help information.

SUBCOMMANDS:
  analyze                 Run analysis rules
  docs                    Open SwiftLint documentation website in the default
                          web browser
  generate-docs           Generates markdown documentation for selected group
                          of rules
  lint (default)          Print lint warnings and errors
  baseline                Operations on existing baselines
  reporters               Display the list of reporters and their identifiers
  rules                   Display the list of rules and their identifiers
  version                 Display the current version of SwiftLint

  See 'swiftlint help <subcommand>' for detailed help.

Installation on mega-linter Docker image

Dockerfile commands :

# renovate: datasource=docker depName=ghcr.io/realm/swiftlint
ENV SWIFT_SWIFTLINT_VERSION=0.59.1