[Feature] Coordinator protocols (#2)

This PR contains the work done to define the `Coordinator` and the `Router` public protocols, and also implemented a few concrete router implementations tailored for the **UIKit** framework. To provide further details about the work done: - [x] define a new, dedicated `Coordinator` target in the `Package` file; - [x] define the `Coordinator` and the `Router` public protocols used to implement the coordinator pattern; - [x] implemented some **UIKit** specific routers to use on the **iOS** platform: `ModalNavigationRouter`, `PushNavigationRouter` and the `WindowRouter` concrete routers. Co-authored-by: Javier Cicchelli <javier@rock-n-code.com> Reviewed-on: #2
2023-04-16 14:42:42 +00:00
parent 185f779daf
commit 12add7bf30
9 changed files with 669 additions and 1 deletions
@@ -0,0 +1,106 @@
+//
+//  TestCoordinators.swift
+//  CoordinatorTests
+//
+//  Created by Javier Cicchelli on 11/04/2023.
+//  Copyright © 2023 Röck+Cöde. All rights reserved.
+//
+
+import Coordinator
+import UIKit
+
+// MARK: - Test coordinators
+
+class SomeCoordinator: Coordinator {
+    
+    // MARK: Properties
+    
+    var children: [Coordinator] = []
+    var router: Router
+    
+    // MARK: Initialisers
+    
+    init(router: Router) {
+        self.router = router
+    }
+    
+    // MARK: Functions
+    
+    func present(animated: Bool, onDismiss: (() -> Void)?) {
+        router.present(
+            SomeViewController(),
+            animated: animated,
+            onDismiss: onDismiss
+        )
+    }
+
+}
+
+class SomeOtherCoordinator: Coordinator {
+
+    // MARK: Properties
+    
+    var children: [Coordinator] = []
+    var router: Router
+    
+    // MARK: Initialisers
+    
+    init(router: Router) {
+        self.router = router
+    }
+    
+    // MARK: Functions
+    
+    func present(animated: Bool, onDismiss: (() -> Void)?) {
+        router.present(
+            SomeOtherViewController(),
+            animated: animated,
+            onDismiss: onDismiss
+        )
+    }
+
+}
+
+// MARK: - SpyRouter
+
+class SpyRouter: Router {
+    
+    // MARK: Enumerations
+    
+    enum State {
+        case initialised
+        case presented
+        case dismissed
+    }
+    
+    // MARK: Properties
+    
+    var state: State = .initialised
+    var viewController: UIViewController?
+    var animated: Bool?
+    var onDismiss: OnDismissedClosure?
+    
+    // MARK: Functions
+    
+    func present(
+        _ viewController: UIViewController,
+        animated: Bool,
+        onDismiss: OnDismissedClosure?
+    ) {
+        self.viewController = viewController
+        self.animated = animated
+        self.onDismiss = onDismiss
+        self.state = .presented
+    }
+    
+    func dismiss(animated: Bool) {
+        self.animated = animated
+        self.state = .dismissed
+    }
+    
+}
+
+// MARK: - Test view controllers
+
+class SomeViewController: UIViewController {}
+class SomeOtherViewController: UIViewController {}
@@ -0,0 +1,137 @@
+//
+//  CoordinatorTests.swift
+//  CoordinatorTests
+//
+//  Created by Javier Cicchelli on 11/04/2023.
+//  Copyright © 2023 Röck+Cöde. All rights reserved.
+//
+
+import Coordinator
+import UIKit
+import XCTest
+
+final class CoordinatorTests: XCTestCase {
+
+    // MARK: Properties
+    
+    private var router: SpyRouter!
+    private var coordinator: Coordinator!
+    
+    // MARK: Tests
+    
+    func test_present_withoutOnDismissClosure() {
+        // Executing this test on the main thread is required as a `UIViewController` instance in being initialised here.
+        DispatchQueue.main.async {
+            // GIVEN
+            self.router = SpyRouter()
+            self.coordinator = SomeCoordinator(router: self.router)
+            
+            
+            // WHEN
+            self.coordinator.present(animated: false, onDismiss: nil)
+            
+            // THEN
+            XCTAssertTrue(self.coordinator.children.isEmpty)
+            XCTAssertEqual(self.router.state, .presented)
+            XCTAssertTrue(self.router.viewController is SomeViewController)
+            XCTAssertFalse(self.router.animated ?? true)
+            XCTAssertNil(self.router.onDismiss)
+        }
+    }
+    
+    func test_present_withOnDismissClosure() {
+        // Executing this test on the main thread is required as a `UIViewController` instance in being initialised here.
+        DispatchQueue.main.async {
+            // GIVEN
+            self.router = SpyRouter()
+            self.coordinator = SomeOtherCoordinator(router: self.router)
+            
+            // WHEN
+            self.coordinator.present(animated: true) {}
+            
+            // THEN
+            XCTAssertTrue(self.coordinator.children.isEmpty)
+            XCTAssertEqual(self.router.state, .presented)
+            XCTAssertTrue(self.router.viewController is SomeOtherViewController)
+            XCTAssertTrue(self.router.animated ?? false)
+            XCTAssertNotNil(self.router.onDismiss)
+        }
+    }
+    
+    func test_presentChild_withoutOnDismissClosure() {
+        // Executing this test on the main thread is required as a `UIViewController` instance in being initialised here.
+        DispatchQueue.main.async {
+            // GIVEN
+            self.router = SpyRouter()
+            self.coordinator = SomeCoordinator(router: self.router)
+            
+            let child = SomeOtherCoordinator(router: self.router)
+            
+            // WHEN
+            self.coordinator.present(child: child, animated: false)
+            
+            // THEN
+            XCTAssertFalse(self.coordinator.children.isEmpty)
+            XCTAssertEqual(self.coordinator.children.count, 1)
+            XCTAssertEqual(self.router.state, .presented)
+            XCTAssertTrue(self.router.viewController is SomeOtherViewController)
+            XCTAssertFalse(self.router.animated ?? true)
+            XCTAssertNil(self.router.onDismiss)
+        }
+    }
+    
+    func test_presentChild_withOnDismissClosure() {
+        // Executing this test on the main thread is required as a `UIViewController` instance in being initialised here.
+        DispatchQueue.main.async {
+            // GIVEN
+            self.router = SpyRouter()
+            self.coordinator = SomeOtherCoordinator(router: self.router)
+            
+            let child = SomeCoordinator(router: self.router)
+            
+            // WHEN
+            self.coordinator.present(child: child, animated: true) {}
+            
+            // THEN
+            XCTAssertFalse(self.coordinator.children.isEmpty)
+            XCTAssertEqual(self.coordinator.children.count, 1)
+            XCTAssertEqual(self.router.state, .presented)
+            XCTAssertTrue(self.router.viewController is SomeViewController)
+            XCTAssertTrue(self.router.animated ?? false)
+            XCTAssertNotNil(self.router.onDismiss)
+        }
+    }
+    
+    func test_dismiss_notAnimated() {
+        // GIVEN
+        router = SpyRouter()
+        coordinator = SomeOtherCoordinator(router: router)
+        
+        // WHEN
+        coordinator.dismiss(animated: false)
+        
+        // THEN
+        XCTAssertTrue(coordinator.children.isEmpty)
+        XCTAssertEqual(router.state, .dismissed)
+        XCTAssertNil(router.viewController)
+        XCTAssertFalse(router.animated ?? true)
+        XCTAssertNil(router.onDismiss)
+    }
+    
+    func test_dismiss_animated() {
+        // GIVEN
+        router = SpyRouter()
+        coordinator = SomeOtherCoordinator(router: router)
+        
+        // WHEN
+        coordinator.dismiss(animated: true)
+        
+        // THEN
+        XCTAssertTrue(coordinator.children.isEmpty)
+        XCTAssertEqual(router.state, .dismissed)
+        XCTAssertNil(router.viewController)
+        XCTAssertTrue(router.animated ?? false)
+        XCTAssertNil(router.onDismiss)
+    }
+
+}