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
|
//===----------------------------------------------------------------------===//
//
// This source file is part of the Swift.org open source project
//
// Copyright (c) 2014 - 2023 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
//
//===----------------------------------------------------------------------===//
import SwiftSyntax
import SwiftSyntaxBuilder
import SyntaxSupport
import Utils
let syntaxTraitsFile = SourceFileSyntax(leadingTrivia: copyrightHeader) {
for trait in TRAITS {
try! ProtocolDeclSyntax(
"""
// MARK: - \(trait.protocolName)
\(trait.documentation)\
public protocol \(trait.protocolName): SyntaxProtocol\(raw:
trait.baseKind == nil ? "" : ", \(trait.baseKind!.protocolType)"
)
"""
) {
for child in trait.children {
let questionMark = child.isOptional ? "?" : ""
DeclSyntax(
"""
\(child.documentation)\
\(child.apiAttributes)var \(child.varOrCaseName): \(child.syntaxNodeKind.syntaxType)\(raw: questionMark) { get set }
"""
)
}
}
try! ExtensionDeclSyntax("extension \(trait.protocolName)") {
DeclSyntax(
"""
/// Without this function, the `with` function defined on `SyntaxProtocol`
/// does not work on existentials of this protocol type.
@_disfavoredOverload
public func with<T>(_ keyPath: WritableKeyPath<\(trait.protocolName), T>, _ newChild: T) -> \(trait.protocolName) {
var copy: \(trait.protocolName) = self
copy[keyPath: keyPath] = newChild
return copy
}
"""
)
}
try! ExtensionDeclSyntax("extension SyntaxProtocol") {
DeclSyntax(
"""
/// Check whether the non-type erased version of this syntax node conforms to
/// `\(trait.protocolName)`.
/// Note that this will incur an existential conversion.
public func isProtocol(_: \(trait.protocolName).Protocol) -> Bool {
return self.asProtocol(\(trait.protocolName).self) != nil
}
"""
)
DeclSyntax(
"""
/// Return the non-type erased version of this syntax node if it conforms to
/// `\(trait.protocolName)`. Otherwise return `nil`.
/// Note that this will incur an existential conversion.
public func asProtocol(_: \(trait.protocolName).Protocol) -> \(trait.protocolName)? {
return Syntax(self).asProtocol(SyntaxProtocol.self) as? \(trait.protocolName)
}
"""
)
}
}
for node in SYNTAX_NODES.compactMap(\.layoutNode) where !node.traits.isEmpty {
DeclSyntax(
"extension \(node.kind.syntaxType): \(raw: node.traits.map { $0 + "Syntax" }.joined(separator: ", ")) {}"
)
}
}
|