summaryrefslogtreecommitdiff
path: root/doc/ale-swift.txt
blob: a443eab88f8300b705d6233acfdcd994960fc56f (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
===============================================================================
ALE Swift Integration                                       *ale-swift-options*


===============================================================================
apple-swift-format                               *ale-swift-apple-swift-format*

There are 3 options to enable linting and fixing with Apple's swift-format:

1. Install the local executable in your path, as described here:
   https://github.com/apple/swift-format
2. Install the executable via your OS package manager, for instance via
   Homebrew with `brew install swift-format`
3. Your Swift project has a dependency on the swift-format package, so it can
   be run with `swift run swift-format lint ...` In this case, you need to set
   a variable, see |g:ale_swift_appleswiftformat_use_swiftpm|.

Additionally, ALE tries to locate and use the nearest existing `.swift-format`
configuration file.


g:ale_swift_appleswiftformat_executable
                                      *g:ale_swift_appleswiftformat_executable*
                                      *b:ale_swift_appleswiftformat_executable*
  Type: |String|
  Default: `'swift-format'`

  This variable can be modified to change the executable path for
  `swift-format`.


g:ale_swift_appleswiftformat_use_swiftpm
                                     *g:ale_swift_appleswiftformat_use_swiftpm*
                                     *b:ale_swift_appleswiftformat_use_swiftpm*
  Type: |Number|
  Default: `0`

  When set to `1`, this option will cause ALE to use
  `swift run swift-format lint ...` instead of the global executable. Use this
  option if your Swift project has a dependency on the swift-format package.

  See |ale-integrations-local-executables|


===============================================================================
cspell                                                       *ale-swift-cspell*

See |ale-cspell-options|


===============================================================================
sourcekitlsp                                           *ale-swift-sourcekitlsp*

To enable the SourceKit-LSP you need to install and build the executable as
described here: https://github.com/apple/sourcekit-lsp#building-sourcekit-lsp


g:ale_sourcekit_lsp_executable                 *g:ale_sourcekit_lsp_executable*
                                               *b:ale_sourcekit_lsp_executable*
  Type: |String|
  Default: `'sourcekit-lsp'`

  See |ale-integrations-local-executables|


===============================================================================
  vim:tw=78:ts=2:sts=2:sw=2:ft=help:norl: