Restructure Examples folder

Author: sebsto

.gitignore

@@ -9,3 +9,4 @@ xcuserdata
 Package.resolved
 .serverless
 .vscode
+Makefile

Examples/APIGateway/.gitignore

@@ -0,0 +1,2 @@
+samconfig.toml
+Makefile

Examples/APIGateway/Package.swift

@@ -0,0 +1,55 @@
+// swift-tools-version:6.0
+
+import PackageDescription
+
+// needed for CI to test the local version of the library
+import class Foundation.ProcessInfo
+import struct Foundation.URL
+
+#if os(macOS)
+let platforms: [PackageDescription.SupportedPlatform]? = [.macOS(.v15)]
+#else
+let platforms: [PackageDescription.SupportedPlatform]? = nil
+#endif
+
+let package = Package(
+    name: "swift-aws-lambda-runtime-example",
+    platforms: platforms,
+    products: [
+        .executable(name: "APIGAtewayLambda", targets: ["APIGAtewayLambda"])
+    ],
+    dependencies: [
+        // dependency on swift-aws-lambda-runtime is added dynamically below
+        // .package(url: "https://github.com/swift-server/swift-aws-lambda-runtime.git", branch: "main")
+
+        .package(url: "https://github.com/swift-server/swift-aws-lambda-events.git", branch: "main")
+    ],
+    targets: [
+        .executableTarget(
+            name: "APIGAtewayLambda",
+            dependencies: [
+                .product(name: "AWSLambdaRuntime", package: "swift-aws-lambda-runtime"),
+                .product(name: "AWSLambdaEvents", package: "swift-aws-lambda-events"),
+            ],
+            path: "."
+        )
+    ]
+)
+
+if let localDepsPath = ProcessInfo.processInfo.environment["LAMBDA_USE_LOCAL_DEPS"],
+    localDepsPath != "",
+    let v = try? URL(fileURLWithPath: localDepsPath).resourceValues(forKeys: [.isDirectoryKey]),
+    let _ = v.isDirectory
+{
+    print("[INFO] Compiling against swift-aws-lambda-runtime located at \(localDepsPath)")
+    package.dependencies += [
+        .package(name: "swift-aws-lambda-runtime", path: localDepsPath)
+    ]
+
+} else {
+    print("[INFO] LAMBDA_USE_LOCAL_DEPS is not pointing to your local swift-aws-lambda-runtime code")
+    print("[INFO] This project will compile against the main branch of the Lambda Runtime on GitHub")
+    package.dependencies += [
+        .package(url: "https://github.com/swift-server/swift-aws-lambda-runtime.git", branch: "main")
+    ]
+}

Examples/APIGateway/README.md

@@ -0,0 +1,34 @@
+//===----------------------------------------------------------------------===//
+//
+// This source file is part of the SwiftAWSLambdaRuntime open source project
+//
+// Copyright (c) 2024 Apple Inc. and the SwiftAWSLambdaRuntime project authors
+// Licensed under Apache License v2.0
+//
+// See LICENSE.txt for license information
+// See CONTRIBUTORS.txt for the list of SwiftAWSLambdaRuntime project authors
+//
+// SPDX-License-Identifier: Apache-2.0
+//
+//===----------------------------------------------------------------------===//
+
+import AWSLambdaEvents
+import AWSLambdaRuntime
+import class Foundation.JSONEncoder
+
+let runtime = LambdaRuntime {
+    (event: APIGatewayV2Request, context: LambdaContext) -> APIGatewayV2Response in
+
+    var header = HTTPHeaders()
+    context.logger.debug("HTTP API Message received")
+
+    header["content-type"] = "application/json"
+
+    // echo the request in the response
+    let data = try JSONEncoder().encode(event)
+    let response = String(data: data, encoding: .utf8)
+
+    return APIGatewayV2Response(statusCode: .ok, headers: header, body: response)
+}
+
+try await runtime.run()

Examples/APIGateway/Sources/main.swift

@@ -0,0 +1,31 @@
+AWSTemplateFormatVersion: '2010-09-09'
+Transform: AWS::Serverless-2016-10-31
+Description: SAM Template for QuoteService
+
+Resources:
+  # Lambda function
+  APIGAtewayLambda:
+    Type: AWS::Serverless::Function
+    Properties:
+      CodeUri: .build/plugins/AWSLambdaPackager/outputs/AWSLambdaPackager/APIGAtewayLambda/APIGAtewayLambda.zip
+      Timeout: 60
+      Handler: swift.bootstrap
+      Runtime: provided.al2
+      MemorySize: 512
+      Architectures:
+        - arm64
+      Environment:
+        Variables:
+          # by default, AWS Lambda runtime produces no log
+          # use `LOG_LEVEL: debug` for for lifecycle and event handling information
+          # use `LOG_LEVEL: trace` for detailed input event information
+          LOG_LEVEL: trace
+      Events:
+        HttpApiEvent:
+            Type: HttpApi
+
+Outputs:
+  # print API Gateway endpoint
+  APIGAtewayEndpoint:
+    Description: API Gateway endpoint UR"
+    Value: !Sub "https://${ServerlessHttpApi}.execute-api.${AWS::Region}.amazonaws.com"

Examples/APIGateway/template.yaml

@@ -0,0 +1,4 @@
+response.json
+samconfig.toml
+template.yaml
+Makefile

Examples/Benchmark/Package.swift

