Swift Next

Swift syntax package in async/await era

[!IMPORTANT] This is the fork of the Swift-Next repository that appears to have been deprecated for some time. The purpose of it's twofold: to serve as the source of the package for the ST package control tool and to provide a space for community contribution. All of the incredible work on this project (with the exception of a few minor bug fixes) was done by @aerobounce. If you are able to contact him, please do so to allow him to take ownership of this organization. It is unfair that he stopped just before reaching the finish line in his long journey of success.

Features

• Swift 5.6 support
  • Older Swift versions (deprecated or retired syntax) are not supported, and not in plan.
• Supports Documentation Comment Syntax
• Supports MARK: TODO: FIXME:
• Xcode-style Symbol List
• Compatible with the new regex engine of Sublime Text

Status

• [ ] Finish visual test against all the swift files in apple/swift repository
  • [x] swift-5.6-RELEASE/benchmark
  • [x] swift-5.6-RELEASE/libswift
• [ ] Resolve TODOs left in files
• [ ] Squash corner cases that scope goes wrong
• [ ] Remove commented matches left for debugging purpose
• [ ] Add tests
• [ ] Add build system (if cross-platform is possible?)
• [ ] Support swift-5.7-RELEASE
• [x] Better documentation markup support

Install

Package Control

1. Install the Sublime Text Package Control plugin if you haven't done this before.
2. Open the command palette and type Package Control: Install Package.
3. Type OpenAI and press Enter.

Manually

1. Download this repository
2. Move extracted directory into: Sublime Text → Preferences → Browse Packages… → “User” directory

Development

Editing Environment

• Sublime Text 4
• PackageDev
• SublimeLinter-contrib-sublime-syntax
• LSP-yaml
• LSP-json
• Formatted with LSP-yaml and LSP-json

Tips

Minimize multiple words into a regex pattern

$ grex --no-anchors --capture-groups ...

References

If you are to create a syntax definition file for the first time without deep regex background like me, here's everything you need.

Sublime Text

• Sublime Text — Syntax Definitions
• Sublime Text — Scope Naming
• Sublime Text Community Documentation
• sublimehq/Packages
• sublimehq/Packages — Syntax Development Tips/Advice #757

Regular Expression

• regex101
• Oniguruma syntax (operator) configuration

Swift

• apple/swift
• The Swift Programming Language
• Swift Standard Library
• .swiftinterface files in: /Library/Developer/CommandLineTools/SDKs/MacOSX.sdk/usr/lib/swift
• DougGregor/swift-concurrency-objc
• textmate/swift.tmbundle
• wbond/swift-for-sublime (floating-point-literal and string-literal are modified version of this package 🙏)
• GregoryBL/SwiftSyntax

Other Fundamental Packages for Swift

• LSP-SourceKit
• Swift Format

License

• MIT