swift-tdd-guide-example

swift-tdd-guide 사용 예제

TDD 방식으로 새 기능을 개발하는 세션 예시입니다.

---

시나리오

상품 검색 기능을 TDD로 개발하는 상황입니다.

세션 예시

사용자 요청

@swift-tdd-guide
상품 검색 기능을 TDD로 개발하고 싶어.
- 검색어로 상품 목록 조회
- 빈 검색어는 전체 목록 반환
- 네트워크 에러 시 로컬 캐시 반환

에이전트 응답 예시

## TDD 워크플로우 시작

### Step 1: 테스트 케이스 정의

```swift
// Tests/ProductSearchServiceTests.swift
import Testing
@testable import MyApp

@Suite("ProductSearchService Tests")
struct ProductSearchServiceTests {

    var sut: ProductSearchService!
    var mockRepository: MockProductRepository!

    init() {
        mockRepository = MockProductRepository()
        sut = ProductSearchService(repository: mockRepository)
    }

    // MARK: - 검색 성공 케이스

    @Test("검색어로 상품 조회 시 일치하는 상품 반환")
    func searchWithQuery_returnsMatchingProducts() async throws {
        // Given
        let expectedProducts = [Product.mock(name: "iPhone")]
        mockRepository.searchResult = .success(expectedProducts)

        // When
        let result = try await sut.search(query: "iPhone")

        // Then
        #expect(result.count == 1)
        #expect(result.first?.name == "iPhone")
    }

    @Test("빈 검색어로 조회 시 전체 상품 반환")
    func searchWithEmptyQuery_returnsAllProducts() async throws {
        // Given
        let allProducts = [Product.mock(), Product.mock()]
        mockRepository.allProductsResult = .success(allProducts)

        // When
        let result = try await sut.search(query: "")

        // Then
        #expect(result.count == 2)
    }

    // MARK: - 에러 케이스

    @Test("네트워크 에러 시 캐시된 결과 반환")
    func searchWithNetworkError_returnsCachedResults() async throws {
        // Given
        mockRepository.searchResult = .failure(NetworkError.noConnection)
        mockRepository.cachedProducts = [Product.mock(name: "Cached")]

        // When
        let result = try await sut.search(query: "test")

        // Then
        #expect(result.first?.name == "Cached")
    }

    @Test("네트워크 에러이고 캐시도 없으면 에러 throw")
    func searchWithNetworkErrorAndNoCache_throwsError() async {
        // Given
        mockRepository.searchResult = .failure(NetworkError.noConnection)
        mockRepository.cachedProducts = []