build: added migration for Swift 6 language mode

Author: soumyamahunt

.devcontainer/devcontainer.json

@@ -1,5 +1,5 @@
 {
-    "name": "Swift 5.10-Ubuntu 22.04",
+    "name": "Swift 6.0-Ubuntu 22.04",
     "image": "swift:6.0-jammy",
     "features": {
         "ghcr.io/devcontainers/features/common-utils:2": {

.github/ISSUE_TEMPLATE/bug_report.md

@@ -8,12 +8,15 @@ assignees: ''
 ---
 
 - [ ] I have read the [documentation](https://swiftpackageindex.com/SwiftyLab/MetaCodable/main/documentation/metacodable).
+- [ ] I have read the [limitations](https://swiftpackageindex.com/swiftylab/metacodable/main/documentation/metacodable/limitations).
+- [ ] I could not find my [issue](https://github.com/SwiftyLab/MetaCodable/issues).
 
 **Describe the bug**
 A clear and concise description of what the bug is.
 
 **To Reproduce**
 Steps to reproduce the behavior:
+
 1. Go to '...'
 2. Click on '....'
 3. Scroll down to '....'
@@ -26,11 +29,12 @@ A clear and concise description of what you expected to happen.
 If applicable, add screenshots to help explain your problem.
 
 **Environment (please complete the following information, remove ones not applicable):**
- - OS: [e.g. macOS, Ubuntu]
- - Version [e.g. 14.3.1, 22.04]
- - Xcode [e.g. 15.2]
- - Swift [e.g. 5.9]
- - CocoaPods [e.g. 1.14.3]
+
+- OS: [e.g. macOS, Ubuntu]
+- Version [e.g. 14.3.1, 22.04]
+- Xcode [e.g. 15.2]
+- Swift [e.g. 5.9]
+- CocoaPods [e.g. 1.14.3]
 
 **Additional context**
 Add any other context about the problem here.

.github/ISSUE_TEMPLATE/feature_request.md

@@ -8,6 +8,9 @@ assignees: ''
 ---
 
 - [ ] I have read the [documentation](https://swiftpackageindex.com/SwiftyLab/MetaCodable/main/documentation/metacodable).
+- [ ] I have read the [limitations](https://swiftpackageindex.com/swiftylab/metacodable/main/documentation/metacodable/limitations).
+- [ ] I could not find my [request](https://github.com/SwiftyLab/MetaCodable/issues).
+- [ ] I have tried implementing this request with [`HelperCoder`](https://swiftpackageindex.com/swiftylab/metacodable/main/documentation/metacodable/helpercoder).
 
 **Is your feature request related to a problem? Please describe.**
 A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
@@ -18,5 +21,11 @@ A clear and concise description of what you want to happen.
 **Describe alternatives you've considered**
 A clear and concise description of any alternative solutions or features you've considered.
 
+**Describe the popularity of this request**
+Link to [Github discussion](https://github.com/SwiftyLab/MetaCodable/discussions) or any other discussions/poll for this request.
+
+**Describe complexities you've encountered with implementing via HelperCoder**
+A clear and concise description of any alternative solutions or features you've considered.
+
 **Additional context**
 Add any other context or screenshots about the feature request here.

.vscode/extensions.json

@@ -1,7 +1,7 @@
 {
-    "recommendations": [
-        "sswg.swift-lang",
-        "vadimcn.vscode-lldb",
-        "ms-vscode-remote.vscode-remote-extensionpack"
-    ]
+  "recommendations": [
+    "sswg.swift-lang",
+    "vadimcn.vscode-lldb",
+    "ms-vscode-remote.vscode-remote-extensionpack"
+  ]
 }

.vscode/launch.json

@@ -1,28 +1,22 @@
 {
-    "configurations": [
-        {
-            "type": "swift-lldb",
-            "request": "launch",
-            "sourceLanguages": [
-                "swift"
-            ],
-            "args": [],
-            "cwd": "${workspaceFolder:MetaCodable}",
-            "name": "Debug ProtocolGen",
-            "program": "${workspaceFolder:MetaCodable}/.build/debug/ProtocolGen",
-            "preLaunchTask": "swift: Build Debug ProtocolGen"
-        },
-        {
-            "type": "swift-lldb",
-            "request": "launch",
-            "sourceLanguages": [
-                "swift"
-            ],
-            "args": [],
-            "cwd": "${workspaceFolder:MetaCodable}",
-            "name": "Release ProtocolGen",
-            "program": "${workspaceFolder:MetaCodable}/.build/release/ProtocolGen",
-            "preLaunchTask": "swift: Build Release ProtocolGen"
-        }
-    ]
+  "configurations": [
+    {
+      "type": "swift-lldb",
+      "request": "launch",
+      "args": [],
+      "cwd": "${workspaceFolder:MetaCodable}",
+      "name": "Debug ProtocolGen",
+      "program": "${workspaceFolder:MetaCodable}/.build/debug/ProtocolGen",
+      "preLaunchTask": "swift: Build Debug ProtocolGen"
+    },
+    {
+      "type": "swift-lldb",
+      "request": "launch",
+      "args": [],
+      "cwd": "${workspaceFolder:MetaCodable}",
+      "name": "Release ProtocolGen",
+      "program": "${workspaceFolder:MetaCodable}/.build/release/ProtocolGen",
+      "preLaunchTask": "swift: Build Release ProtocolGen"
+    }
+  ]
 }

.vscode/settings.json

@@ -1,19 +1,18 @@
 {
-    "files.exclude": {
-        "**/.build": true,
-        "**/.swiftpm": true,
-        "**/.docc-build": true,
-        "**/node_modules": true,
-        "Package.resolved": true
-    },
-    "editor.inlayHints.enabled": "offUnlessPressed",
-    "editor.unicodeHighlight.allowedCharacters": {
-        "－": true
-    },
-    "swift.disableAutoResolve": true,
-    "swift.swiftEnvironmentVariables": {
-        "METACODABLE_CI": "true",
-        "SPI_GENERATE_DOCS": "true",
-        "SWIFT_SYNTAX_EXTENSION_MACRO_FIXED": "true"
-    },
+  "files.exclude": {
+    "**/.build": true,
+    "**/.swiftpm": true,
+    "**/.docc-build": true,
+    "**/node_modules": true,
+    "Package.resolved": true
+  },
+  "editor.inlayHints.enabled": "offUnlessPressed",
+  "editor.unicodeHighlight.allowedCharacters": {
+    "－": true
+  },
+  "swift.disableAutoResolve": true,
+  "swift.swiftEnvironmentVariables": {
+    "METACODABLE_CI": "true",
+    "SPI_GENERATE_DOCS": "true"
+  },
 }

.vscode/tasks.json

@@ -1,27 +1,27 @@
 {
-	"version": "2.0.0",
-	"tasks": [
-		{
-			"label": "swift: Build All",
-			"detail": "swift build --build-tests",
-			"cwd": ".",
-			"type": "swift",
-			"args": [
-				"build",
-				"--build-tests"
-			],
-			"problemMatcher": [
-				"$swiftc"
-			],
-			"group": {
-				"kind": "build",
-				"isDefault": true
-			},
-			"presentation": {
-				"reveal": "silent",
-				"panel": "shared",
-				"clear": true
-			}
-		}
-	]
+  "version": "2.0.0",
+  "tasks": [
+    {
+      "label": "swift: Build All",
+      "detail": "swift build --build-tests",
+      "cwd": ".",
+      "type": "swift",
+      "args": [
+        "build",
+        "--build-tests"
+      ],
+      "problemMatcher": [
+        "$swiftc"
+      ],
+      "group": {
+        "kind": "build",
+        "isDefault": true
+      },
+      "presentation": {
+        "reveal": "silent",
+        "panel": "shared",
+        "clear": true
+      }
+    }
+  ]
 }

CONTRIBUTING.md

@@ -11,20 +11,39 @@ You can contribute by fixing bugs or adding new features. For larger code change
 
 ### Things you will need
 
- * Linux, Mac OS (preferred), or Windows.
- * Git
- * [Swift](https://www.swift.org/getting-started/#installing-swift)
- * Optional
-   * Xcode and [CocoaPods], to test [CocoaPods] integration
-   * [Node], to use helper scripts in [package.json](package.json) folder.
+* Linux, Mac OS (preferred), or Windows.
+* Git
+* [Swift](https://www.swift.org/getting-started/#installing-swift)
+* Optional
+  * Xcode and [CocoaPods], to test [CocoaPods] integration
+  * [Node], to use helper scripts in [package.json](package.json) folder.
+
+### Setting up dev environment
+
+#### VSCode
+
+This repository contains necessary configurations and extesnions required for development in VSCode.
+
+#### Xcode
+
+For development in Xcode you have to set `METACODABLE_CI` environment variable. You can do so by launching Xcode with following command:
+
+```sh
+open $PATH_TO_XCODE_INSTALLATION --env METACODABLE_CI=1
+# i.e. open /Applications/Xcode.app --env METACODABLE_CI=1
+```
+
+> [!IMPORTANT]  
+> Make sure that Xcode is not running before this command executed.
+> Otherwise, this command will have no effect.
 
 ### Automated Tests
 
 GitHub action is already setup to run tests on pull requests targeting `main` branch. However, to reduce heavy usage of GitHub runners, run the following commands in your terminal to test:
 
 | Test category | With [Node] | Manually |
 | --- | --- | --- |
-| SPM integration | Run `npm run test` | Run `swift test` |
+| SPM integration | Run `npm run test` | Run `METACODABLE_CI=true swift test` |
 | [CocoaPods] integration (Requires Xcode) | Run `npm run pod-lint` | Run `pod lib lint --no-clean --allow-warnings` |
 
 ## Developer's Certificate of Origin 1.1

Package.swift

@@ -1,4 +1,4 @@
-// swift-tools-version: 5.9
+// swift-tools-version: 6.0
 
 import Foundation
 import PackageDescription
@@ -22,7 +22,7 @@ let package = Package(
         .package(url: "https://github.com/swiftlang/swift-syntax.git", "509.1.0"..<"601.0.0"),
         .package(url: "https://github.com/apple/swift-collections.git", from: "1.0.4"),
         .package(url: "https://github.com/apple/swift-argument-parser.git", from: "1.2.2"),
-        .package(url: "https://github.com/swiftlang/swift-format", from: "509.0.0"),
+        .package(url: "https://github.com/swiftlang/swift-format", from: "600.0.0"),
         .package(url: "https://github.com/swiftlang/swift-docc-plugin", from: "1.0.0"),
     ],
     targets: [
@@ -73,10 +73,12 @@ let package = Package(
             dependencies: [
                 "PluginCore", "MacroPlugin", "MetaCodable", "HelperCoders",
                 .product(name: "SwiftSyntaxMacrosTestSupport", package: "swift-syntax"),
+                .product(name: "SwiftSyntaxMacrosGenericTestSupport", package: "swift-syntax"),
             ],
             plugins: ["MetaProtocolCodable"]
         ),
-    ]
+    ],
+    swiftLanguageModes: [.v6, .v5]
 )
 
 extension Package.Dependency.Kind {
@@ -92,37 +94,14 @@ extension Package.Dependency.Kind {
     }
 }
 
-var unusedDeps: [String] = []
-var includeTargets: [String] = []
-var includeProducts: [String] = []
-
-if Context.environment["METACODABLE_CI"] == nil {
-    unusedDeps.append("swift-format")
-    if Context.environment["SPI_GENERATE_DOCS"] == nil {
-        unusedDeps.append("swift-docc-plugin")
-    }
-}
-
-if Context.environment["SWIFT_SYNTAX_EXTENSION_MACRO_FIXED"] != nil {
-    package.dependencies.removeAll { $0.kind.repoName == "swift-syntax" }
-    package.dependencies.append(
-        .package(
-            url: "https://github.com/soumyamahunt/swift-syntax.git",
-            branch: "extension-macro-assert-fix"
-        )
-    )
-
-    package.targets.forEach { target in
-        guard target.isTest else { return }
-        var settings = target.swiftSettings ?? []
-        settings.append(.define("SWIFT_SYNTAX_EXTENSION_MACRO_FIXED"))
-        target.swiftSettings = settings
-    }
-}
+var unusedDeps: Set<String> = []
+var includeTargets: Set<String> = []
+var includeProducts: Set<String> = []
 
-if Context.environment["METACODABLE_BEING_USED_FROM_COCOAPODS"] != nil {
-    includeTargets.append(contentsOf: ["PluginCore", "MacroPlugin"])
-    includeProducts.append("MacroPlugin")
+if Context.environment["METACODABLE_BEING_USED_FROM_COCOAPODS"] != nil { // CocoaPods specific
+    unusedDeps.formUnion(["swift-format", "swift-docc-plugin"])
+    includeTargets.formUnion(["PluginCore", "MacroPlugin"])
+    includeProducts.insert("MacroPlugin")
     package.products.append(.executable(name: "MacroPlugin", targets: ["MacroPlugin"]))
     package.targets = package.targets.compactMap { target in
         guard target.type == .macro else { return target }
@@ -143,13 +122,30 @@ if Context.environment["METACODABLE_BEING_USED_FROM_COCOAPODS"] != nil {
     }
 
     if Context.environment["METACODABLE_COCOAPODS_PROTOCOL_PLUGIN"] != nil {
-        includeTargets.append("ProtocolGen")
-        includeProducts.append("ProtocolGen")
+        includeTargets.insert("ProtocolGen")
+        includeProducts.insert("ProtocolGen")
         package.products.append(
             .executable(name: "ProtocolGen", targets: ["ProtocolGen"])
         )
     } else {
-        unusedDeps.append("swift-argument-parser")
+        unusedDeps.insert("swift-argument-parser")
+    }
+} else if Context.environment["METACODABLE_CI"] == nil { // SPM specific
+    unusedDeps.insert("swift-format")
+    package.targets.removeAll { $0.name == "MetaCodableTests" }
+    package.targets.append(
+        .testTarget(
+            name: "MetaCodableTests",
+            dependencies: [
+                "PluginCore", "MacroPlugin", "MetaCodable", "HelperCoders",
+                .product(name: "SwiftSyntaxMacrosTestSupport", package: "swift-syntax"),
+            ],
+            plugins: ["MetaProtocolCodable"]
+        )
+    )
+
+    if Context.environment["SPI_GENERATE_DOCS"] == nil {
+        unusedDeps.insert("swift-docc-plugin")
     }
 }