This content originally appeared on DEV Community and was authored by Kevin Furjan
What is a linter
Linter is a static code analysis tool used to flag programming errors, bugs, stylistic errors, and suspicious constructs. In other words, linter checks the source code for programmatic as well as stylistic errors. By doing that, it is helpful in identifying some common and uncommon mistakes that are made during coding, meaning that it helps in increasing the code's reliability and maintaining a higher level of code discipline.
What is SwiftLint
Well, it's a linter tool to enforce style and conventions for Swift programming language. SwiftLint enforces the style guide rules that are generally accepted by the Swift community, described in style guides like Ray Wenderlich's Swift Style Guide.
Installation
SwiftLint can be installed on OS level using Homebrew package manager with the following command: brew install swiftlint.
If you, however, want to install SwiftLint as dependency only to your project, you can do that using CocoaPods by adding pod 'SwiftLint' to your Podfile. This will download the SwiftLint binaries and dependencies in Pods/ folder during your next pod install execution.
Xcode configuration
SwiftLint can be integrated into your Xcode project to get warnings and errors displayed in the issue navigator. To enable this, click the Project in the file navigator, then click the primary app target, and go to Build Phases. Click the + and select "New Run Script Phase". Finally, add the following shell script:
if which swiftlint >/dev/null; then
swiftlint
else
echo "warning: SwiftLint not installed, download from https://github.com/realm/SwiftLint"
fi
Note: If you've installed SwiftLint via CocoaPods the script should look like this "${PODS_ROOT}/SwiftLint/swiftlint".
Rules
SwiftLint contains more than two hundred rules which are enforcing style and conventions for Swift programming language. Full list of SwiftLint rules can be found in Rule Directory.
Rules can be disabled or can be customized, by adjusting threshold for warnings and errors. This can be achieved using configuration file .swiftlint.yml or by disabling a rule directly in code.
Configuration file
Using .swiftlint.yml configuration file enables control over which rule is disabled/enabled and what thresholds are set for warnings and errors for a given rule. Also, it enables excluding some parts of your project, such as Pods, so SwiftLint won't check them. Configuration file needs to be manually created and added to project root directory.
Below is example of .swiftlint.yml configuration file that I personally use in SwiftUI projects.
excluded: # paths to ignore during linting
- Carthage
- Pods
- Source/ExcludedFolder
- Source/ExcludedFile.swift
disabled_rules: # rule identifiers turned on by default to exclude from running
- multiple_closures_with_trailing_closure
force_cast: warning # implicitly
force_try:
severity: warning # explicitly
file_length:
warning: 400
error: 700
type_name:
min_length: 2 # only warning
max_length: # warning and error
warning: 40
error: 50
identifier_name:
min_length: 2 # only warning
max_length: # warning and error
warning: 40
error: 50
excluded: # excluded via string array
- id
- URL
- GlobalAPIKey
This configuration file will tell SwiftLint to exclude folders from linting where project dependencies are stored. It also optimizes some rules to be easier to work with when writing Swift and SwiftUI code. Example, by disabling multiple_closures_with_trailing_closure rule.
Disabling rules in code
Rules can be disabled with a comment inside a source file with the following format: // swiftlint:disable <rule>. The rule will be disabled until the end of the file or until the linter sees a matching enable comment: // swiftlint:enable <rule>.
When writing SwiftUI code, disabling rules in code can come in handy when dealing with SwiftUI Previews which can sometimes lead to longer line length. In that case, line_length rule can be disabled with // swiftlint:disable line_length:
// swiftlint:disable line_length
struct SwiftUIView_Previews: PreviewProvider {
static var previews: some View {
... some long Swift code ...
}
}
Conclusion
Thank you for reading and I hope this article was useful to you! In conclusion, this article went over SwiftLint, introduction to it and how you can use it in your own projects.
If you like my content and find it useful, please consider following me. If you are feeling extra generous, please consider buying me a coffee.
Connect with me on LinkedIn.
References
This content originally appeared on DEV Community and was authored by Kevin Furjan
Kevin Furjan | Sciencx (2022-02-03T17:01:24+00:00) Enforce Swift style and conventions with SwiftLint. Retrieved from https://www.scien.cx/2022/02/03/enforce-swift-style-and-conventions-with-swiftlint/
Please log in to upload a file.
There are no updates yet.
Click the Upload button above to add an update.