0.22.0: Syntax Tree Ornament

Breaking

• SourceKitten now requires Swift 4.2 or higher to build.
  JP Simard

Enhancements

• Add Request.syntaxTree to get a serialized representation of the file's
  SwiftSyntax tree.
  JP Simard

Bug Fixes

• Fix crash in NSString.location(fromByteOffset:) when using unicode
  characters.
  JP Simard
  realm/SwiftLint#2276

0.21.3: Baby Lynx

This is the last release to support building with Swift 4.0 and Swift 4.1.

Breaking

• None.

Enhancements

• If New Build System is enabled on Xcode, the doc command does not need to
  use the clean action on xcodebuild.
  Norio Nomura

• Use 'as' bridging on Linux when using Swift 4.2.
  JP Simard

Bug Fixes

• None.

0.21.2: Fel d 1

Breaking

• None.

Enhancements

• Add support for C-language annotations
  (e.g. __attribute__((annotate("This is an annotation")))).
  Jeff Verkoeyen

• Improve support for building & running with Swift 4.2.
  Norio Nomura

• Add new values for SwiftDeclarationAttributeKind and SyntaxKind with
  Swift 4.2.
  JP Simard

Bug Fixes

• None.

0.21.1

Breaking

• None.

Enhancements

• None.

Bug Fixes

• Support building with Swift 4.2. There are still runtime issues to resolve.
  Norio Nomura

• Fix a crash when running with Swift 4.2.
  Norio Nomura
  SR-7954

0.21.0: Sylvester J. Pussycat Sr.

Breaking

• SourceKitten now requires Swift 4.0 or higher to build.
  JP Simard

Enhancements

• Make all SwiftDeclarationAttributeKind cases available no matter
  which version of Swift was used to compile SourceKitten.
  Marcelo Fabri

Bug Fixes

• Fix issue locating libsourcekitdInProc.so on some Linux distributions.
  Mike Hovan
  #513

0.20.0: Captain Whiskers

This is the last release to support Swift 3.2 and Swift 3.3.
The next release will require Swift 4.0 or higher.

Breaking

• Change type of parameter from sourcekitd_object_t to SourceKitObject?.

  • File.process(dictionary:cursorInfoRequest:syntaxMap:)
  • Request.customRequest(request:)
  • SwiftDocs.init(file:dictionary:cursorInfoRequest:)
    Norio Nomura

• Remove File.lines:setter.
  Norio Nomura

Enhancements

• Add SwiftDeclarationAttributeKind that represents declaration attributes in
  Swift.
  Daniel Metzing
  #504

• Add SourceKitObject that represents sourcekitd_object_t in Swift.
  Norio Nomura
  #489

• Replaced linear index search with binary search in NSString extension.
  Tamas Lustyik

• SourceKit search strategy improved on Linux. Supports swiftenv.
  Alexander Lash

• Add elements case to SwiftDocKey.
  Sho Ikeda

• Added module_info command to sourcekitten CLI.
  Erik Abair

Bug Fixes

• Fix index command fails using filename with spaces in compiler arguments.
  Norio Nomura
  #480

• Only allow U+000A and U+000D as line break tokens.
  Marcelo Fabri
  #475

• Fix ThreadSanitizer reports data race warning in SwiftLint.
  Norio Nomura
  realm/SwiftLint#2089

0.19.1: Commanding Meow

Breaking

• None.

Enhancements

• None.

Bug Fixes

• Fix Swift Package Manager warnings when using SourceKitten targets as
  dependencies.
  JP Simard
  #478

0.19.0: Implicitly Unwrapped Cat Fur

Breaking

• SourceKitten now requires Xcode 9 and Swift 3.2+ to build.
  Norio Nomura

• Deprecated Request.failableSend(). Please use Request.send() instead.
  Norio Nomura

• Some APIs changed to throws.

  • File.format(trimmingTrailingWhitespace:useTabs:indentWidth:) throws
  • Structure.init(file:) throws
  • SyntaxMap.init(file:) throws
    Norio Nomura

Enhancements

• Return SWIFT_NAME when generating Objective-C docs.
  Ibrahim Ulukaya

Bug Fixes

• Fix Swift declarations when generating Objective-C docs for generic types.
  John Fairhurst

0.18.4: Le Chat

Breaking

• None.

Enhancements

• None.

Bug Fixes

• Fix Swift 4.0.2 deprecation warnings in dependencies, specifically
  SWXMLHash.
  Norio Nomura

0.18.3: Felis Catus

Breaking

• None.

Enhancements

• Support Swift 4.0.2.
  Norio Nomura
  #435

Bug Fixes

• Preserve horizontal alignment in multi-line Swift declarations.
  John Fairhurst