File: SyntaxTraitsFile.swift

package info (click to toggle)
swiftlang 6.0.3-2
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 2,519,992 kB
  • sloc: cpp: 9,107,863; ansic: 2,040,022; asm: 1,135,751; python: 296,500; objc: 82,456; f90: 60,502; lisp: 34,951; pascal: 19,946; sh: 18,133; perl: 7,482; ml: 4,937; javascript: 4,117; makefile: 3,840; awk: 3,535; xml: 914; fortran: 619; cs: 573; ruby: 573
file content (87 lines) | stat: -rw-r--r-- 2,984 bytes parent folder | download
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: ", ")) {}"
    )
  }
}