Sections 1, 2, and 3

Author: sebsto

Sources/AWSLambdaRuntimeCore/Documentation.docc/Resources/code/.shellcheckrc

@@ -0,0 +1 @@
+disable=all

Sources/AWSLambdaRuntimeCore/Documentation.docc/Resources/code/03-01-01-package-init.sh

@@ -1,3 +1,2 @@
-# shellcheck disable=all
 # Create a project directory
-mkdir SquareNumber && cd SquareNumber
+mkdir Palindrome && cd Palindrome

Sources/AWSLambdaRuntimeCore/Documentation.docc/Resources/code/03-01-02-package-init.sh

@@ -1,5 +1,5 @@
-# shellcheck disable=all
 # Create a project directory
-mkdir SquareNumber && cd SquareNumber
+mkdir Palindrome && cd Palindrome
+
 # create a skeleton project
-swift package init --type executable 
+swift package init --type executable 

Sources/AWSLambdaRuntimeCore/Documentation.docc/Resources/code/03-01-03-package-init.sh

@@ -1,7 +1,8 @@
-# shellcheck disable=all
 # Create a project directory
-mkdir SquareNumber && cd SquareNumber
+mkdir Palindrome && cd Palindrome
+
 # create a skeleton project
 swift package init --type executable 
+
 # open Xcode in the current directory
-xed .
+xed .

Sources/AWSLambdaRuntimeCore/Documentation.docc/Resources/code/03-01-04-package-init.sh

@@ -1,9 +1,11 @@
-# shellcheck disable=all
 # Create a project directory
-mkdir SquareNumber && cd SquareNumber
+mkdir Palindrome && cd Palindrome
+
 # create a skeleton project
 swift package init --type executable 
+
 # open Xcode in the current directory
 xed .
+
 # alternatively, you may open VSCode
 code .

Sources/AWSLambdaRuntimeCore/Documentation.docc/Resources/code/03-02-01-package.swift

@@ -4,5 +4,5 @@
 import PackageDescription
 
 let package = Package(
-    name: "SquareNumberLambda"
+    name: "Palindrome"
 )

Sources/AWSLambdaRuntimeCore/Documentation.docc/Resources/code/03-02-02-package.swift

