import Foundation import SourceKittenFramework /// A rule configuration used for defining custom rules in yaml. public struct RegexConfiguration: SeverityBasedRuleConfiguration, Hashable, CacheDescriptionProvider, InlinableOptionType { /// The identifier for this custom rule. public let identifier: String /// The name for this custom rule. public var name: String? /// The message to be presented when producing violations. public var message = "Regex matched" /// The regular expression to apply to trigger violations for this custom rule. @ConfigurationElement(key: "regex") var regex: RegularExpression! // swiftlint:disable:this implicitly_unwrapped_optional /// Regular expressions to include when matching the file path. public var included: [NSRegularExpression] = [] /// Regular expressions to exclude when matching the file path. public var excluded: [NSRegularExpression] = [] /// The syntax kinds to exclude from matches. If the regex matched syntax kinds from this list, it would /// be ignored and not count as a rule violation. public var excludedMatchKinds = Set() @ConfigurationElement(key: "severity") public var severityConfiguration = SeverityConfiguration(.warning) /// The index of the regex capture group to match. public var captureGroup = 0 public var cacheDescription: String { let jsonObject: [String] = [ identifier, name ?? "", message, regex.pattern, included.map(\.pattern).joined(separator: ","), excluded.map(\.pattern).joined(separator: ","), SyntaxKind.allKinds.subtracting(excludedMatchKinds) .map({ $0.rawValue }).sorted(by: <).joined(separator: ","), severity.rawValue ] if let jsonData = try? JSONSerialization.data(withJSONObject: jsonObject) { return String(decoding: jsonData, as: UTF8.self) } queuedFatalError("Could not serialize regex configuration for cache") } /// The `RuleDescription` for the custom rule defined here. public var description: RuleDescription { return RuleDescription(identifier: identifier, name: name ?? identifier, description: "", kind: .style) } /// Create a `RegexConfiguration` with the specified identifier, with other properties to be set later. /// /// - parameter identifier: The rule identifier to use. public init(identifier: String) { self.identifier = identifier } public mutating func apply(configuration: Any) throws { guard let configurationDict = configuration as? [String: Any], let regexString = configurationDict[$regex.key] as? String else { throw Issue.invalidConfiguration(ruleID: Parent.description.identifier) } regex = try RegularExpression(pattern: regexString) if let includedString = configurationDict["included"] as? String { included = [try .cached(pattern: includedString)] } else if let includedArray = configurationDict["included"] as? [String] { included = try includedArray.map { pattern in try .cached(pattern: pattern) } } if let excludedString = configurationDict["excluded"] as? String { excluded = [try .cached(pattern: excludedString)] } else if let excludedArray = configurationDict["excluded"] as? [String] { excluded = try excludedArray.map { pattern in try .cached(pattern: pattern) } } if let name = configurationDict["name"] as? String { self.name = name } if let message = configurationDict["message"] as? String { self.message = message } if let severityString = configurationDict[$severityConfiguration.key] as? String { try severityConfiguration.apply(configuration: severityString) } if let captureGroup = configurationDict["capture_group"] as? Int { guard (0 ... regex.numberOfCaptureGroups).contains(captureGroup) else { throw Issue.invalidConfiguration(ruleID: Parent.description.identifier) } self.captureGroup = captureGroup } self.excludedMatchKinds = try self.excludedMatchKinds(from: configurationDict) } public func hash(into hasher: inout Hasher) { hasher.combine(identifier) } func shouldValidate(filePath: String) -> Bool { let pathRange = filePath.fullNSRange let isIncluded = included.isEmpty || included.contains { regex in regex.firstMatch(in: filePath, range: pathRange) != nil } guard isIncluded else { return false } return excluded.allSatisfy { regex in regex.firstMatch(in: filePath, range: pathRange) == nil } } private func excludedMatchKinds(from configurationDict: [String: Any]) throws -> Set { let matchKinds = [String].array(of: configurationDict["match_kinds"]) let excludedMatchKinds = [String].array(of: configurationDict["excluded_match_kinds"]) switch (matchKinds, excludedMatchKinds) { case (.some(let matchKinds), nil): return SyntaxKind.allKinds.subtracting(try toSyntaxKinds(matchKinds)) case (nil, .some(let excludedMatchKinds)): return try toSyntaxKinds(excludedMatchKinds) case (nil, nil): return .init() case (.some, .some): throw Issue.genericWarning( "The configuration keys 'match_kinds' and 'excluded_match_kinds' cannot appear at the same time." ) } } private func toSyntaxKinds(_ names: [String]) throws -> Set { let kinds = try names.map { if let kind = SyntaxKind(shortName: $0) { return kind } throw Issue.invalidConfiguration(ruleID: Parent.description.identifier) } return Set(kinds) } }