When an Swift enumeration has associated values, its cases can't be referenced as code. It would be so nice to reference the names of cases, even when an associated value isn't known.
This macro creates an ID enum, to refer to each case. In addition, it also creates a computed variable id so that the identifier of each case is easily available.
In my past projects, I've typed this up by manually each time. But now with Swift Macros, it's easy! The Swift enumeration just needs an annotation, and identifiers for each case will be created!
import IdentifiedEnumCases
@IdentifiedEnumCases
enum Nightshade {
case potato(PotatoVariety), tomato(TomatoVariety)
case chili(ChiliVariety)
enum PotatoVariety: CaseIterable {
case russet, yukonGold, kennebec
}
enum TomatoVariety: CaseIterable {
case roma, heirloom, cherry
}
enum ChiliVariety: CaseIterable {
case jalapeño, arbol, habenero
}
}then in code we can directly refer to the ID of the case.
let romaTomato = Nightshade.tomato(.roma)
XCTAssertEquals(romaTomato.id, .tomato)because the macro generates to
enum Nightshade {
case potato(PotatoVariety), tomato(TomatoVariety)
case chili(ChiliVariety)
enum PotatoVariety: CaseIterable {
case russet, yukonGold, kennebec
}
enum TomatoVariety: CaseIterable {
case roma, heirloom, cherry
}
enum ChiliVariety: CaseIterable {
case jalapeño, arbol, habenero
}
var caseID: CaseID {
switch self {
case .potato: .potato
case .tomato: .tomato
case .chili: .chili
}
}
enum CaseID: String, Hashable, CaseIterable {
case potato, tomato, jalapeño
}
}Very exciting!
If the enum is public, the generated CaseID enum and the
generated caseID accessor will also be public. For example,
import IdentifiedEnumCases
@IdentifiedEnumCases
public enum AppRoute {
case item(ItemRoute)
case user(UserRoute)
}generates to
public enum AppRoute {
case item(ItemRoute)
case user(UserRoute)
public var caseID: CaseID {
switch self {
case .item: .item
case .user: .user
}
public enum CaseID: String, Hashable, CaseIterable {
case item
case user
}
}In Package.swift, add the package to your dependencies.
.package(url: "https://github.com/FullQueueDeveloper/IdentifiedEnumCases.git", from: "1.0.0"),
And add "IdentifiedEnumCases" to the list of your target's dependencies.
When prompted by Xcode, trust the macro.
Introduced at WWDC '23, requiring Swift 5.9