Make examples runnable

Author: SimplyDanny

Examples/.gitignore

@@ -0,0 +1,2 @@
+.DS_Store
+/.build

Examples/AddOneToIntegerLiterals.swift

@@ -1,22 +1,23 @@
 import SwiftSyntax
-import SwiftSyntaxParser
+import SwiftParser
 import Foundation
 
 /// AddOneToIntegerLiterals will visit each token in the Syntax tree, and
 /// (if it is an integer literal token) add 1 to the integer and return the
 /// new integer literal token.
 ///
-/// For example will it turn:
+/// For example, it will turn
 /// ```
 /// let x = 2
 /// let y = 3_000
 /// ```
-/// into:
+/// into
 /// ```
 /// let x = 3
 /// let y = 3001
 /// ```
-class AddOneToIntegerLiterals: SyntaxRewriter {
+///
+private class AddOneToIntegerLiterals: SyntaxRewriter {
   override func visit(_ token: TokenSyntax) -> Syntax {
     // Only transform integer literals.
     guard case .integerLiteral(let text) = token.tokenKind else {
@@ -37,8 +38,14 @@ class AddOneToIntegerLiterals: SyntaxRewriter {
   }
 }
 
-let file = CommandLine.arguments[1]
-let url = URL(fileURLWithPath: file)
-let sourceFile = try SyntaxParser.parse(url)
-let incremented = AddOneToIntegerLiterals().visit(sourceFile)
-print(incremented)
+@main
+struct Main {
+  static func main() throws {
+    let file = CommandLine.arguments[1]
+    let url = URL(fileURLWithPath: file)
+    let source = try String(contentsOf: url, encoding: .utf8)
+    let sourceFile = try Parser.parse(source: source)
+    let incremented = AddOneToIntegerLiterals().visit(sourceFile)
+    print(incremented)
+  }
+}

Examples/CodeGenerationUsingSwiftSyntaxBuilder.swift

@@ -1,26 +1,31 @@
 import SwiftSyntaxBuilder
 
-/// This example will print the following example:
+/// This example will print the following code:
 ///
-///```
+/// ```
 /// import Foundation
 /// import UIKit
 /// class SomeViewController{
 ///    let tableView: UITableView
 /// }
-///```
-
-let source = SourceFile {
-  ImportDecl(path: "Foundation")
-  ImportDecl(path: "UIKit")
-  ClassDecl(identifier: "SomeViewController") {
-    VariableDecl(.let, name: "tableView", type: "UITableView")
-  }
-}
+/// ```
+///
+@main
+struct Main {
+  static func main() {
+    let source = SourceFile {
+      ImportDecl(path: "Foundation")
+      ImportDecl(path: "UIKit")
+      ClassDecl(identifier: "SomeViewController") {
+        VariableDecl(.let, name: "tableView", type: "UITableView")
+      }
+    }
 
-let syntax = source.buildSyntax(format: Format())
+    let syntax = source.build()
 
-var text = ""
-syntax.write(to: &text)
+    var text = ""
+    syntax.write(to: &text)
 
-print(text)
+    print(text)
+  }
+}

Examples/MigrateToNewIfLetSyntax.swift

@@ -29,7 +29,7 @@ class MigrateToNewIfLetSyntax: SyntaxRewriter {
          let initializer = binding.initializer,
          // ... and both sides of the assignment are the same identifiers.
          binding.pattern.withoutTrivia().description == initializer.value.withoutTrivia().description {
-        // Remove the initializer ... 
+        // Remove the initializer ...
         binding.initializer = nil
         // ... and remove whitespace before the comma (in `if` statements with multiple conditions).
         if index != node.conditions.count - 1 {
@@ -41,19 +41,16 @@ class MigrateToNewIfLetSyntax: SyntaxRewriter {
     }
     return StmtSyntax(node.withConditions(ConditionElementListSyntax(newConditions)))
   }
-  
-  /// Utility function to migrate all swift files in a folder and its subfolders
-  static func migrate(folderPath: String) {
-    for case let fileURL as String in FileManager.default.enumerator(atPath: folderPath)! {
-      if fileURL.hasSuffix("swift") {
-        print("Rewriting", fileURL)
-        let fullPath = folderPath + "/" + fileURL
-        let tree = try! Parser.parse(source: String(data: FileManager.default.contents(atPath: fullPath)!, encoding: .utf8 )!)
-        let newTree = MigrateToNewIfLetSyntax().visit(tree)
-        try! newTree.description.write(toFile: fullPath, atomically: true, encoding: .utf8)
-      }
-    }
-  }
 }
 
-MigrateToNewIfLetSyntax.migrate(folderPath: "/path/to/folder")
+@main
+struct Main {
+  static func main() throws {
+    let file = CommandLine.arguments[1]
+    let url = URL(fileURLWithPath: file)
+    let source = try String(contentsOf: url, encoding: .utf8)
+    let sourceFile = try Parser.parse(source: source)
+    let rewritten = MigrateToNewIfLetSyntax().visit(sourceFile)
+    print(rewritten)
+  }
+}

Examples/Package.swift

@@ -0,0 +1,46 @@
+// swift-tools-version: 5.7
+
+import PackageDescription
+
+let package = Package(
+    name: "Examples",
+    platforms: [
+        .macOS(.v10_15),
+    ],
+    products: [
+        .executable(name: "AddOneToIntegerLiterals", targets: ["AddOneToIntegerLiterals"]),
+        .executable(name: "CodeGenerationUsingSwiftSyntaxBuilder", targets: ["CodeGenerationUsingSwiftSyntaxBuilder"]),
+        .executable(name: "MigrateToNewIfLetSyntax", targets: ["MigrateToNewIfLetSyntax"]),
+    ],
+    dependencies: [
+        .package(path: "../"),
+    ],
+    targets: [
+        .executableTarget(
+            name: "AddOneToIntegerLiterals",
+            dependencies: [
+                .product(name: "SwiftParser", package: "swift-syntax"),
+                .product(name: "SwiftSyntax", package: "swift-syntax"),
+            ],
+            path: ".",
+            exclude: ["README.md", "CodeGenerationUsingSwiftSyntaxBuilder.swift", "MigrateToNewIfLetSyntax.swift"]
+        ),
+        .executableTarget(
+            name: "CodeGenerationUsingSwiftSyntaxBuilder",
+            dependencies: [
+                .product(name: "SwiftSyntaxBuilder", package: "swift-syntax"),
+            ],
+            path: ".",
+            exclude: ["README.md", "AddOneToIntegerLiterals.swift", "MigrateToNewIfLetSyntax.swift"]
+        ),
+        .executableTarget(
+            name: "MigrateToNewIfLetSyntax",
+            dependencies: [
+                .product(name: "SwiftParser", package: "swift-syntax"),
+                .product(name: "SwiftSyntax", package: "swift-syntax"),
+            ],
+            path: ".",
+            exclude: ["README.md", "CodeGenerationUsingSwiftSyntaxBuilder.swift", "AddOneToIntegerLiterals.swift"]
+        ),
+    ]
+)