packaging plugin

motivation: add an easy wasy for lambda users to package their lambda and upload it to AWS

changes:
* add SwiftPM plugin with the verb "archive"
* use docker to build and package the lambda(s)

Author: tomerd

Examples/Echo/Package.swift

@@ -1,7 +1,16 @@
-// swift-tools-version:5.5
+// swift-tools-version:5.6
 
+import Foundation
 import PackageDescription
 
+// this is the dependency on the swift-aws-lambda-runtime library
+var dependencies = [Package.Dependency]()
+if FileManager.default.fileExists(atPath: "../../Package.swift") {
+    dependencies.append(Package.Dependency.package(name: "swift-aws-lambda-runtime", path: "../.."))
+} else {
+    dependencies.append(Package.Dependency.package(url: "https://github.com/swift-server/swift-aws-lambda-runtime.git", branch: "main"))
+}
+
 let package = Package(
     name: "swift-aws-lambda-runtime-example",
     platforms: [
@@ -10,12 +19,7 @@ let package = Package(
     products: [
         .executable(name: "MyLambda", targets: ["MyLambda"]),
     ],
-    dependencies: [
-        // this is the dependency on the swift-aws-lambda-runtime library
-        // in real-world projects this would say
-        // .package(url: "https://github.com/swift-server/swift-aws-lambda-runtime.git", from: "1.0.0")
-        .package(name: "swift-aws-lambda-runtime", path: "../.."),
-    ],
+    dependencies: dependencies,
     targets: [
         .executableTarget(
             name: "MyLambda",

Package.swift

@@ -1,4 +1,4 @@
-// swift-tools-version:5.2
+// swift-tools-version:5.6
 
 import PackageDescription
 
@@ -9,6 +9,8 @@ let package = Package(
         .library(name: "AWSLambdaRuntime", targets: ["AWSLambdaRuntime"]),
         // this has all the main functionality for lambda and it does not link Foundation
         .library(name: "AWSLambdaRuntimeCore", targets: ["AWSLambdaRuntimeCore"]),
+        // plugin to package the lambda, preparing an archive that can be uploaded to AWS. requires docker.
+        .plugin(name: "AWSLambdaPackager", targets: ["AWSLambdaPackager"]),
         // for testing only
         .library(name: "AWSLambdaTesting", targets: ["AWSLambdaTesting"]),
     ],
@@ -31,6 +33,10 @@ let package = Package(
             .product(name: "NIOConcurrencyHelpers", package: "swift-nio"),
             .product(name: "NIOPosix", package: "swift-nio"),
         ]),
+        .plugin(
+            name: "AWSLambdaPackager",
+            capability: .command(intent: .custom(verb: "archive", description: "Archive Lambda binary and prepare it for uploading to AWS"))
+        ),
         .testTarget(name: "AWSLambdaRuntimeCoreTests", dependencies: [
             .byName(name: "AWSLambdaRuntimeCore"),
             .product(name: "NIOTestUtils", package: "swift-nio"),

[email protected]

@@ -0,0 +1,55 @@
+// swift-tools-version:5.2
+
+import PackageDescription
+
+let package = Package(
+    name: "swift-aws-lambda-runtime",
+    products: [
+        // this library exports `AWSLambdaRuntimeCore` and adds Foundation convenience methods
+        .library(name: "AWSLambdaRuntime", targets: ["AWSLambdaRuntime"]),
+        // this has all the main functionality for lambda and it does not link Foundation
+        .library(name: "AWSLambdaRuntimeCore", targets: ["AWSLambdaRuntimeCore"]),
+        // for testing only
+        .library(name: "AWSLambdaTesting", targets: ["AWSLambdaTesting"]),
+    ],
+    dependencies: [
+        .package(url: "https://github.com/apple/swift-nio.git", .upToNextMajor(from: "2.33.0")),
+        .package(url: "https://github.com/apple/swift-log.git", .upToNextMajor(from: "1.4.2")),
+        .package(url: "https://github.com/swift-server/swift-backtrace.git", .upToNextMajor(from: "1.2.3")),
+    ],
+    targets: [
+        .target(name: "AWSLambdaRuntime", dependencies: [
+            .byName(name: "AWSLambdaRuntimeCore"),
+            .product(name: "NIOCore", package: "swift-nio"),
+            .product(name: "NIOFoundationCompat", package: "swift-nio"),
+        ]),
+        .target(name: "AWSLambdaRuntimeCore", dependencies: [
+            .product(name: "Logging", package: "swift-log"),
+            .product(name: "Backtrace", package: "swift-backtrace"),
+            .product(name: "NIOHTTP1", package: "swift-nio"),
+            .product(name: "NIOCore", package: "swift-nio"),
+            .product(name: "NIOConcurrencyHelpers", package: "swift-nio"),
+            .product(name: "NIOPosix", package: "swift-nio"),
+        ]),
+        .testTarget(name: "AWSLambdaRuntimeCoreTests", dependencies: [
+            .byName(name: "AWSLambdaRuntimeCore"),
+            .product(name: "NIOTestUtils", package: "swift-nio"),
+            .product(name: "NIOFoundationCompat", package: "swift-nio"),
+        ]),
+        .testTarget(name: "AWSLambdaRuntimeTests", dependencies: [
+            .byName(name: "AWSLambdaRuntimeCore"),
+            .byName(name: "AWSLambdaRuntime"),
+        ]),
+        // testing helper
+        .target(name: "AWSLambdaTesting", dependencies: [
+            .byName(name: "AWSLambdaRuntime"),
+            .product(name: "NIO", package: "swift-nio"),
+        ]),
+        .testTarget(name: "AWSLambdaTestingTests", dependencies: ["AWSLambdaTesting"]),
+        // for perf testing
+        .target(name: "MockServer", dependencies: [
+            .product(name: "NIOHTTP1", package: "swift-nio"),
+            .product(name: "NIO", package: "swift-nio"),
+        ]),
+    ]
+)