All Versions
110
Latest Version
Avg Release Cycle
30 days
Latest Release
143 days ago

Changelog History
Page 8

  • v0.21.0 Changes

    💥 Breaking
    • 🏗 Xcode 8.3 or later and Swift 3.1 or later are required to build.
      Norio Nomura
    ✨ Enhancements

    • 💅 Rules are now categorized as lint, idiomatic, style, metrics or performance. Currently this is just used for documentation purposes when you run swiftlint rules or swiftlint generate-docs.
      Marcelo Fabri

    • ➕ Add [rules documentation](Rules.md) generation.
      Marcelo Fabri #1078

    • Add private_over_fileprivate correctable rule to check for top-level usages of fileprivate and recommend private instead. This is in line with SE-0169's goal "for fileprivate to be used rarely". There is a also a new strict_fileprivate opt-in rule that will mark every fileprivate as a violation (especially useful with Swift 4).
      Jose Cheyo Jimenez Marcelo Fabri #1469 #1058

    • Add let_var_whitespace opt-in rule to enforce that let/var declarations should be separated from other statements by a single blank line.
      Uncommon #1461

    • 👌 Improve performance when linting and correcting on Linux, matching macOS behavior.
      JP Simard #1577

    • Don't trigger implicit_getter violations when attributes (such as mutating or @inline) are present.
      Marcelo Fabri #1309 #1589

    • ➕ Add --use-tabs option to AutoCorrectOptions, enabling formatting using tabs over spaces.
      Cody Winton #1327

    • 👌 Improve autocorrect performance by running it in parallel.
      Marcelo Fabri #1578

    • 👌 Support building with Xcode 9 beta 3 in Swift 3.2 mode.
      JP Simard

    • ➕ Add support for optional error severity level configuration.
      Jamie Edge Marcelo Fabri #1647

    • Add unneeded_parentheses_in_closure_argument opt-in correctable rule that warns against using parentheses around argument declarations in closures.
      Marcelo Fabri #1483

    • ➕ Add --disabled flag to swiftlint rules to print only rules that are not enabled in the configuration.
      Marcelo Fabri

    • Add ignore_comment_only_lines boolean configuration option to file_length rule. With the option enabled, file_length will ignore lines which have only comments.
      Samuel Susla #1165

    • 👌 Improve file_header rule description.
      Marcelo Fabri #1492

    • ➕ Add trailing_closure opt-in rule that validates that trailing closure syntax should be used whenever possible.
      Marcelo Fabri #54

    • Shebang (#!) in the beginning of a file is now ignored by all rules.
      Marcelo Fabri #1294

    • Add block_based_kvo rule that enforces the usage of the new block based KVO API added when linting with Swift 3.2 or later.
      Marcelo Fabri #1714

    • 👉 Make file_header rule ignore doc comments.
      Marcelo Fabri #1719

    • 👍 Allow using environment variables in a configuration file in the form of ${SOME_VARIABLE}. The variables will be expanded when the configuration is first loaded.
      Marcelo Fabri #1512

    • Treat yes, no, on and off as strings (and not booleans) when loading configuration files.
      Marcelo Fabri #1424

    • Add discouraged_direct_init rule that discourages direct initialization of certain types.
      Ornithologist Coder #1306

    🐛 Bug Fixes

    • Fix false positive on redundant_discardable_let rule when using while statements.
      Marcelo Fabri #1669

    • 🛠 Fix all custom rules not being applied when any rule is configured incorrectly.
      Jamie Edge #1586

    • 🛠 Fix crash when using --config with a relative path and --path with a file.
      Marcelo Fabri #1694

    • 🛠 Fix mark rule corrections generating invalid code in some cases.
      Marcelo Fabri #1029

    • Fix false positive in empty_enum_arguments rule when using wildcards and where clauses.
      Marcelo Fabri #1722

    • 🛠 Fix false positive in large_tuple rule when using throwing closure.
      Liquidsoul

    • Make vertical_parameter_alignment more robust, fixing false positives and detecting previously missed violations.
      JP Simard #1488

  • v0.20.1 Changes

    💥 Breaking
    • None.
    ✨ Enhancements
    • None.
    🐛 Bug Fixes

    • 🛠 Fix typo in FatalErrorMessageRule.
      Alexander Lash

    • Don't trigger an extension_access_modifier violation when all extension members are open, as open extension is not supported by Swift.
      Marcelo Fabri #1629

    • Don't trigger a vertical_parameter_alignment_on_call violation when trailing closures are used.
      Marcelo Fabri #1635

    • Make vertical_parameter_alignment_on_call more flexible when multiline parameters are used.
      Marcelo Fabri #1630 #1643

    • 👕 Use the directory's .swiftlint.yml when --path is used.
      Marcelo Fabri #1631

  • v0.20.0 Changes

    💥 Breaking
    • None.
    ✨ Enhancements

    • Detect more violations of force_unwrapping when using subscripts.
      Otávio Lima

    • Match (Void) as return type in the void_return rule.
      Anders Hasselqvist

    • ➕ Add multiline_parameters opt-in rule that warns to either keep all the parameters of a method or function on the same line, or one per line.
      Ornithologist Coder

    • Update function_parameter_count rule to ignore overridden methods.
      Markus Gasser #1562

    • Skip files with valid cache & no violations when auto correcting.
      Marcelo Fabri #1554

    • Don't trigger violations from the private_unit_test rule when a method has parameters.
      Marcelo Fabri #1532

    • Don't trigger violations from the discarded_notification_center_observer rule when the observer is being returned from a function that is not marked as @discardableResult.
      Marcelo Fabri #1525

    • Add extension_access_modifier opt-in rule validating that if all the declarations in a given extension have the same Access Control Level, the ACL keyword should be applied to the top-level extension.
      Marcelo Fabri #1546

    • Add vertical_parameter_alignment_on_call opt-in rule that validates that parameters are vertically aligned on a method call.
      Marcelo Fabri #1037

    • Add code_literal and image_literal boolean configuration options to object_literal rule. They allow to only check for one or the other literal type instead of both together.
      Cihat Gündüz #1587

    🐛 Bug Fixes

    • Fix false positive in empty_enum_arguments rule when calling methods.
      Marcelo Fabri #1597

    • Fix crash in unused_closure_parameter rule when using unicode identifiers.
      Woo-Sik Byun Marcelo Fabri

    • 🛠 Fix two false positives in force_unwrapping rule.
      Otávio Lima #614 #977 #1614

    • 🛠 Fix custom rules not working correctly with comment commands.
      JP Simard #1558

    • 🛠 Fix incorrectly using configuration files named .swiftlint.yml when they are located in the same directory as a differently-named, user-provided custom configuration file.
      JP Simard #1531

    • 🛠 Fix empty_count rule false positive in words that include "count".
      Marcelo Fabri #1622

    • Use validates_start_with_lowercase key when decoding configurations for generic_type_name, identifier_name and type_name rules. This key was used on the docs, but internally validates_start_lowercase was used.
      Marcelo Fabri #1626

  • v0.19.0 Changes

    💥 Breaking

    • ✂ Remove support for Swift 2.
      Marcelo Fabri #1453

    • 📄 Remove missing_docs and valid_docs rules since they were already disabled.
      Marcelo Fabri #1453

    • ➕ Add modificationDate(forFileAtPath:) function requirement to LintableFileManager protocol.
      Victor Pimentel

    • 👕 Several breaking changes to LinterCache.
      Victor Pimentel JP Simard

    • ✂ Remove Configuration.hash property.
      Victor Pimentel

    • 📇 Rename ConditionalReturnsOnNewline struct to ConditionalReturnsOnNewlineRule to match rule naming conventions.
      JP Simard

    ✨ Enhancements

    • 👕 Cache linter results for files unmodified since the previous linter run.
      Victor Pimentel JP Simard Marcelo Fabri #1184 #1550

    • Add opt-in configurations to generic_type_name, identifier_name and type_name rules to allow excluding non-alphanumeric characters and names that start with uppercase.
      Javier Hernández #541

    • ➕ Adds support for excluded in custom rules to exclude files.
      Nigel Flack #1437

    • 👉 Make trailing_comma rule autocorrectable.
      Samuel Susla Jeremy David Giesbrecht #1326

    • Added no_extension_access_modifier opt-in rule to disallow access modifiers completely, à la SE-0119.
      Jose Cheyo Jimenez #1457

    • ➕ Add lowercase and missing colon checks to the mark rule.
      Jason Moore

    • Improve violation reason wording in function_body_length, large_type, and type_body_length rules.   ultimatedbz

    • Add explicit_top_level_acl opt-in rule that validates that all top level declarations should explicitly be marked with an Access Control Level (private, fileprivate, internal, public or open).
      J. Cheyo Jimenez Marcelo Fabri #58

    • ➕ Add implicit_return opt-in rule that warns against using the return keyword when it can be omitted inside closures.
      Marcelo Fabri #1194

    • Add option to unused_optional_binding rule to ignore try? in guard statements.
      Sega-Zero #1432

    • Add empty_enum_arguments correctable rule that warns against using silent associated values inside a case.
      Marcelo Fabri #1425 #1549

    • ✂ Remove file.zip from the Pods directory when installing SwiftLint via CocoaPods.
      Hesham Salman #1507

    • Add protocol_property_accessors_order correctable rule that validates that the order of accessors is get set when declaring variables in protocols.
      Marcelo Fabri #1504

    • 👉 Make Region & Command structs conform to Equatable.
      JP Simard

    • 👉 Make closure_spacing a CorrectableRule.
      J. Cheyo Jimenez

    🐛 Bug Fixes

    • 💅 emoji and checkstyle reporter output report sorted by file name.
      norio-nomura #1429

    • Prevent false positive in shorthand_operator rule.
      sammy-SC #1254

    • 🛠 Fix typo in DiscardedNotificationCenterObserverRule.
      Spencer Kaiser

    • 🛠 Fix empty_parameters rule with Swift 3.
      Marcelo Fabri #1460

    • Prevent triggering redundant_optional_initialization rule on a lazy var since it needs initialization.
      Marcelo Fabri #1334

    • Fix ignores_case_statements key in cyclomatic_complexity description.
      Jeff Blagdon #1434

    • Fall back to reporting violations on line 1 if no line was provided for the violation's location, ensuring Xcode always displays the warning or error.
      rjhodge JP Simard #1520

    • 🛠 Fix crash or incorrect violation location with strings including multi-byte unicode characters.
      Marcelo Fabri #1006

    • 🛠 Fix false positive in syntactic_sugar rule when using nested types named Optional, ImplicitlyUnwrappedOptional, Array or Dictionary.
      Marcelo Fabri #1508

    • Fix false positives in prohibited_super_call & overridden_super_call rules where calls to super were done in nested scopes such as defer blocks.
      JP Simard #1301

    • 🛠 Fix non-root configurations logging configuration warnings more than once.
      JP Simard #949

    • 🛠 Fix some overlapping // swiftlint commands not being applied.
      JP Simard #1388

  • v0.18.1 Changes

    💥 Breaking
    • None.
    ✨ Enhancements
    • None.
    🐛 Bug Fixes
    • 🚀 Compile releases in the 'Release' configuration rather than 'Debug'.

  • v0.18.0 Changes

    💥 Breaking

    • 👕 Replace YamlSwift with Yams. SwiftLint no longer includes YamlSwift. If your project implicitly depends on YamlSwift, you need to modify it to depend on YamlSwift explicitly.
      norio-nomura #1412

    • Yams interprets YAML more strictly than YamlSwift, so if your YAML configurations previously worked with SwiftLint but didn't fully conform to the YAML 1.2 standard, you'll need to fix those validation errors. For example:

      custom_rules:
wrong_regex:
  name: "wrong regex"
  regex: "((assert|precondition)\(false)" # '\' in "" means escape sequence
strict_regex:
  name: "strict regex"
  regex: '((assert|precondition)\(false)' # Use single quotes
    ✨ Enhancements

    • 👌 Support compiling with Xcode 8.3 and Swift 3.1.
      Keith Smiley

    • 🛠 Fix false positives on for_where rule and skip violation on complex conditions.
      Marcelo Fabri #1387

    • 🔧 Print YAML configuration errors in locatable format compatible with Xcode's Issue Navigator.

    🐛 Bug Fixes

  • v0.17.0 Changes

    💥 Breaking

    • variable_name rule (VariableNameRule) is now identifier_name (IdentifierNameRule) as it validates other identifiers as well.
      Marcelo Fabri #663

    • 🛠 Fix sorted_imports rule to sort ignoring case.
      Keith Smiley #1185

    • 👕 Temporarily disable cache when linting. This will be re-enabled in a future version after important cache-related issues have been addressed.
      Marcelo Fabri

    ✨ Enhancements

    • Add implicitly_unwrapped_optional opt-in rule that warns against using implicitly unwrapped optionals, except cases when this IUO is an IBOutlet.
      Siarhei Fedartsou #56

    • Performance improvements to generic_type_name, redundant_nil_coalescing, mark, first_where and vertical_whitespace rules.
      Marcelo Fabri

    • Add discarded_notification_center_observer rule that warns when the result of NotificationCenter.addObserver(forName:object:queue:using:) is not stored so it can be removed later.
      Marcelo Fabri #1062

    • Add notification_center_detachment rule that warns against an object removing itself from NotificationCenter in an unsafe location.
      Marcelo Fabri #1061

    • Accept AnyObject and NSObjectProtocol in class_delegate_protocol.
      Jon Shier #1261

    • Add ignores_function_declarations and ignores_comments as options to LineLengthRule.
      Michael L. Welles #598 #975

    • ➕ Add for_where rule that validates that where is used in a for loop instead of a single if expression inside the loop.
      Marcelo Fabri #1228

    • unused_enumerated rule now warns when only the index is being used. You should use .indices instead of .enumerated() in this case.
      Marcelo Fabri #1278

    • Add ignores_case_statements as option to CyclomaticComplexityRule.
      Michael L. Welles #1298

    • Add correctable redundant_discardable_let rule that warns when let _ = foo() is used to discard a result from a function instead of _ = foo().
      Marcelo Fabri #1232

    • Accept global and local variables in implicit_getter rule.
      Marcelo Fabri

    • ➕ Add --enabled (or -e) switch to the rules CLI command, to only display enabled rules.
      Natan Rolnik #1270

    • 🔧 Now nesting rule can be configured with a type and statement level.
      Hayashi Tatsuya #1318

    • Add explicit_type_interface opt-in rule that validates that the properties have an explicit type interface.
      Kim de Vos

    • ➕ Add --lenient CLI option to lint command. Facilitates running a lint task that doesn't fail a pipeline of other tasks.
      aaroncrespo #1322

    • Add fatal_error_message opt-in rule that validates that fatalError() calls have a message.
      Kim de Vos #1348

    🐛 Bug Fixes

    • 🛠 Fix crashes when accessing cached regular expressions when linting in parallel.
      JP Simard #1344

    • 🛠 Fix a false positive on large_tuple rule when using closures.
      Marcelo Fabri #1234

    • 🛠 Fix force_unwrap false positive for bool negation.
      Aaron McTavish #918

    • 🛠 Fix false positive and wrong correction on number_separator rule.
      Marcelo Fabri #1242

    • Retain closure parameter types when they are specified during autocorrect.
      Allen Zeng #1175

    • Fix redundant_void_return matches if return type starts with Void~.
      Hayashi Tatsuya

    • Ignore unused_closure_parameter rule on closures that are called inline.
      Marcelo Fabri #1161

    • 📄 Disable valid_docs and missing_docs rules when running in Swift 2.3 or later as they have not been updated to work with those versions of Swift. Both rules are now opt-in because of this.
      JP Simard #728

    • 🛠 Fix false positive on large_tuple rule when using generics inside a tuple.
      Marcelo Fabri #1257

    • 0️⃣ Make ASTRule default implementation to navigate through the substructure even if its children are from a different kind. This fixes some violations not being reported in some contexts.
      Marcelo Fabri #1237

    • Reimplement switch_case_on_newline rule to be an ASTRule and be more reliable, fixing some false negatives and false positives.
      Marcelo Fabri #1268

    • Fix closure_end_indentation rule false positive when using single-line closures.
      Marcelo Fabri #1216

    • 🛠 Fix todo rule messages when the comment is not on a new line.
      Marcelo Fabri #1304

    • Fix false negative on unused_closure_parameter rule.
      Hayashi Tatsuya

    • 🛠 Fix checkstyle report format.
      Yuki Oya

  • v0.16.1 Changes

    💥 Breaking
    • None.
    ✨ Enhancements
    🐛 Bug Fixes

    • 🛠 Fix false positives on shorthand_operator rule.
      Marcelo Fabri #1156 #1163

    • Fix false positive on redundant_optional_initialization rule.
      Marcelo Fabri #1159

    • Fix false positive on operator_usage_whitespace rule with decimal literals in exponent format.
      Marcelo Fabri #1153

    • 🛠 Fix excluded configuration not excluding files.
      Marcelo Fabri #1166

    • Disable commutative operations on shorthand_operator rule.
      Marcelo Fabri #1182 #1183 #1211

    • 🛠 Fix crash when running in a Sandboxed environment, which also fixes Homebrew distribution. Set the SWIFTLINT_SWIFT_VERSION environment variable to either 2 or 3 to force that operation mode, bypassing the Swift version determined from SourceKit.
      JP Simard

  • v0.16.0 Changes

    💥 Breaking
    • Several API breaking changes were made to conform to the Swift 3 API Design Guidelines. We apologize for any inconvenience this may have caused.
    ✨ Enhancements

    • 👕 Speed up linting by caching linter results across invocations.
      Marcelo Fabri #868

    • 👕 Speed up linting by processing multiple files and rules concurrently.
      JP Simard #1077

    • 👕 Make many operations in SwiftLintFramework safe to call in multithreaded scenarios, including accessing Linter.styleViolations.
      JP Simard #1077

    • Permit unsigned and explicitly-sized integer types in valid_ibinspectable
      Daniel Duan

    • 👉 Make nimble_operator rule correctable.
      Vojta Stavik

    • Add vertical_parameter_alignment rule that checks if parameters are vertically aligned for multi-line function declarations.
      Marcelo Fabri #1033

    • ➕ Add more helpful reason strings to TrailingCommaRule.
      Matt Rubin

    • Add class_delegate_protocol rule that warns against protocol declarations that aren't marked as : class or @objc.
      Marcelo Fabri #1039

    • Add correctable redundant_optional_initialization rule that warns against initializing optional variables with nil.
      Marcelo Fabri #1052

    • redundant_nil_coalescing rule is now correctable.
      Marcelo Fabri

    • 👉 Make number_separator rule correctable.
      Marcelo Fabri

    • empty_parentheses_with_trailing_closure rule is now correctable.
      Marcelo Fabri

    • Add correctable redundant_void_return rule that warns against explicitly adding -> Void to functions.
      Marcelo Fabri #1066

    • ➕ Add an opt-in rule that enforces alphabetical sorting of imports.
      Scott Berrevoets #900

    • type_name rule forces enum values to be UpperCamelCase again when used with Swift 2.3.
      Marcelo Fabri #1090

    • 👉 Make weak_delegate rule ignore computed properties.
      Rafael Machado #1089

    • ➕ Add object_literal opt-in rule that warns against using image and color inits that can be replaced for #imageLiteral or #colorLiteral in Swift 3.
      Marcelo Fabri #1060

    • 🔧 Now number_separator rule can be configured with a minimum length.
      Marcelo Fabri #1109

    • Add compiler_protocol_init rule that flags usage of initializers declared in protocols used by the compiler such as ExpressibleByArrayLiteral that shouldn't be called directly. Instead, you should use a literal anywhere a concrete type conforming to the protocol is expected by the context.
      Marcelo Fabri #1096

    • ➕ Add large_tuple configurable rule that validates that tuples shouldn't have too many members.
      Marcelo Fabri #1065

    • Add generic_type_name rule that validates generic constraint type names.
      Marcelo Fabri #51

    • ⚡️ Update vertical_whitespace rule to allow configuration of the number of consecutive empty lines before a violation using max_empty_lines. The default value is still 1 line.
      Aaron McTavish #769

    • Add check to ignore urls in line_length rule when ignores_urls configuration is enabled.
      Javier Hernández #384

    • ➕ Add shorthand_operator rule that validates that shorthand operators should be used when possible.
      Marcelo Fabri #902

    • 👍 Allow specifying a swiftlint_version configuration key which will log a warning if the current running version of SwiftLint is different than this value.
      JP Simard #221

    • ➕ Add internal support for deprecated rule aliases.
      Marcelo Fabri #973

    • Add unused_optional_binding rule that will check for optional bindings not being used.
      Rafael Machado #1116

    🐛 Bug Fixes

    • Ignore close parentheses on vertical_parameter_alignment rule.
      Marcelo Fabri #1042

    • 🛠 syntactic_sugar rule now doesn't flag declarations that can't be fixed.
      Marcelo Fabri #928

    • Fix false positives on closure_parameter_position and unused_closure_parameter rules with Swift 2.3.
      Marcelo Fabri #1019

    • 🛠 Fix crash on trailing_comma rule with Swift 2.3.
      Marcelo Fabri #921

    • 🛠 Fix out of range exception in AttributesRule.
      JP Simard #1105

    • Fix variable_name and type_name rules on Linux.
      Marcelo Fabri

    • 🛠 Fix linting directories with names ending with .swift.
      JP Simard

    • 🛠 Fix running swiftlint version when building with Swift Package Manager.
      Marcelo Fabri #1045

    • Fix false positive on vertical_parameter_alignment rule when breaking line in a default parameter declaration.
      Marcelo Fabri #1129

  • v0.15.0 Changes

    💥 Breaking
    ✨ Enhancements
    • Add closure_end_indentation opt-in rule that validates closure closing braces according to these rules:
      • If the method call has chained breaking lines on each method (. is on a new line), the closing brace should be vertically aligned with the ..
      • Otherwise, the closing brace should be vertically aligned with the beginning of the statement in the first line.

    Marcelo Fabri #326

    • operator_usage_whitespace rule is now correctable.
      Marcelo Fabri

    • 🐎 implicit_getter and mark rule performance improvements.
      Marcelo Fabri

    • HTML reports now display a relative path to files.
      Jamie Edge

    • colon rule now validates colon position in dictionaries too. You can disable this new validation with the apply_to_dictionaries configuration.
      Marcelo Fabri #603

    • ➕ Add first_where opt-in rule that warns against using .filter { /* ... */ }.first in collections, as .first(where: { /* ... */ }) is often more efficient.
      Marcelo Fabri #1005

    🐛 Bug Fixes