매크로 테스트와 디버깅

매크로를 테스트하는 이유

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

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

빠른 확인

수업 요약