اختبار الماكروهات وتصحيحها

لماذا نختبر الماكروات؟

// 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

اختبار سريع

مراجعة الدرس