Add basic tests for server and api functionality

Author: jonnyholland

Package.swift

@@ -29,7 +29,11 @@ let package = Package(
         .testTarget(
             name: "ComposableArchitecturePatternTests",
             dependencies: [
-            ]
+				"ComposableArchitecturePattern",
+			],
+			resources: [
+				.process("Mock/JSON")
+			]
         ),
     ]
 )

Sources/ComposableArchitecturePattern/MockCourier.swift

@@ -0,0 +1,18 @@
+//
+//  MockCourier.swift
+//  ComposableArchitecturePattern
+//
+//  Created by Jonathan Holland on 12/8/24.
+//
+
+import Foundation
+
+public struct MockCourier: Courier {
+	public func sendRequest(_ request: URLRequest, requestUID: UUID) async throws -> Data? {
+		guard let url = request.url else {
+			throw ServerAPIError.unknown(description: "Must have a valid URL to get mock data.", error: nil)
+		}
+		
+		return try? Data(contentsOf: url)
+	}
+}

Sources/ComposableArchitecturePattern/ServerEnvironment.swift

@@ -17,6 +17,10 @@ public enum ServerEnvironment: Hashable, CustomStringConvertible {
 	case production(url: String)
 	/// A test environment.
 	case test(url: String)
+	/// A url for testing locally, such as against local files.
+	///
+	/// e.g., `Bundle(for: SOMECLASS.self).url(forResource: "SomeMockFileName", withExtension: "json")`.
+	case localTests(url: URL?)
 
 	public var description: String {
 		switch self {
@@ -25,6 +29,8 @@ public enum ServerEnvironment: Hashable, CustomStringConvertible {
 				 let .production(url),
 				 let .test(url):
 				return url
+			case let .localTests(url):
+				return url?.absoluteString ?? "Unknown URL"
 		}
 	}
 
@@ -36,6 +42,8 @@ public enum ServerEnvironment: Hashable, CustomStringConvertible {
 				 let .production(url),
 				 let .test(url):
 				return URL(string: url)
+			case let .localTests(url):
+				return url
 		}
 	}
 }

Tests/ComposableArchitecturePatternTests/ComposableArchitecturePatternTests.swift

@@ -1,48 +1,43 @@
-import SwiftSyntax
-import SwiftSyntaxBuilder
-import SwiftSyntaxMacros
-import SwiftSyntaxMacrosTestSupport
-import XCTest
-
-// Macro implementations build for the host, so the corresponding module is not available when cross-compiling. Cross-compiled tests may still make use of the macro itself in end-to-end tests.
-#if canImport(ComposableArchitecturePatternMacros)
-import ComposableArchitecturePatternMacros
+//
+//  ComposableArchitecturePatternTests.swift
+//  ComposableArchitecturePattern
+//
+//  Created by Jonathan Holland on 12/8/24.
+//
 
