Swift lint


Notes on swift lint

Swift-lint

  1. install swift-lint via swiftlint.pkg (give access in prefs/security): https://github.com/realm/SwiftLint/releases

  2. Add .swiftlint.yml to your xcode project folder. (asjecent to the .xproj file)
  3. Add swift-lint script to your xcodeproject:
    • XCode 👉 Build phases
    • Click “plus-button” 👉 Add “run script”
    • Paste in the bellow:
if which swiftlint >/dev/null; then
  swiftlint
else
  echo "warning: SwiftLint not installed, download from https://github.com/realm/SwiftLint"
fi
  1. Disable script sandboxing here: Build Setting -> Build Options -> User Script Sandboxing,Set "No" or you will get an error. ref: https://github.com/mac-cain13/R.swift/issues/855

  2. Build cmd + b the project to see some swift-lint warnings

  3. Add a swift-lint badge to your github project:
    SwiftLint Eonist
    [![Swift-lint Eonist](https://img.shields.io/badge/swift--lint-eonist-purple.svg)](https://github.com/eonist/Swift-lint)

  4. ✨ Don’t forget the terminal auto correct feature Terminal: swiftlint autocorrect now renamed to: swiftlint fix in your project path. And it auto corrects the entire project ✨ ⚠️️Remember to commit before you auto correct the project. swiftlint lint first to assert what will be changed. Before autocorrecting it can be smart to commit current state. and go through commits and assert that everything is good. It can also be a good idea to make sure the package or xcodeproj builds and runs all tests etc

Notes:

you can ignore or disable swift lint inline (copy the arg name like: empty_enum_arguments fro the warning):

// swiftlint:disable empty_enum_arguments
(100,         30, 3),
(10000,       30, 333),
(1000000,     30, 33333),
(100000000,   60, 1666666),
(10000000000, 90, 111111111),
// swiftlint:enable empty_enum_arguments

// swiftlint:disable empty_enum_arguments
// swiftlint:enable empty_enum_arguments

// swiftlint:disable all
// swiftlint:enable all

Exclude folders from linting:

excluded:
- Pods
- UnitTests/generated/GeneratedMocks.swift

Add swift lint to Packages

https://stackoverflow.com/questions/57461737/how-to-integrate-swiftlint-with-an-ios-app-using-swift-package-manager

Terminal commands

swiftlint autocorrect // apply lint corrections (⚠️️ this is now `swiftlint --fix`)
swiftlint lint // shows lint errors

Steps

  1. Make sure package builds
  2. Make sure build artifacts are cleared, so we dont lint them
  3. Run lint
  4. Then autocorrect
  5. Then run unit-test
  6. The commit to github

swift style guides:

Errors:

SwiftLint: Fatal error: Loading sourcekitdInProc.framework/Versions/A/sourcekitdInProc failed Trace/BPT trap: 5

Ensure that your Xcode Command Line Tools are properly set up:

  • Open Xcode
  • Go to Preferences > Locations
  • Make sure the Command Line Tools dropdown is set to your current Xcode version
  • Sometimes you just need to select the already selected xcode version. to trigger that something is selected.