ios-coverage

iOS Test Coverage

Analyze test coverage and generate missing tests for iOS projects.

What This Command Does

1. Run Tests with Coverage - Execute tests with code coverage enabled
2. Analyze Coverage Report - Parse xcresult bundle with xccov
3. Identify Gaps - Find files below 80% threshold
4. Generate Missing Tests - Create unit/integration tests
5. Verify and Report - Show before/after metrics

Process

1. Run tests with coverage:

   xcodebuild test \
     -scheme MyApp \
     -destination 'platform=iOS Simulator,name=iPhone 16' \
     -enableCodeCoverage YES \
     -resultBundlePath TestResults.xcresult
   

2. Analyze coverage report:

   xcrun xccov view --report TestResults.xcresult
   

3. Identify files below 80% coverage threshold

4. For each under-covered file:

   • Analyze untested code paths
   • Generate unit tests for functions
   • Generate integration tests for repositories
   • Identify edge cases to cover

5. Verify new tests pass

6. Show before/after coverage metrics

7. Ensure project reaches 80%+ overall coverage

Running Coverage Analysis

Xcode Project

# Run tests with coverage
xcodebuild test \
  -scheme MyApp \
  -destination 'platform=iOS Simulator,name=iPhone 16' \
  -enableCodeCoverage YES \
  -resultBundlePath TestResults.xcresult

# View summary report
xcrun xccov view --report TestResults.xcresult

# View JSON report (for parsing)
xcrun xccov view --report --json TestResults.xcresult > coverage.json

# View specific file coverage
xcrun xccov view --archive --file Sources/HomeViewModel.swift TestResults.xcresult

Swift Package

# Run with coverage
swift test --enable-code-coverage

# Find coverage data
COVERAGE_PATH=$(swift test --show-codecov-path)

# Convert to report
xcrun llvm-cov report \
  .build/debug/MyPackagePackageTests.xctest/Contents/MacOS/MyPackagePackageTests \
  -instr-profile=$COVERAGE_PATH

Coverage Report Format

╔══════════════════════════════════════════════════════════════╗
║                    Coverage Report                           ║
╠══════════════════════════════════════════════════════════════╣
║ Overall Coverage: 72.4% (Target: 80%)                        ║
║ Status: ❌ BELOW THRESHOLD                                   ║
╚══════════════════════════════════════════════════════════════╝

## Coverage by Target

| Target | Coverage | Status |
|--------|----------|--------|
| MyApp | 68.2% | ❌ |
| MyAppTests | 100% | ✅ |

## Files Below Threshold (<80%)

| File | Coverage | Lines Missed | Priority |
|------|----------|--------------|----------|
| HomeViewModel.swift | 45.2% | 28/51 | 🔴 HIGH |
| NetworkClient.swift | 62.1% | 19/50 | 🟡 MEDIUM |
| UserService.swift | 78.3% | 5/23 | 🟢 LOW |

## Untested Code Paths

### HomeViewModel.swift (45.2%)

**Untested Functions:**
1. `fetchItems()` - Line 23-45
   - Error handling path not tested
   - Empty result case not tested

2. `deleteItem(id:)` - Line 67-89
   - Entire function untested

3. `refreshData()` - Line 102-115
   - Cancellation path not tested

**Recommended Tests:**
```swift
@Test func fetchItems_onError_showsAlert() async {
    // Test error handling path
}