@@ -4,7 +4,7 @@
 import PackageDescription
 
 let package = Package(
-    name: "SquareNumberLambda",
+    name: "Palindrome",
     platforms: [
         .macOS(.v15)
     ]

Sources/AWSLambdaRuntimeCore/Documentation.docc/Resources/code/03-02-03-package.swift

@@ -4,11 +4,11 @@
 import PackageDescription
 
 let package = Package(
-    name: "SquareNumberLambda",
+    name: "Palindrome",
     platforms: [
         .macOS(.v15)
     ],
     dependencies: [
-        .package(url: "https://github.com/swift-server/swift-aws-lambda-runtime.git", from: "main")
+        .package(url: "https://github.com/swift-server/swift-aws-lambda-runtime.git", branch: "main")
     ]
 )

Sources/AWSLambdaRuntimeCore/Documentation.docc/Resources/code/03-02-04-package.swift

@@ -4,14 +4,14 @@
 import PackageDescription
 
 let package = Package(
-    name: "SquareNumberLambda",
+    name: "Palindrome",
     platforms: [
         .macOS(.v15)
     ],
     products: [
-        .executable(name: "SquareNumberLambda", targets: ["SquareNumberLambda"])
+        .executable(name: "PalindromeLambda", targets: ["PalindromeLambda"])
     ],
     dependencies: [
-        .package(url: "https://github.com/swift-server/swift-aws-lambda-runtime.git", from: "main")
+        .package(url: "https://github.com/swift-server/swift-aws-lambda-runtime.git", branch: "main")
     ]
 )

Sources/AWSLambdaRuntimeCore/Documentation.docc/Resources/code/03-02-05-package.swift

@@ -4,19 +4,19 @@
 import PackageDescription
 
 let package = Package(
-    name: "SquareNumberLambda",
+    name: "Palindrome",
     platforms: [
         .macOS(.v15)
     ],
     products: [
-        .executable(name: "SquareNumberLambda", targets: ["SquareNumberLambda"])
+        .executable(name: "PalindromeLambda", targets: ["PalindromeLambda"])
     ],
     dependencies: [
-        .package(url: "https://github.com/swift-server/swift-aws-lambda-runtime.git", from: "main")
+        .package(url: "https://github.com/swift-server/swift-aws-lambda-runtime.git", branch: "main")
     ],
     targets: [
         .executableTarget(
-            name: "SquareNumberLambda",
+            name: "PalindromeLambda",
             dependencies: [
                 .product(name: "AWSLambdaRuntime", package: "swift-aws-lambda-runtime")
             ],

Sources/AWSLambdaRuntimeCore/Documentation.docc/Resources/code/03-03-01-main.swift

@@ -1,4 +1,4 @@
 // the data structure to represent the input parameter
 struct Request: Decodable {
-    let number: Double
+    let text: String
 }

Sources/AWSLambdaRuntimeCore/Documentation.docc/Resources/code/03-03-02-main.swift

@@ -1,9 +1,11 @@
 // the data structure to represent the input parameter
 struct Request: Decodable {
-    let number: Double
+    let text: String
 }
 
-// the data structure to represent the output response
+// the data structure to represent the response parameter
 struct Response: Encodable {
-    let result: Double
+    let text: String
+    let isPalindrome: Bool
+    let message: String
 }

Sources/AWSLambdaRuntimeCore/Documentation.docc/Resources/code/03-03-03-main.swift

@@ -1,14 +1,17 @@
-import AWSLambdaRuntime
-
 // the data structure to represent the input parameter
 struct Request: Decodable {
-    let number: Double
+    let text: String
 }
 
-// the data structure to represent the output response
+// the data structure to represent the response parameter
 struct Response: Encodable {
-    let result: Double
+    let text: String
+    let isPalindrome: Bool
+    let message: String
 }
 
-// the Lambda runtime
-let runtime = LambdaRuntime {
+// the business function
+func isPalindrome(_ text: String) -> Bool {
+    let cleanedText = text.lowercased().filter { $0.isLetter }
+    return cleanedText == String(cleanedText.reversed())
+}

Sources/AWSLambdaRuntimeCore/Documentation.docc/Resources/code/03-03-04-main.swift

@@ -2,16 +2,18 @@ import AWSLambdaRuntime
 
 // the data structure to represent the input parameter
 struct Request: Decodable {
-    let number: Double
+    let text: String
 }
 
-// the data structure to represent the output response
+// the data structure to represent the response parameter
 struct Response: Encodable {
-    let result: Double
+    let text: String
+    let isPalindrome: Bool
+    let message: String
 }
 
-// the Lambda runtime
-let runtime = LambdaRuntime {
-    (event: Request, context: LambdaContext) in
-
+// the business function
+func isPalindrome(_ text: String) -> Bool {
+    let cleanedText = text.lowercased().filter { $0.isLetter }
+    return cleanedText == String(cleanedText.reversed())
 }

Sources/AWSLambdaRuntimeCore/Documentation.docc/Resources/code/03-03-05-main.swift

@@ -2,17 +2,24 @@ import AWSLambdaRuntime
 
 // the data structure to represent the input parameter
 struct Request: Decodable {
-    let number: Double
+    let text: String
 }
 
-// the data structure to represent the output response
+// the data structure to represent the response parameter
 struct Response: Encodable {
-    let result: Double
+    let text: String
+    let isPalindrome: Bool
+    let message: String
 }
 
-// the Lambda runtime
-let runtime = LambdaRuntime {
-    (event: Request, context: LambdaContext) in
+// the business function
+func isPalindrome(_ text: String) -> Bool {
+    let cleanedText = text.lowercased().filter { $0.isLetter }
+    return cleanedText == String(cleanedText.reversed())
+}
 
-    Response(result: event.number * event.number)
-}
+// the lambda handler function
+let runtime = LambdaRuntime {
+    (event: Request, context: LambdaContext) -> Response in
+    
+}

Sources/AWSLambdaRuntimeCore/Documentation.docc/Resources/code/03-03-06-main.swift

@@ -2,20 +2,27 @@ import AWSLambdaRuntime
 
 // the data structure to represent the input parameter
 struct Request: Decodable {
-    let number: Double
+    let text: String
 }
 
-// the data structure to represent the output response
+// the data structure to represent the response parameter
 struct Response: Encodable {
-    let result: Double
+    let text: String
+    let isPalindrome: Bool
+    let message: String
 }
 
-// the Lambda runtime
-let runtime = LambdaRuntime {
-    (event: Request, context: LambdaContext) in
-
-    Response(result: event.number * event.number)
+// the business function
+func isPalindrome(_ text: String) -> Bool {
+    let cleanedText = text.lowercased().filter { $0.isLetter }
+    return cleanedText == String(cleanedText.reversed())
 }
 
-// start the loop
-try await runtime.run()
+// the lambda handler function
+let runtime = LambdaRuntime {
+    (event: Request, context: LambdaContext) -> Response in
+    
+    // call the business function and return a response
+    let result = isPalindrome(event.text)
+    return Response(text: event.text, isPalindrome: result, message: "Your text is \(result ? "a" : "not a") palindrome")
+}

Sources/AWSLambdaRuntimeCore/Documentation.docc/Resources/code/03-03-07-main.swift

@@ -0,0 +1,31 @@
+import AWSLambdaRuntime
+
+// the data structure to represent the input parameter
+struct Request: Decodable {
+    let text: String
+}
+
+// the data structure to represent the response parameter
+struct Response: Encodable {
+    let text: String
+    let isPalindrome: Bool
+    let message: String
+}
+
+// the business function
+func isPalindrome(_ text: String) -> Bool {
+    let cleanedText = text.lowercased().filter { $0.isLetter }
+    return cleanedText == String(cleanedText.reversed())
+}
+
+// the lambda handler function
+let runtime = LambdaRuntime {
+    (event: Request, context: LambdaContext) -> Response in
+    
+    // call the business function and return a response
+    let result = isPalindrome(event.text)
+    return Response(text: event.text, isPalindrome: result, message: "Your text is \(result ? "a" : "not a") palindrome")
+}
+
+// start the runtime
+try await runtime.run()

Sources/AWSLambdaRuntimeCore/Documentation.docc/Resources/code/03-04-02-console-output.sh

@@ -0,0 +1,2 @@
+2025-01-02T14:59:29+0100 info LocalLambdaServer : [AWSLambdaRuntimeCore] 
+LocalLambdaServer started and listening on 127.0.0.1:7000, receiving events on /invoke

Sources/AWSLambdaRuntimeCore/Documentation.docc/Resources/code/03-04-03-console-output.sh

@@ -0,0 +1,5 @@
+curl --header "Content-Type: application/json"          \
+     --request POST                                     \
+     --data '{"text": "Was it a car or a cat I saw?"}'  \
+     http://127.0.0.1:7000/invoke
+

Sources/AWSLambdaRuntimeCore/Documentation.docc/Resources/code/03-04-03-curl.sh

@@ -1,7 +1,7 @@
-# shellcheck disable=all
+curl --header "Content-Type: application/json"          \
+     --request POST                                     \
+     --data '{"text": "Was it a car or a cat I saw?"}'  \
+     http://127.0.0.1:7000/invoke
 
-curl --header "Content-Type: application/json" \
-     --request POST                            \
-     --data '{"number": 3}'                    \
-     http://localhost:7000/invoke
+{"message":"Your text is a palindrome","isPalindrome":true,"text":"Was it a car or a cat I saw?"}
 

Sources/AWSLambdaRuntimeCore/Documentation.docc/Resources/code/03-04-04-curl.sh

@@ -1,3 +1 @@
-# shellcheck disable=all
-
-export LOCAL_LAMBDA_SERVER_ENABLED=true
+swift run

Sources/AWSLambdaRuntimeCore/Documentation.docc/Resources/code/03-04-05-curl.sh

@@ -1,4 +1,6 @@
-# shellcheck disable=all
-
-export LOCAL_LAMBDA_SERVER_ENABLED=true
 swift run
+
+Building for debugging...
+[1/1] Write swift-version--58304C5D6DBC2206.txt
+Build of product 'PalindromeLambda' complete! (0.11s)
+2025-01-02T15:12:49+0100 info LocalLambdaServer : [AWSLambdaRuntimeCore] LocalLambdaServer started and listening on 127.0.0.1:7000, receiving events on /invoke

Sources/AWSLambdaRuntimeCore/Documentation.docc/Resources/code/03-04-06-terminal.sh

@@ -14,5 +14,5 @@ It's a beginners' tutorial. The business logic of the function is very simple, i
 
 If you have any questions or recommendations, please [leave your feedback on GitHub](https://github.com/swift-server/swift-aws-lambda-runtime/issues) so that you can get your question answered and this tutorial can be improved.
 
-*The following instructions were recorded on April 15, 2023 and the AWS Management Console may have changed since then. Feel free to raise an issue if you spot differences with our screenshots* 
+*The following instructions were recorded on January 2025 and the AWS Management Console may have changed since then. Feel free to raise an issue if you spot differences with our screenshots* 
 }