// // Arguments.swift // SwiftFormat // // Created by Nick Lockwood on 07/08/2018. // Copyright © 2018 Nick Lockwood. // // Distributed under the permissive MIT license // Get the latest version from here: // // https://github.com/nicklockwood/SwiftFormat // // Permission is hereby granted, free of charge, to any person obtaining a copy // of this software and associated documentation files (the "Software"), to deal // in the Software without restriction, including without limitation the rights // to use, copy, modify, merge, publish, distribute, sublicense, and/or sell // copies of the Software, and to permit persons to whom the Software is // furnished to do so, subject to the following conditions: // // The above copyright notice and this permission notice shall be included in all // copies or substantial portions of the Software. // // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR // IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, // FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE // AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER // LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, // OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE // SOFTWARE. // import Foundation extension Options { static let maxArgumentNameLength = 16 init(_ args: [String: String], in directory: String) throws { fileOptions = try fileOptionsFor(args, in: directory) formatOptions = try formatOptionsFor(args) let lint = args.keys.contains("lint") self.lint = lint rules = try rulesFor(args, lint: lint) } mutating func addArguments(_ args: [String: String], in directory: String) throws { let oldArguments = argumentsFor(self) let newArguments = try mergeArguments(args, into: oldArguments) var newOptions = try Options(newArguments, in: directory) if let fileInfo = formatOptions?.fileInfo { newOptions.formatOptions?.fileInfo = fileInfo } self = newOptions } } // Parse a space-delimited string into an array of command-line arguments // Replicates the behavior implemented by the console when parsing input func parseArguments(_ argumentString: String, ignoreComments: Bool = true) -> [String] { var arguments = [""] // Arguments always begin with script path var characters = String.UnicodeScalarView.SubSequence(argumentString.unicodeScalars) var string = "" var escaped = false var quoted = false loop: while let char = characters.popFirst() { switch char { case "#" where !ignoreComments && !escaped && !quoted: break loop // comment case "\\" where !escaped: escaped = true case "\"" where !escaped && !quoted: quoted = true case "\"" where !escaped && quoted: quoted = false fallthrough case " " where !escaped && !quoted: if !string.isEmpty { arguments.append(string) } string.removeAll() case "\"" where escaped: escaped = false string.append("\"") case _ where escaped && quoted: string.append("\\") fallthrough default: escaped = false string.append(Character(char)) } } if !string.isEmpty { arguments.append(string) } return arguments } // Parse a flat array of command-line arguments into a dictionary of flags and values func preprocessArguments(_ args: [String], _ names: [String]) throws -> [String: String] { var anonymousArgs = 0 var namedArgs: [String: String] = [:] var name = "" for arg in args { if arg.hasPrefix("--") { // Long argument names let key = String(arg.unicodeScalars.dropFirst(2)) guard names.contains(key) else { guard let match = bestMatches(for: key, in: names).first else { throw FormatError.options("Unknown option --\(key)") } throw FormatError.options("Unknown option --\(key). Did you mean --\(match)?") } name = key namedArgs[name] = namedArgs[name] ?? "" continue } else if arg.hasPrefix("-") { // Short argument names let flag = String(arg.unicodeScalars.dropFirst()) guard let match = names.first(where: { $0.hasPrefix(flag) }) else { throw FormatError.options("Unknown flag -\(flag)") } name = match namedArgs[name] = namedArgs[name] ?? "" continue } if name == "" { // Argument is anonymous name = String(anonymousArgs) anonymousArgs += 1 } var arg = arg let hasTrailingComma = arg.hasSuffix(",") && arg != "," if hasTrailingComma { arg = String(arg.dropLast()) } if let existing = namedArgs[name], !existing.isEmpty, // TODO: find a more general way to represent merge-able options ["exclude", "unexclude", "disable", "enable", "lintonly", "rules"].contains(name) || Descriptors.all.contains(where: { $0.argumentName == name && $0.isSetType }) { namedArgs[name] = existing + "," + arg } else { namedArgs[name] = arg } if !hasTrailingComma { name = "" } } return namedArgs } // Find best match for a given string in a list of options func bestMatches(for query: String, in options: [String]) -> [String] { let lowercaseQuery = query.lowercased() // Sort matches by Levenshtein edit distance return options .compactMap { option -> (String, distance: Int, commonPrefix: Int)? in let lowercaseOption = option.lowercased() let distance = editDistance(lowercaseOption, lowercaseQuery) let commonPrefix = lowercaseOption.commonPrefix(with: lowercaseQuery) if commonPrefix.isEmpty, distance > lowercaseQuery.count / 2 { return nil } return (option, distance, commonPrefix.count) } .sorted { if $0.distance == $1.distance { return $0.commonPrefix > $1.commonPrefix } return $0.distance < $1.distance } .map { $0.0 } } /// The Damerau-Levenshtein edit-distance between two strings func editDistance(_ lhs: String, _ rhs: String) -> Int { let lhs = Array(lhs) let rhs = Array(rhs) var dist = [[Int]]() for i in 0 ... lhs.count { dist.append([i]) } for j in 1 ... rhs.count { dist[0].append(j) } for i in 1 ... lhs.count { for j in 1 ... rhs.count { if lhs[i - 1] == rhs[j - 1] { dist[i].append(dist[i - 1][j - 1]) } else { dist[i].append(min(dist[i - 1][j] + 1, dist[i][j - 1] + 1, dist[i - 1][j - 1] + 1)) } if i > 1, j > 1, lhs[i - 1] == rhs[j - 2], lhs[i - 2] == rhs[j - 1] { dist[i][j] = min(dist[i][j], dist[i - 2][j - 2] + 1) } } } return dist[lhs.count][rhs.count] } // Parse a comma-delimited list of items func parseCommaDelimitedList(_ string: String) -> [String] { return string.components(separatedBy: ",").compactMap { let item = $0.trimmingCharacters(in: .whitespacesAndNewlines) return item.isEmpty ? nil : item } } // Parse a comma-delimited string into an array of rules let allRules = Set(FormatRules.byName.keys) func parseRules(_ rules: String) throws -> [String] { return try parseCommaDelimitedList(rules).map { proposedName in if let name = allRules.first(where: { $0.lowercased() == proposedName.lowercased() }) { return name } if Descriptors.all.contains(where: { $0.argumentName == proposedName }) { for rule in FormatRules.all where rule.options.contains(proposedName) { throw FormatError.options( "'\(proposedName)' is not a formatting rule. Did you mean '\(rule.name)'?" ) } throw FormatError.options("'\(proposedName)' is not a formatting rule") } guard let match = bestMatches(for: proposedName, in: Array(allRules)).first else { throw FormatError.options("Unknown rule '\(proposedName)'") } throw FormatError.options("Unknown rule '\(proposedName)'. Did you mean '\(match)'?") } } // Parse single file path, disallowing globs or commas func parsePath(_ path: String, for argument: String, in directory: String) throws -> URL { let expandedPath = expandPath(path, in: directory) if !FileManager.default.fileExists(atPath: expandedPath.path) { if path.contains(",") { throw FormatError.options("\(argument) argument does not support multiple paths") } if pathContainsGlobSyntax(path) { throw FormatError.options("\(argument) path cannot contain wildcards") } } return expandedPath } // Parse one or more comma-delimited file paths, expanding globs as required func parsePaths(_ paths: String, in directory: String) throws -> [URL] { return try matchGlobs(expandGlobs(paths, in: directory), in: directory) } // Merge two dictionaries of arguments func mergeArguments(_ args: [String: String], into config: [String: String]) throws -> [String: String] { var input = config var output = args // Merge excluded urls if let exclude = output["exclude"].map(parseCommaDelimitedList), var excluded = input["exclude"].map({ Set(parseCommaDelimitedList($0)) }) { excluded.formUnion(exclude) output["exclude"] = Array(excluded).sorted().joined(separator: ",") } // Merge unexcluded urls if let unexclude = output["unexclude"].map(parseCommaDelimitedList), var unexcluded = input["unexclude"].map({ Set(parseCommaDelimitedList($0)) }) { unexcluded.formUnion(unexclude) output["unexclude"] = Array(unexcluded).sorted().joined(separator: ",") } // Merge rules if let rules = try output["rules"].map(parseRules) { if rules.isEmpty { output["rules"] = nil } else { input["rules"] = nil input["enable"] = nil input["disable"] = nil input["lintonly"] = nil } } else { if let _disable = try output["disable"].map(parseRules) { if let rules = try input["rules"].map(parseRules) { input["rules"] = Set(rules).subtracting(_disable).sorted().joined(separator: ",") } if let enable = try input["enable"].map(parseRules) { input["enable"] = Set(enable).subtracting(_disable).sorted().joined(separator: ",") } if let lintonly = try input["lintonly"].map(parseRules) { input["lintonly"] = Set(lintonly).subtracting(_disable).sorted().joined(separator: ",") } if let disable = try input["disable"].map(parseRules) { input["disable"] = Set(disable).union(_disable).sorted().joined(separator: ",") output["disable"] = nil } } if let _enable = try output["enable"].map(parseRules) { if let enable = try input["enable"].map(parseRules) { input["enable"] = Set(enable).union(_enable).sorted().joined(separator: ",") output["enable"] = nil } if let lintonly = try input["lintonly"].map(parseRules) { input["lintonly"] = Set(lintonly).subtracting(_enable).sorted().joined(separator: ",") } if let disable = try input["disable"].map(parseRules) { input["disable"] = Set(disable).subtracting(_enable).sorted().joined(separator: ",") } } if let _lintonly = try output["lintonly"].map(parseRules) { if let lintonly = try input["lintonly"].map(parseRules) { input["lintonly"] = Set(lintonly).union(_lintonly).sorted().joined(separator: ",") output["lintonly"] = nil } } } // Merge other arguments for (key, inValue) in input { guard let outValue = output[key] else { output[key] = inValue continue } if Descriptors.all.contains(where: { $0.argumentName == key && $0.isSetType }) { let inOptions = parseCommaDelimitedList(inValue) let outOptions = parseCommaDelimitedList(outValue) output[key] = Set(inOptions).union(outOptions).sorted().joined(separator: ",") } } return output } // Parse a configuration file into a dictionary of arguments public func parseConfigFile(_ data: Data) throws -> [String: String] { guard let input = String(data: data, encoding: .utf8) else { throw FormatError.reading("Unable to read data for configuration file") } let lines = try cumulate(successiveLines: input.components(separatedBy: .newlines)) let arguments = try lines.flatMap { line -> [String] in // TODO: parseArguments isn't a perfect fit here - should we use a different approach? let line = line.replacingOccurrences(of: "\\n", with: "\n") let parts = parseArguments(line, ignoreComments: false).dropFirst().map { $0.replacingOccurrences(of: "\n", with: "\\n") } guard let key = parts.first else { return [] } if !key.hasPrefix("-") { throw FormatError.options("Unknown option '\(key)' in configuration file") } return [key, parts.dropFirst().joined(separator: " ")] } do { return try preprocessArguments(arguments, optionsArguments) } catch let FormatError.options(message) { throw FormatError.options("\(message) in configuration file") } } private func cumulate(successiveLines: [String]) throws -> [String] { var cumulatedLines = [String]() var iterator = successiveLines.makeIterator() while let currentLine = iterator.next() { var cumulatedLine = effectiveContent(of: currentLine) while cumulatedLine.hasSuffix("\\") { guard let nextLine = iterator.next() else { throw FormatError.reading("Configuration file ends with an illegal line continuation character '\'") } if !nextLine.trimmingCharacters(in: .whitespaces).starts(with: "#") { cumulatedLine = cumulatedLine.dropLast() + effectiveContent(of: nextLine) } } cumulatedLines.append(String(cumulatedLine)) } return cumulatedLines } private func effectiveContent(of line: String) -> String { return line .prefix { $0 != "#" } .trimmingCharacters(in: .whitespaces) } // Serialize a set of options into either an arguments string or a file func serialize(options: Options, swiftVersion: Version = .undefined, excludingDefaults: Bool = false, separator: String = "\n") -> String { var arguments = [[String: String]]() if let fileOptions = options.fileOptions { arguments.append(argumentsFor( Options(fileOptions: fileOptions), excludingDefaults: excludingDefaults )) } if let formatOptions = options.formatOptions { arguments.append(argumentsFor( Options(formatOptions: formatOptions), excludingDefaults: excludingDefaults )) } else if swiftVersion != .undefined { let descriptor = Descriptors.swiftVersion arguments.append([descriptor.argumentName: swiftVersion.rawValue]) } if let rules = options.rules { arguments.append(argumentsFor( Options(rules: rules), excludingDefaults: excludingDefaults )) } return arguments .map { serialize(arguments: $0, separator: separator) } .filter { !$0.isEmpty } .joined(separator: separator) } // Serialize arguments func serialize(arguments: [String: String], separator: String = "\n") -> String { return arguments.map { var value = $1 if value.contains(" ") { value = "\"\(value.replacingOccurrences(of: "\"", with: "\\\""))\"" } return "--\($0) \(value)" }.sorted().joined(separator: separator) } // Get command line arguments from options func argumentsFor(_ options: Options, excludingDefaults: Bool = false) -> [String: String] { var args = [String: String]() if let fileOptions = options.fileOptions { var arguments = Set(fileArguments) do { if !excludingDefaults || fileOptions.followSymlinks != FileOptions.default.followSymlinks { args["symlinks"] = fileOptions.followSymlinks ? "follow" : "ignore" } arguments.remove("symlinks") } do { if !fileOptions.excludedGlobs.isEmpty { // TODO: find a better alternative to stringifying url args["exclude"] = fileOptions.excludedGlobs.map { $0.description }.sorted().joined(separator: ",") } arguments.remove("exclude") } do { if !fileOptions.unexcludedGlobs.isEmpty { // TODO: find a better alternative to stringifying url args["unexclude"] = fileOptions.unexcludedGlobs.map { $0.description }.sorted().joined(separator: ",") } arguments.remove("unexclude") } do { if !excludingDefaults || fileOptions.minVersion != FileOptions.default.minVersion { args["minversion"] = fileOptions.minVersion.description } arguments.remove("minversion") } assert(arguments.isEmpty) } if let formatOptions = options.formatOptions { for descriptor in Descriptors.all where !descriptor.isRenamed { let value = descriptor.fromOptions(formatOptions) guard value != descriptor.fromOptions(.default) || (!excludingDefaults && !descriptor.isDeprecated) else { continue } // Special case for swiftVersion // TODO: find a better solution for this if descriptor.argumentName == Descriptors.swiftVersion.argumentName, value == Version.undefined.rawValue { continue } args[descriptor.argumentName] = value } // Special case for wrapParameters let argumentName = Descriptors.wrapParameters.argumentName if args[argumentName] == WrapMode.default.rawValue { args[argumentName] = args[Descriptors.wrapArguments.argumentName] } } if options.lint { args["lint"] = "" } if let rules = options.rules { let defaultRules = allRules.subtracting(FormatRules.disabledByDefault) let enabled = rules.subtracting(defaultRules) if !enabled.isEmpty { args["enable"] = enabled.sorted().joined(separator: ",") } let disabled = defaultRules.subtracting(rules) if !disabled.isEmpty { args["disable"] = disabled.sorted().joined(separator: ",") } } return args } private func processOption(_ key: String, in args: [String: String], from: inout Set, handler: (String) throws -> Void) throws { precondition(optionsArguments.contains(key), "\(key) not in optionsArguments") var arguments = from arguments.remove(key) from = arguments guard let value = args[key] else { return } do { try handler(value) } catch { guard !value.isEmpty else { throw FormatError.options("--\(key) option expects a value") } if case var FormatError.options(string) = error, !string.isEmpty { if !string.contains(key) { string += " in --\(key)" } throw FormatError.options(string) } throw FormatError.options("Unsupported --\(key) value '\(value)'") } } // Parse rule names from arguments public func rulesFor(_ args: [String: String], lint: Bool) throws -> Set { var rules = allRules rules = try args["rules"].map { try Set(parseRules($0)) } ?? rules.subtracting(FormatRules.disabledByDefault) try args["enable"].map { try rules.formUnion(parseRules($0)) } try args["disable"].map { try rules.subtract(parseRules($0)) } try args["lintonly"].map { rulesString in if lint { try rules.formUnion(parseRules(rulesString)) } else { try rules.subtract(parseRules(rulesString)) } } return rules } // Parse FileOptions from arguments func fileOptionsFor(_ args: [String: String], in directory: String) throws -> FileOptions? { var options = FileOptions() var arguments = Set(fileArguments) var containsFileOption = false try processOption("symlinks", in: args, from: &arguments) { containsFileOption = true switch $0.lowercased() { case "follow": options.followSymlinks = true case "ignore": options.followSymlinks = false default: throw FormatError.options("") } } try processOption("exclude", in: args, from: &arguments) { containsFileOption = true options.excludedGlobs += expandGlobs($0, in: directory) } try processOption("unexclude", in: args, from: &arguments) { containsFileOption = true options.unexcludedGlobs += expandGlobs($0, in: directory) } try processOption("minversion", in: args, from: &arguments) { containsFileOption = true guard let minVersion = Version(rawValue: $0) else { throw FormatError.options("Unsupported --minversion value '\($0)'") } guard minVersion <= Version(stringLiteral: swiftFormatVersion) else { throw FormatError.options("Project specifies SwiftFormat --minversion of \(minVersion)") } options.minVersion = minVersion } assert(arguments.isEmpty, "\(arguments.joined(separator: ","))") return containsFileOption ? options : nil } // Parse FormatOptions from arguments // Returns nil if the arguments dictionary does not contain any formatting arguments public func formatOptionsFor(_ args: [String: String]) throws -> FormatOptions? { var options = FormatOptions.default var arguments = Set(formattingArguments) var containsFormatOption = false for option in Descriptors.all { try processOption(option.argumentName, in: args, from: &arguments) { containsFormatOption = true try option.toOptions($0, &options) } } assert(arguments.isEmpty, "\(arguments.joined(separator: ","))") return containsFormatOption ? options : nil } // Get deprecation warnings from a set of arguments func warningsForArguments(_ args: [String: String]) -> [String] { var warnings = [String]() for option in Descriptors.all { if args[option.argumentName] != nil, let message = option.deprecationMessage { warnings.append("--\(option.argumentName) option is deprecated. \(message)") } } for name in Set(rulesArguments.flatMap { (try? args[$0].map(parseRules) ?? []) ?? [] }) { if let message = FormatRules.byName[name]?.deprecationMessage { warnings.append("\(name) rule is deprecated. \(message)") } } if let rules = try? rulesFor(args, lint: true) { for arg in args.keys where formattingArguments.contains(arg) { if !rules.contains(where: { guard let rule = FormatRules.byName[$0] else { return false } return rule.options.contains(arg) || rule.sharedOptions.contains(arg) }) { let expected = FormatRules.all.first(where: { $0.options.contains(arg) })?.name ?? "associated" warnings.append("--\(arg) option has no effect when \(expected) rule is disabled") } } } return warnings } let fileArguments = [ "symlinks", "exclude", "unexclude", "minversion", ] let rulesArguments = [ "disable", "enable", "lintonly", "rules", ] let formattingArguments = Descriptors.formatting.map { $0.argumentName } let internalArguments = Descriptors.internal.map { $0.argumentName } let optionsArguments = fileArguments + rulesArguments + formattingArguments + internalArguments let commandLineArguments = [ // Input options "filelist", "stdinpath", "config", "inferoptions", "linerange", "output", "cache", "dryrun", "lint", "lenient", "verbose", "quiet", "report", // Misc "help", "version", "options", "ruleinfo", ] + optionsArguments let deprecatedArguments = Descriptors.all.compactMap { $0.isDeprecated ? $0.argumentName : nil } protocol Foo { func foo() func bar() } // something class FooImpl: Foo { }