Major-mode for Apple's Swift programming language.
Install swift-mode package from MELPA.
To install without MELPA, download latest release and execute M-x package-install-file for the .tar archive.
Font Lock
Indentation
switch foo {
case let .P1(x)
where
x > 0,
let .P2(x)
where
x > 0:
bar()
.then { x in
return baz(x)
}
.then {(
x,
y
) in
return moo(x + y)
}
}
// Hanging brace
let x = [
1,
2,
3
]
// Brace on its own line
let y =
[
1,
2,
3
]
// Utrecht style
let z =
[ 1
, 2
, 3
]forward-sexp
beginning-of-defun, end-of-defun, mark-defun, and narrow-to-defun.
beginning-of-sentence, end-of-sentence, kill-sentence, backward-kill-sentence, mark-sentence, and narrow-to-sentence. A sentence is a statement outside comments or strings, or an ordinal sentence inside comments or strings.
indent-new-comment-line
Running Swift REPL in a buffer (M-x run-swift)
Build Swift module (M-x swift-mode:build-swift-module)
Build iOS app (M-x swift-mode:build-ios-app)
Running debugger on Swift module (M-x swift-mode:debug-swift-module)
Running debugger on iOS app in simulator or device (M-x swift-mode:debug-ios-app) (ios-deploy is required to debug on device).
This package does not provide flycheck. See flycheck-swift.
Some syntax constructs removed from Swift 3.0 are not supported:
C-style for-loop: for var i = 1; i < 10; i++ { }
Multiple assignments in single if let:
Use multiple let instead:
if let x = x,
let y = y {
}Indentation may not accurate. For example, foo(Bar < A, B > (c)) can be indented like either
foo(Bar < A,
B > (c)) // Passing two Boolean arguments to foo
or
foo(Bar < A,
B > (c)) // Passing a new Bar with two type arguments and a value
The Swift compiler disambiguates this case using tokens after >, but those tokens may not available at editing time. We use some heuristic for this.
Another example is difficulty of handling of colons. We have to pair all ? and : of conditional operators to decide indentation of the below snippet. This is a future work.
switch foo {
case let P(x) where x is Foo? ? a ? b : c ?? d : e ? f : g :
h ? i?.j() : k()
}
switch foo {
case let P(x) where (x is Foo?) ? (a ? b : c ?? d) : (e ? f : g) :
h ? i?.j() : k()
}
Yet another difficult case is consistency of blocks. We want to indent method chains like this:
var x = foo
.then { x in
aaa
}
.then { x in
aaa
}
while we also want to indent the body of if like this:
if anotherVeryLongVariableName
.veryLongPropertyName {
aaa
}
That is, we have to indent the closing brace with offset if it is a part of expressions while it should be aligned with the beginning of the statement/declaration if it is a part of a statement/declaration.
Then, how should we indent the following code when the cursor is before @?
This could be
var x = foo
.bar {
@abc willSet {
aaa
}
}
// property declaration
or
var x = foo
.bar {
@abc var x = 1
x
}
// property initialization
Both are syntactically correct code. We cannot handle this case properly. This is also a future work.
Other example is regex literals and custom operators. The following example is valid Swift code with regex literals and custom operators.
We parse them as regex literals rather than custom operators for now.
To build the package locally, run make package.
To install the built package, run make install.
To run tests, run make test.
For other commands, run make help.
swift format command).Yes, please do! See CONTRIBUTING for guidelines.
The REPL code is based on js-comint.
Thanks to the following original developer and users for their contributions:
You can find a full list of those people here.
Thanks to @purcell (Steve Purcell) for advices on the code and arrangement for merging swift3-mode and swift-mode.
GPLv3. See COPYING for details. Copyright (C) 2014-2021 taku0, Chris Barrett, Bozhidar Batsov, Arthur Evstifeev.
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4