add handlers that support async functions

motivation: async/await is coming in 5.5, take first steps to support it

changes:
* introduce handler initializers that takes async functions (@escaping () async throws -> Void, @escaping () async throws -> State)
* add tests

Author: tomerd

Sources/Lifecycle/Lifecycle.swift

@@ -12,6 +12,10 @@
 //
 //===----------------------------------------------------------------------===//
 
+#if compiler(>=5.5)
+import _Concurrency
+#endif
+
 #if os(macOS) || os(iOS) || os(watchOS) || os(tvOS)
 import Darwin
 #else
@@ -95,6 +99,28 @@ public struct LifecycleHandler {
     }
 }
 
+#if compiler(>=5.5)
+@available(macOS 12.0, *)
+extension LifecycleHandler {
+    public init(_ handler: @escaping () async throws -> Void) {
+        self = LifecycleHandler { callback in
+            detach {
+                do {
+                    try await handler()
+                    callback(nil)
+                } catch {
+                    callback(error)
+                }
+            }
+        }
+    }
+
+    public static func async(_ handler: @escaping () async throws -> Void) -> LifecycleHandler {
+        return LifecycleHandler(handler)
+    }
+}
+#endif
+
 // MARK: - Stateful Lifecycle Handlers
 
 /// LifecycleHandler for starting stateful tasks. The state can then be fed into a LifecycleShutdownHandler
@@ -137,6 +163,28 @@ public struct LifecycleStartHandler<State> {
     }
 }
 
+#if compiler(>=5.5)
+@available(macOS 12.0, *)
+extension LifecycleStartHandler {
+    public init(_ handler: @escaping () async throws -> State) {
+        self = LifecycleStartHandler { callback in
+            detach {
+                do {
+                    let state = try await handler()
+                    callback(.success(state))
+                } catch {
+                    callback(.failure(error))
+                }
+            }
+        }
+    }
+
+    public static func async(_ handler: @escaping () async throws -> State) -> LifecycleStartHandler {
+        return LifecycleStartHandler(handler)
+    }
+}
+#endif
+
 /// LifecycleHandler for shutting down stateful tasks. The state comes from a LifecycleStartHandler
 public struct LifecycleShutdownHandler<State> {
     private let underlying: (State, @escaping (Error?) -> Void) -> Void
@@ -177,6 +225,28 @@ public struct LifecycleShutdownHandler<State> {
     }
 }
 
+#if compiler(>=5.5)
+@available(macOS 12.0, *)
+extension LifecycleShutdownHandler {
+    public init(_ handler: @escaping (State) async throws -> Void) {
+        self = LifecycleShutdownHandler { state, callback in
+            detach {
+                do {
+                    try await handler(state)
+                    callback(nil)
+                } catch {
+                    callback(error)
+                }
+            }
+        }
+    }
+
+    public static func async(_ handler: @escaping (State) async throws -> Void) -> LifecycleShutdownHandler {
+        return LifecycleShutdownHandler(handler)
+    }
+}
+#endif
+
 // MARK: - ServiceLifecycle
 
 /// `ServiceLifecycle` provides a basic mechanism to cleanly startup and shutdown the application, freeing resources in order before exiting.
@@ -671,7 +741,7 @@ internal struct _LifecycleTask: LifecycleTask {
     }
 }
 
-// internal for testing
+// internal (instead of private) for testing
 internal class StatefulLifecycleTask<State>: LifecycleTask {
     let label: String
     let shutdownIfNotStarted: Bool = false

Tests/LifecycleTests/ComponentLifecycleTests+XCTest.swift

@@ -66,6 +66,10 @@ extension ComponentLifecycleTests {
             ("testStatefulNIO", testStatefulNIO),
             ("testStatefulNIOStartFailure", testStatefulNIOStartFailure),
             ("testStatefulNIOShutdownFailure", testStatefulNIOShutdownFailure),
+            ("testAsyncAwait", testAsyncAwait),
+            ("testAsyncAwaitStateful", testAsyncAwaitStateful),
+            ("testAsyncAwaitErrorOnStart", testAsyncAwaitErrorOnStart),
+            ("testAsyncAwaitErrorOnShutdown", testAsyncAwaitErrorOnShutdown),
             ("testMetrics", testMetrics),
         ]
     }