@@ -0,0 +1,53 @@
+// swift-tools-version:6.0
+
+import PackageDescription
+
+#if os(macOS)
+let platforms: [PackageDescription.SupportedPlatform]? = [.macOS(.v15)]
+#else
+let platforms: [PackageDescription.SupportedPlatform]? = nil
+#endif
+
+// needed for CI to test the local version of the library
+import class Foundation.ProcessInfo  
+import struct Foundation.URL
+
+let package = Package(
+    name: "swift-aws-lambda-runtime-example",
+    platforms: platforms,
+    products: [
+        .executable(name: "MyLambda", targets: ["MyLambda"])
+    ],
+    dependencies: [
+        .package(url: "https://github.com/swift-server/swift-aws-lambda-runtime.git", branch: "main")
+    ],
+    targets: [
+        .executableTarget(
+            name: "MyLambda",
+            dependencies: [
+                .product(name: "AWSLambdaRuntime", package: "swift-aws-lambda-runtime")
+            ],
+            path: "."
+        )
+    ]
+)
+
+if let localDepsPath = ProcessInfo.processInfo.environment["LAMBDA_USE_LOCAL_DEPS"], localDepsPath != ""  {  
+
+    print("++++++++ \(localDepsPath)")
+
+    // check if directory exists
+    let u = URL(fileURLWithPath: localDepsPath)
+    if let v = try? u.resourceValues(forKeys: [.isDirectoryKey]), v.isDirectory! {
+            print("Compiling against swift-aws-lambda-runtime located at \(localDepsPath)")
+            package.dependencies = [
+                .package(name: "swift-aws-lambda-runtime", path: localDepsPath)
+            ]
+    } else {
+        print("LAMBDA_USE_LOCAL_DEPS is not pointing to your local swift-aws-lambda-runtime code")
+        print("This project will compile against the main branch of the Lambda Runtime on GitHub")
+    }
+} else {
+    print("++++++++ NO ENV VAR ")
+
+}

Examples/HelloWorld/.gitignore

@@ -0,0 +1,23 @@
+//===----------------------------------------------------------------------===//
+//
+// This source file is part of the SwiftAWSLambdaRuntime open source project
+//
+// Copyright (c) 2024 Apple Inc. and the SwiftAWSLambdaRuntime project authors
+// Licensed under Apache License v2.0
+//
+// See LICENSE.txt for license information
+// See CONTRIBUTORS.txt for the list of SwiftAWSLambdaRuntime project authors
+//
+// SPDX-License-Identifier: Apache-2.0
+//
+//===----------------------------------------------------------------------===//
+
+import AWSLambdaRuntime
+
+// in this example we are receiving and responding with strings
+
+let runtime = LambdaRuntime { (event: String, context: LambdaContext) in
+    return "Hello \(event)"
+}
+
+try await runtime.run()

Examples/HelloWorld/Package.swift

@@ -0,0 +1,53 @@
+// swift-tools-version:5.7
+
+import PackageDescription
+
+// needed for CI to test the local version of the library
+import class Foundation.ProcessInfo  
+import struct Foundation.URL
+
+let runtimeVersion = Version("1.0.0-alpha.3")
+
+let package = Package(
+    name: "swift-aws-lambda-runtime-example",
+    platforms: [
+        .macOS(.v12)
+    ],
+    products: [
+        .executable(name: "MyLambda", targets: ["MyLambda"])
+    ],
+    dependencies: [
+        .package(url: "https://github.com/swift-server/swift-aws-lambda-runtime.git", from: runtimeVersion)
+    ],
+    targets: [
+        .executableTarget(
+            name: "MyLambda",
+            dependencies: [
+                .product(name: "AWSLambdaRuntimeCore", package: "swift-aws-lambda-runtime")
+            ],
+            path: "."
+        )
+    ]
+)
+
+// for CI to test the local version of the library
+// if ProcessInfo.processInfo.environment["LAMBDA_USE_LOCAL_DEPS"] != nil {    
+//     print("LAMBDA_USE_LOCAL_DEPS is ignored for runtime v1 examples.")
+//     print("This project will compile against runtime version \(runtimeVersion)")
+// }
+
+if let localDepsPath = ProcessInfo.processInfo.environment["LAMBDA_USE_LOCAL_DEPS"], localDepsPath != ""  {  
+
+            // check if directory exists
+            let u = URL(fileURLWithPath: localDepsPath)
+            if let v = try? u.resourceValues(forKeys: [.isDirectoryKey]), v.isDirectory! {
+                    print("Compiling against swift-aws-lambda-runtime located at \(localDepsPath)")
+                    package.dependencies = [
+                       .package(name: "swift-aws-lambda-runtime", path: localDepsPath)
+                    ]
+            } else {
+                print("LAMBDA_USE_LOCAL_DEPS is not pointing to your local swift-aws-lambda-runtime code")
+                print("This project will compile against runtime version \(runtimeVersion)")
+            }
+      
+}

Examples/HelloWorld/README.md

@@ -17,7 +17,7 @@ let package = Package(
         // demonstrate different types of error handling
     ],
     dependencies: [
-        .package(url: "https://github.com/swift-server/swift-aws-lambda-runtime.git", from: "1.0.0-alpha")
+        .package(url: "https://github.com/swift-server/swift-aws-lambda-runtime.git", from: "1.0.0-alpha.3")
     ],
     targets: [
         .executableTarget(