Workflow: Write and Run Tests

<required_reading> Read NOW:

references/testing.md </required_reading>

Tests are documentation that runs. They let the user verify correctness without reading code. ## Step 1: Understand What to Test

Claude tests (automated):

Core logic
State management
Service layer
Edge cases

User tests (manual):

UX feel
Visual polish
Real device behavior

Step 2: Write Tests

Unit Tests

import Testing
@testable import AppName

struct ItemTests {
    @Test func creation() {
        let item = Item(name: "Test")
        #expect(item.name == "Test")
    }

    @Test func validation() {
        let empty = Item(name: "")
        #expect(!empty.isValid)
    }
}

Async Tests

@Test func fetchItems() async throws {
    let service = MockService()
    let items = try await service.fetch()
    #expect(items.count > 0)
}

State Tests

@Test func addItem() {
    let state = AppState()
    state.addItem(Item(name: "New"))
    #expect(state.items.count == 1)
}

Step 3: Run Tests

xcodebuild test \
  -project AppName.xcodeproj \
  -scheme AppName \
  -destination 'platform=iOS Simulator,name=iPhone 16' \
  -resultBundlePath TestResults.xcresult

# Summary
xcrun xcresulttool get test-results summary --path TestResults.xcresult

Step 4: Coverage

xcodebuild test -enableCodeCoverage YES ...
xcrun xccov view --report TestResults.xcresult

Step 5: TDD Cycle

For new features:

Write failing test
Run → RED
Implement minimum
Run → GREEN
Refactor
Repeat

<coverage_targets>

Code Type	Target
Business logic	80-100%
State management	70-90%
Views	0% (manual)
</coverage_targets>

1.8 KiB Raw Blame History