Tests/LifecycleTests/ComponentLifecycleTests.swift

@@ -1249,6 +1249,140 @@ final class ComponentLifecycleTests: XCTestCase {
         XCTAssertFalse(item.shutdown, "expected item to be shutdown")
     }
 
+    func testAsyncAwait() throws {
+        #if compiler(<5.5)
+        throw XCTSkip()
+        #else
+        guard #available(macOS 12.0, *) else {
+            throw XCTSkip()
+        }
+
+        class Item {
+            var isShutdown: Bool = false
+
+            func start() async throws {}
+
+            func shutdown() async throws {
+                self.isShutdown = true // not thread safe but okay for this purpose
+            }
+        }
+
+        let lifecycle = ComponentLifecycle(label: "test")
+
+        let item = Item()
+        lifecycle.register(label: "test", start: .async(item.start), shutdown: .async(item.shutdown))
+
+        lifecycle.start { error in
+            XCTAssertNil(error, "not expecting error")
+            lifecycle.shutdown()
+        }
+        lifecycle.wait()
+        XCTAssertTrue(item.isShutdown, "expected item to be shutdown")
+        #endif
+    }
+
+    func testAsyncAwaitStateful() throws {
+        #if compiler(<5.5)
+        throw XCTSkip()
+        #else
+        guard #available(macOS 12.0, *) else {
+            throw XCTSkip()
+        }
+
+        class Item {
+            var isShutdown: Bool = false
+            let id: String = UUID().uuidString
+
+            func start() async throws -> String {
+                return self.id
+            }
+
+            func shutdown(state: String) async throws {
+                XCTAssertEqual(self.id, state)
+                self.isShutdown = true // not thread safe but okay for this purpose
+            }
+        }
+
+        let lifecycle = ComponentLifecycle(label: "test")
+
+        let item = Item()
+        lifecycle.registerStateful(label: "test", start: .async(item.start), shutdown: .async(item.shutdown))
+
+        lifecycle.start { error in
+            XCTAssertNil(error, "not expecting error")
+            lifecycle.shutdown()
+        }
+        lifecycle.wait()
+        XCTAssertTrue(item.isShutdown, "expected item to be shutdown")
+        #endif
+    }
+
+    func testAsyncAwaitErrorOnStart() throws {
+        #if compiler(<5.5)
+        throw XCTSkip()
+        #else
+        guard #available(macOS 12.0, *) else {
+            throw XCTSkip()
+        }
+
+        class Item {
+            var isShutdown: Bool = false
+
+            func start() async throws {
+                throw TestError()
+            }
+
+            func shutdown() async throws {
+                self.isShutdown = true // not thread safe but okay for this purpose
+            }
+        }
+
+        let lifecycle = ComponentLifecycle(label: "test")
+
+        let item = Item()
+        lifecycle.register(label: "test", start: .async(item.start), shutdown: .async(item.shutdown))
+
+        lifecycle.start { error in
+            XCTAssert(error is TestError, "expected error to match")
+            lifecycle.shutdown()
+        }
+        lifecycle.wait()
+        XCTAssertTrue(item.isShutdown, "expected item to be shutdown")
+        #endif
+    }
+
+    func testAsyncAwaitErrorOnShutdown() throws {
+        #if compiler(<5.5)
+        throw XCTSkip()
+        #else
+        guard #available(macOS 12.0, *) else {
+            throw XCTSkip()
+        }
+        class Item {
+            var isShutdown: Bool = false
+
+            func start() async throws {}
+
+            func shutdown() async throws {
+                self.isShutdown = true // not thread safe but okay for this purpose
+                throw TestError()
+            }
+        }
+
+        let lifecycle = ComponentLifecycle(label: "test")
+
+        let item = Item()
+        lifecycle.register(label: "test", start: .async(item.start), shutdown: .async(item.shutdown))
+
+        lifecycle.start { error in
+            XCTAssertNil(error, "not expecting error")
+            lifecycle.shutdown()
+        }
+        lifecycle.wait()
+        XCTAssertTrue(item.isShutdown, "expected item to be shutdown")
+        #endif
+    }
+
     func testMetrics() {
         let metrics = TestMetrics()
         MetricsSystem.bootstrap(metrics)