swiftlang/swift-package-manager

Update macro template to support Swift Testing tests

Open

#8.890 aberto em 2 de jul. de 2025

Ver no GitHub
 (1 comment) (0 reactions) (0 assignees)Swift (1.462 forks)batch import
enhancementgood first issueswift package init

Métricas do repositório

Stars
 (10.145 stars)
Métricas de merge de PR
 (Mesclagem média 9d 13h) (90 fundiu PRs em 30d)

Description

According to the SwiftPM code base, we are unable to use Swift Testing to verify macros. However, the referenced GitHub issue (https://github.com/swiftlang/swift-syntax/issues/2400) is closed.

The Swift Syntax 600 release notes mentions SwiftSyntaxMacrosGenericTestSupport.

Here is a snippet of the relevant Swift Syntax release notes

SwiftSyntaxMacrosGenericTestSupport

  • Description: A version of the SwiftSyntaxMacrosTestSupport module that doesn't depend on Foundation or XCTest and can thus be used to write macro tests using swift-testing. Since swift-syntax can't depend on swift-testing (which would incur a circular dependency since swift-testing depends on swift-syntax), users need to manually specify a failure handler like the following, that fails the swift-testing test: Issue.record("\($0.message)", fileID: $0.location.fileID, filePath: $0.location.filePath, line: $0.location.line, column: $0.location.column)
  • Pull request: https://github.com/swiftlang/swift-syntax/pull/2647

The SwiftPM template for swift package init --type macro should be update to provide an idiomatic way to write a Swift Testing test to verify and validate a macro.

Guia do colaborador

Direção de pesquisa
Comece examinando o modelo de macro atual em `Sources/Workspace/InitPackage.swift` nas linhas 119-122. Revise as notas de lançamento do Swift Syntax 600 e o PR vinculado #2647 para entender o módulo `SwiftSyntaxMacrosGenericTestSupport` e o manipulador de falhas necessário. Em seguida, atualize o modelo para incluir um exemplo simples de teste de macro usando swift testing, seguindo o padrão mostrado nas notas de lançamento.
Pilha de tecnologia
swift
Domain
clideveloper experience
Tipo Issue
Funcionalidade
DifficultyDificuldade de implementação estimada para um novo contribuidor, de 1 para alterações muito pequenas a 5 para trabalho de nível especializado.
3
Tempo estimadoUm intervalo de tempo aproximado para um colaborador experiente investigar, implementar, testar e preparar um pull request.
Meio dia
Status da atividadeQuão disponível o issue aparece agora: novo, ativo, obsoleto, bloqueado ou aguardando entrada do mantenedor.
Ativo
ClarityCom que clareza o issue explica a mudança esperada, os critérios de aceitação e a próxima etapa.
Claro
Prerequisites
Swift
Simpatia para novatosUma pontuação de 1 a 100 que estima o quão acessível este issue é para colaboradores iniciantes.
65