-let testMacros: [String: Macro.Type] = [
-    "stringify": StringifyMacro.self,
-]
-#endif
+import XCTest
+@testable import ComposableArchitecturePattern
 
 final class ComposableArchitecturePatternTests: XCTestCase {
-    func testMacro() throws {
-        #if canImport(ComposableArchitecturePatternMacros)
-        assertMacroExpansion(
-            """
-            #stringify(a + b)
-            """,
-            expandedSource: """
-            (a + b, "a + b")
-            """,
-            macros: testMacros
-        )
-        #else
-        throw XCTSkip("macros are only supported when running tests for the host platform")
-        #endif
-    }
-
-    func testMacroWithStringLiteral() throws {
-        #if canImport(ComposableArchitecturePatternMacros)
-        assertMacroExpansion(
-            #"""
-            #stringify("Hello, \(name)")
-            """#,
-            expandedSource: #"""
-            ("Hello, \(name)", #""Hello, \(name)""#)
-            """#,
-            macros: testMacros
-        )
-        #else
-        throw XCTSkip("macros are only supported when running tests for the host platform")
-        #endif
-    }
+	func testMockCourierGetsJSON() async throws {
+		let api1 = MockServerAPI1()
+		XCTAssertNotNil(api1.environment?.url)
+		
+		let sut = MockCourier()
+		let dataFromRequest1 = try await sut.sendRequest(try api1.request(.GET), requestUID: .init())
+		XCTAssertNotNil(dataFromRequest1)
+		
+		let api2 = MockServerAPI2()
+		XCTAssertNotNil(api2.environment?.url)
+		let dataFromRequest2 = try await sut.sendRequest(try api2.request(.GET), requestUID: .init())
+		XCTAssertNotNil(dataFromRequest2)
+	}
+	
+	func testServerFunctionality() async throws {
+		let sut = MockServer1()
+		let apis = await sut.apis
+		XCTAssertTrue(apis.count == 1)
+		
+		let sutAPIs = await sut.apis
+		let sutEnvironment = await sut.currentEnvironment
+		XCTAssertTrue(sutAPIs.contains(where: { $0.environment == sutEnvironment }))
+	}
+	
+	func testServerAPIReturnObjectsSupport() async throws {
+		let sut1 = MockServerAPI1()
+		XCTAssertTrue(sut1.supports(MockResponse1.self))
+		
+		let sut2 = MockServerAPI2()
+		XCTAssertTrue(sut2.supports(MockResponse2.self))
+	}
 }

Tests/ComposableArchitecturePatternTests/Mock/JSON/MockResponse1JSON.json

@@ -0,0 +1,4 @@
+{
+	"name": "Jonathan",
+	"age": 30
+}

Tests/ComposableArchitecturePatternTests/Mock/JSON/MockResponse2JSON.json

@@ -0,0 +1,5 @@
+{
+	"name": "Steve Jobs",
+	"age": 30,
+	"city": "Cupertino"
+}

Tests/ComposableArchitecturePatternTests/Mock/MockServerAPIs.swift

@@ -0,0 +1,48 @@
+//
+//  MockServerAPIs.swift
+//  ComposableArchitecturePattern
+//
+//  Created by Jonathan Holland on 12/8/24.
+//
+
+import Foundation
+@testable import ComposableArchitecturePattern
+
+enum MockServerEnvironments {
+	static let mockServerAPI1 = ServerEnvironment.localTests(url: Bundle.module.url(forResource: "MockResponse1JSON", withExtension: "json"))
+	static let mockServerAPI2 = ServerEnvironment.localTests(url: Bundle.module.url(forResource: "MockResponse2JSON", withExtension: "json"))
+}
+
+struct MockServerAPI1: ServerAPI {
+	let id = UUID()
+	var environment: ServerEnvironment? = MockServerEnvironments.mockServerAPI1
+	var path: String = ""
+	var supportedHTTPMethods: [HTTPMethod] = [.GET]
+	var supportedReturnObjects: [Decodable.Type]? = [MockResponse1.self]
+	var strictEnvironmentEnforcement: Bool { false }
+}
+
+struct MockServerAPI2: ServerAPI {
+	let id = UUID()
+	var environment: ServerEnvironment? = MockServerEnvironments.mockServerAPI2
+	var path: String = ""
+	var supportedHTTPMethods: [HTTPMethod] = [.GET]
+	var supportedReturnObjects: [Decodable.Type]? = [MockResponse2.self]
+	var strictEnvironmentEnforcement: Bool { false }
+}
+
+actor MockServer1: Server {
+	var environments: [ServerEnvironment] = [MockServerEnvironments.mockServerAPI1]
+	lazy var currentEnvironment: ServerEnvironment? = self.environments.first
+	lazy var courier: Courier = MockCourier()
+	var requestsBeingProcessed = Set<UUID>()
+	var apis: [any ServerAPI] = [MockServerAPI1()]
+}
+
+actor MockServer2: Server {
+	var environments: [ServerEnvironment] = [MockServerEnvironments.mockServerAPI2]
+	lazy var currentEnvironment: ServerEnvironment? = self.environments.first
+	lazy var courier: Courier = MockCourier()
+	var requestsBeingProcessed = Set<UUID>()
+	var apis: [any ServerAPI] = [MockServerAPI2()]
+}

Tests/ComposableArchitecturePatternTests/Mock/MockServerResponses.swift

@@ -0,0 +1,20 @@
+//
+//  MockServerResponses.swift
+//  ComposableArchitecturePattern
+//
+//  Created by Jonathan Holland on 12/8/24.
+//
+
+import Foundation
+
+struct MockResponse1: Decodable {
+	let name: String
+	let age: Int
+}
+
+struct MockResponse2: Codable {
+	let name: String
+	let age: Int
+	let city: String
+}
+