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
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
|
//===--------------- OptionTable.swift - Swift Option Table ---------------===//
//
// This source file is part of the Swift.org open source project
//
// Copyright (c) 2014 - 2019 Apple Inc. and the Swift project authors
// Licensed under Apache License v2.0 with Runtime Library Exception
//
// See https://swift.org/LICENSE.txt for license information
// See https://swift.org/CONTRIBUTORS.txt for the list of Swift project authors
//
//===----------------------------------------------------------------------===//
public struct OptionTable {
public init() { }
/// Retrieve the options.
public var options: [Option] = Option.allOptions
public lazy var groupMap: [Option.Group: [Option]] = {
var map = [Option.Group: [Option]]()
for opt in options {
guard let group = opt.group else { continue }
map[group, default: []].append(opt)
}
return map
}()
}
extension OptionTable {
/// Print help information to the terminal.
public func printHelp(driverKind: DriverKind, includeHidden: Bool) {
print("""
OVERVIEW: Swift compiler
USAGE: \(driverKind.usage)
""")
let remainingOptions: [Option]
// In non-interactive mode, output all possible uses of the driver
if driverKind == DriverKind.batch {
print("""
MODES:
""")
let modeOptions = options.filter { $0.group == Option.Group.modes }
remainingOptions = options.filter { $0.group != Option.Group.modes }
OptionTable.printOptions(modeOptions, driverKind: driverKind, includeHidden: includeHidden)
// A newline space before printing remaining options
print("")
} else {
remainingOptions = options
}
print("""
OPTIONS:
""")
OptionTable.printOptions(remainingOptions, driverKind: driverKind, includeHidden: includeHidden)
}
static func printOptions(_ options: [Option], driverKind: DriverKind, includeHidden: Bool) {
for option in options {
if option.isAlias { continue }
if option.isHelpHidden && !includeHidden { continue }
guard option.isAccepted(by: driverKind) else { continue }
guard let helpText = option.helpText else { continue }
let maxDisplayNameLength = 23
// Figure out the display name, with metavariable if given
var displayName = option.spelling
switch option.kind {
case .input:
continue
case .flag:
break
case .joined, .commaJoined:
displayName += option.metaVar ?? "<value>"
case .separate, .remaining, .joinedOrSeparate, .multiArg:
displayName += " " + (option.metaVar ?? "<value>")
}
if displayName.count <= maxDisplayNameLength {
let rightPadding = String(
repeating: " ",
count: maxDisplayNameLength - displayName.count)
print(" \(displayName)\(rightPadding) \(helpText)")
} else {
print(" \(displayName)")
let leftPadding = String(
repeating: " ", count: maxDisplayNameLength)
print(" \(leftPadding) \(helpText)")
}
}
}
}
|
