การทดสอบและแก้จุดบกพร่องมาโคร

เหตุใดจึงต้องทดสอบมาโคร

// The swift-syntax package ships SwiftSyntaxMacrosTestSupport
// with assertMacroExpansion for testing macro output

assertMacroExpansion

import SwiftSyntaxMacrosTestSupport
import XCTest

final class StringifyMacroTests: XCTestCase {
  func testStringify() throws {
    assertMacroExpansion(
      "#stringify(1 + 2)",
      expandedSource: "(1 + 2, \"1 + 2\")",
      macros: ["stringify": StringifyMacro.self]
    )
  }
}

การทดสอบมาโครแบบแนบ

assertMacroExpansion(
  "@AddID struct User { var name: String }",
  expandedSource: """
  struct User {
    var name: String
    var id = UUID()
  }
  """,
  macros: ["AddID": AddIDMacro.self]
)

การทดสอบการส่งข้อความวินิจฉัย

assertMacroExpansion(
  "@AddID class Foo {}",
  expandedSource: "class Foo {}",
  diagnostics: [
    DiagnosticSpec(message: "@AddID can only be applied to structs", line: 1, column: 1)
  ],
  macros: ["AddID": AddIDMacro.self]
)

การขยายมาโครใน Xcode

// Before expansion:
let (v, s) = #stringify(1 + 2)
// After:
let (v, s) = (1 + 2, "1 + 2")

การแก้จุดบกพร่องด้วย print ในมาโคร

// In macro implementation:
print("[StringifyMacro] expanding: \(node.description)", to: &standardError)

จุดหยุดการทำงานในการทดสอบมาโคร

// Set a breakpoint in StringifyMacro.expansion()
// Run the test target — breakpoints are hit

การตรวจสอบต้นไม้ไวยากรณ์

print(node.debugDescription)
// Prints the full SyntaxTree hierarchy

การทดสอบรูปแบบอาร์กิวเมนต์หลายแบบ

func testNoArgument() {
  assertMacroExpansion(
    "#stringify()",
    expandedSource: "#stringify()",
    diagnostics: [DiagnosticSpec(message: "Need an argument", line: 1, column: 1)],
    macros: ["stringify": StringifyMacro.self]
  )
}

การทดสอบการทำงานร่วมกัน

// In test app:
let (val, src) = #stringify(Date.now)
XCTAssertEqual(src, "Date.now")

การผสานรวมอย่างต่อเนื่องสำหรับการทดสอบมาโคร

// CI command:
swift test --package-path MyMacros

ตรวจสอบความเข้าใจ

ทบทวนบทเรียน