Initial commit

Author: fruitcoder

.swiftpm/xcode/package.xcworkspace/contents.xcworkspacedata

@@ -0,0 +1,52 @@
+// swift-tools-version: 5.9
+// The swift-tools-version declares the minimum version of Swift required to build this package.
+
+import PackageDescription
+import CompilerPluginSupport
+
+let package = Package(
+  name: "ExtractCaseValue",
+  platforms: [.macOS(.v10_15), .iOS(.v13), .tvOS(.v13), .watchOS(.v6), .macCatalyst(.v13)],
+  products: [
+    // Products define the executables and libraries a package produces, making them visible to other packages.
+    .library(
+      name: "ExtractCaseValue",
+      targets: ["ExtractCaseValue"]
+    ),
+    .executable(
+      name: "ExtractCaseValueClient",
+      targets: ["ExtractCaseValueClient"]
+    ),
+  ],
+  dependencies: [
+    // Depend on the latest Swift 5.9 prerelease of SwiftSyntax
+    .package(url: "https://github.com/apple/swift-syntax.git", from: "509.0.0-swift-5.9-DEVELOPMENT-SNAPSHOT-2023-04-25-b"),
+  ],
+  targets: [
+    // Targets are the basic building blocks of a package, defining a module or a test suite.
+    // Targets can depend on other targets in this package and products from dependencies.
+    // Macro implementation that performs the source transformation of a macro.
+    .macro(
+      name: "ExtractCaseValueMacros",
+      dependencies: [
+        .product(name: "SwiftSyntaxMacros", package: "swift-syntax"),
+        .product(name: "SwiftCompilerPlugin", package: "swift-syntax")
+      ]
+    ),
+
+    // Library that exposes a macro as part of its API, which is used in client programs.
+    .target(name: "ExtractCaseValue", dependencies: ["ExtractCaseValueMacros"]),
+
+    // A client of the library, which is able to use the macro in its own code.
+    .executableTarget(name: "ExtractCaseValueClient", dependencies: ["ExtractCaseValue"]),
+
+    // A test target used to develop the macro implementation.
+    .testTarget(
+      name: "ExtractCaseValueTests",
+      dependencies: [
+        "ExtractCaseValueMacros",
+        .product(name: "SwiftSyntaxMacrosTestSupport", package: "swift-syntax"),
+      ]
+    ),
+  ]
+)

Package.resolved

@@ -0,0 +1,43 @@
+# ExtractCaseValue
+
+The `ExtractCaseValue` package provides a macro to expose assiocated values from enum cases as a computed property. 
+
+@Metadata {
+  @PageColor(blue)
+}
+
+## Overview
+
+@Row {
+  @Column {
+    To extract a simple value annotate an enum with the `ExtractCaseValue` macro and provide the expected type as a generic along with a name for the comuted property. This will use the `firstMatchingType` as a default to use the first associated value in a case that matches the expected type (in this case `String`).
+  }
+  @Column {
+    ![Screenshot of Xcode showing the marco expansion on a Path enum with a String as return type](sample-one)
+  }
+}
+
+@Row {
+  @Column {
+    If the return type is optional the macro will infer `nil` as the default value.
+  }
+  @Column {
+    ![Screenshot of Xcode showing the marco expansion on a JSON enum with an optional String as return type](sample-two)
+  }
+}
+  
+@Row {
+  @Column {
+    ![Screenshot of Xcode showing the fix-it](fix-it)		
+  }
+  @Column {
+    Otherwise, you will get a fix-it that recommends to use a default value.	
+  }
+}
+    
+@Row {
+  @Column {
+    You can also add mutliple `ExtractCaseValue` macros.
+    ![Screenshot of Xcode showing the marco expansion on a Coordinate enum which uses multiple macros](sample-three)
+  }
+}