Merge pull request #2138 from ahoppen/ahoppen/macroexpansion-renames

Rename some properties on `FreestandingMacroExpansionSyntax`

Author: ahoppen

CodeGeneration/Sources/SyntaxSupport/Traits.swift

@@ -62,11 +62,11 @@ public let TRAITS: [Trait] = [
   Trait(
     traitName: "FreestandingMacroExpansion",
     children: [
-      Child(name: "poundToken", kind: .token(choices: [.token(.pound)])),
-      Child(name: "macro", kind: .token(choices: [.token(.identifier)])),
+      Child(name: "pound", deprecatedName: "poundToken", kind: .token(choices: [.token(.pound)])),
+      Child(name: "macroName", deprecatedName: "macro", kind: .token(choices: [.token(.identifier)])),
       Child(name: "genericArgumentClause", kind: .node(kind: .genericArgumentClause), isOptional: true),
       Child(name: "leftParen", kind: .token(choices: [.token(.leftParen)]), isOptional: true),
-      Child(name: "argumentList", kind: .node(kind: .labeledExprList)),
+      Child(name: "arguments", deprecatedName: "argumentList", kind: .node(kind: .labeledExprList)),
       Child(name: "rightParen", kind: .token(choices: [.token(.rightParen)]), isOptional: true),
       Child(name: "trailingClosure", kind: .node(kind: .closureExpr), isOptional: true),
       Child(name: "additionalTrailingClosures", kind: .node(kind: .multipleTrailingClosureElementList)),

Examples/Sources/ExamplePlugin/Macros.swift

@@ -11,7 +11,7 @@ struct EchoExpressionMacro: ExpressionMacro {
     of node: Node,
     in context: Context
   ) throws -> ExprSyntax {
-    let expr: ExprSyntax = node.argumentList.first!.expression
+    let expr: ExprSyntax = node.arguments.first!.expression
     return expr.with(\.leadingTrivia, [.blockComment("/* echo */")])
   }
 }
@@ -137,7 +137,7 @@ struct PrintAnyMacro: CodeItemMacro {
     of node: some FreestandingMacroExpansionSyntax,
     in context: some MacroExpansionContext
   ) throws -> [CodeBlockItemSyntax] {
-    guard let expr = node.argumentList.first?.expression else {
+    guard let expr = node.arguments.first?.expression else {
       return []
     }
     return ["print(\(expr))"]

Examples/Sources/MacroExamples/Implementation/AddBlocker.swift

@@ -101,6 +101,6 @@ public struct AddBlocker: ExpressionMacro {
       context.diagnose(diag)
     }
 
-    return result.asProtocol(FreestandingMacroExpansionSyntax.self)!.argumentList.first!.expression
+    return result.asProtocol(FreestandingMacroExpansionSyntax.self)!.arguments.first!.expression
   }
 }

Examples/Sources/MacroExamples/Implementation/FontLiteralMacro.swift

@@ -22,7 +22,7 @@ public struct FontLiteralMacro: ExpressionMacro {
     in context: some MacroExpansionContext
   ) -> ExprSyntax {
     let argList = replaceFirstLabel(
-      of: macro.argumentList,
+      of: macro.arguments,
       with: "fontLiteralName"
     )
     return ".init(\(argList))"

Examples/Sources/MacroExamples/Implementation/StringifyMacro.swift

@@ -28,7 +28,7 @@ public struct StringifyMacro: ExpressionMacro {
     of node: some FreestandingMacroExpansionSyntax,
     in context: some MacroExpansionContext
   ) -> ExprSyntax {
-    guard let argument = node.argumentList.first?.expression else {
+    guard let argument = node.arguments.first?.expression else {
       fatalError("compiler bug: the macro does not have any arguments")
     }
 

Examples/Sources/MacroExamples/Implementation/URLMacro.swift

@@ -22,7 +22,7 @@ public struct URLMacro: ExpressionMacro {
     in context: some MacroExpansionContext
   ) throws -> ExprSyntax {
 
-    guard let argument = node.argumentList.first?.expression,
+    guard let argument = node.arguments.first?.expression,
       let segments = argument.as(StringLiteralExprSyntax.self)?.segments,
       segments.count == 1,
       case .stringSegment(let literalSegment)? = segments.first

Examples/Sources/MacroExamples/Implementation/WarningMacro.swift

@@ -21,7 +21,7 @@ public struct WarningMacro: ExpressionMacro {
     of macro: some FreestandingMacroExpansionSyntax,
     in context: some MacroExpansionContext
   ) throws -> ExprSyntax {
-    guard let firstElement = macro.argumentList.first,
+    guard let firstElement = macro.arguments.first,
       let stringLiteral = firstElement.expression
         .as(StringLiteralExprSyntax.self),
       stringLiteral.segments.count == 1,

Sources/SwiftSyntax/SwiftSyntaxCompatibility.swift

@@ -51,6 +51,26 @@ public extension DeclGroupSyntax {
 }
 
 public extension FreestandingMacroExpansionSyntax {
+  @available(*, deprecated, renamed: "pound")
+  public var poundToken: TokenSyntax {
+    get {
+      return pound
+    }
+    set {
+      pound = newValue
+    }
+  }
+
+  @available(*, deprecated, renamed: "macroName")
+  public var macro: TokenSyntax {
+    get {
+      return macroName
+    }
+    set {
+      macroName = newValue
+    }
+  }
+
   @available(*, deprecated, renamed: "genericArgumentClause")
   var genericArguments: GenericArgumentClauseSyntax? {
     get {
@@ -60,6 +80,16 @@ public extension FreestandingMacroExpansionSyntax {
       genericArgumentClause = newValue
     }
   }
+
+  @available(*, deprecated, renamed: "arguments")
+  public var argumentList: LabeledExprListSyntax {
+    get {
+      return arguments
+    }
+    set {
+      arguments = newValue
+    }
+  }
 }
 
 extension GenericRequirementSyntax {

Sources/SwiftSyntax/generated/SyntaxTraits.swift

@@ -173,12 +173,12 @@ public extension SyntaxProtocol {
 
 
 public protocol FreestandingMacroExpansionSyntax: SyntaxProtocol {
-  var poundToken: TokenSyntax {
+  var pound: TokenSyntax {
     get
     set
   }
 
-  var macro: TokenSyntax {
+  var macroName: TokenSyntax {
     get
     set
   }
@@ -193,7 +193,7 @@ public protocol FreestandingMacroExpansionSyntax: SyntaxProtocol {
     set
   }
 
-  var argumentList: LabeledExprListSyntax {
+  var arguments: LabeledExprListSyntax {
     get
     set
   }

Sources/SwiftSyntaxMacroExpansion/MacroReplacement.swift

@@ -278,7 +278,7 @@ extension MacroDeclSyntax {
     replacements: [MacroDefinition.Replacement]
   ) -> ExprSyntax {
     return expand(
-      argumentList: node.argumentList,
+      argumentList: node.arguments,
       definition: definition,
       replacements: replacements
     )