swift-testing · johnrogers — скилл для Claude Code: тесты на Swift Testing
Скилл помогает писать тесты на Swift Testing, переносить проверки с XCTest и добавлять асинхронные и параметризованные сценарии.
MIT ★ 233 обновлён 2026-01-18
/plugin marketplace add johnrogers/claude-swift-engineering
/plugin install swift-engineering@claude-swift-engineeringЧто делает swift-testing
Скилл подсказывает, как устроить тесты на Swift Testing: использовать #expect для проверок, а #require — когда без значения нельзя продолжать тест. Он также показывает тесты ошибок, асинхронные функции и проверку вызова обратного вызова через confirmation.
При переносе с XCTest скилл сопоставляет старые утверждения с макросами Swift Testing. Для парных наборов аргументов нужен zip: без него несколько коллекций образуют декартово произведение. Тесты запускаются параллельно, поэтому сценарии с общими файлами, базами данных или синглтонами могут конфликтовать; для таких случаев описан .serialized.
Какие задачи решает
- перенести утверждения XCTest на макросы Swift Testing
- проверить результат асинхронной операции
- сопоставить входные значения с ожидаемыми через
zip - проверить, что обратный вызов был вызван
- изолировать тесты, которые используют общее состояние
Примеры запросов агенту
- Перенеси тесты
XCTestна Swift Testing и замени старые утверждения подходящими макросами. - Напиши асинхронный тест для
fetchData()с проверкой результата. - Параметризуй тест для парных входных значений и не допускай декартово произведение.
Как установить swift-testing
1Через маркетплейс плагинов
/plugin marketplace add johnrogers/claude-swift-engineering/plugin install swift-engineering@claude-swift-engineeringКоманда ставит плагин swift-engineering целиком, со всеми его скиллами
2Через Skills CLI (Vercel)
npx skills add johnrogers/claude-swift-engineering --skill swift-testing -a claude-code3Вручную: положить файлы
~/.claude/skills/swift-testing/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/swift-testing/
1Через Skills CLI (Vercel)
npx skills add johnrogers/claude-swift-engineering --skill swift-testing -a codex2Вручную: положить файлы
.agents/skills/swift-testing/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add johnrogers/claude-swift-engineering --skill swift-testing -a cursor2Вручную: положить файлы
.cursor/skills/swift-testing/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install johnrogers/claude-swift-engineering plugins/swift-engineering/skills/swift-testing2Вручную: положить файлы
.github/skills/swift-testing/SKILL.md1Через Skills CLI (Vercel)
npx skills add johnrogers/claude-swift-engineering --skill swift-testing -a gemini-cli2Командой платформы
gemini skills install https://github.com/johnrogers/claude-swift-engineering --path plugins/swift-engineering/skills/swift-testingВручную: положить файлы
.devin/skills/swift-testing/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о swift-testing
Как установить swift-testing в Claude Code?
В Claude Code добавьте маркетплейс командой /plugin marketplace add johnrogers/claude-swift-engineering, затем установите плагин командой /plugin install swift-engineering@claude-swift-engineering.
Что делает swift-testing?
Скилл помогает писать тесты на Swift Testing и переносить проверки с XCTest. Он охватывает асинхронные тесты, проверку ошибок и параметризацию.
Зачем использовать zip в параметризованных тестах?
Если передать несколько коллекций без zip, Swift Testing создаст все комбинации их значений. zip связывает элементы попарно.
Исходный текст
SKILL.md · MIT
---
name: swift-testing
description: Use when writing tests with Swift Testing (@Test, #expect, #require), migrating from XCTest, implementing async tests, or parameterizing tests.
---
# Swift Testing Framework
Modern testing with Swift Testing framework. No XCTest.
## Overview
Swift Testing replaces XCTest with a modern macro-based approach that's more concise, has better async support, and runs tests in parallel by default. The core principle: if you learned XCTest, unlearn it—Swift Testing works differently.
## References
- [Apple Documentation](https://developer.apple.com/documentation/testing)
- [Migration Guide](https://steipete.me/posts/2025/migrating-700-tests-to-swift-testing)
## Core Concepts
### Assertions
| Macro | Use Case |
|-------|----------|
| `#expect(expression)` | Soft check — continues on failure. Use for most assertions. |
| `#require(expression)` | Hard check — stops test on failure. Use for preconditions only. |
### Optional Unwrapping
```swift
let user = try #require(await fetchUser(id: "123"))
#expect(user.id == "123")
```
## Test Structure
```swift
import Testing
@testable import YourModule
@Suite
struct FeatureTests {
let sut: FeatureType
init() throws {
sut = FeatureType()
}
@Test("Description of behavior")
func testBehavior() {
#expect(sut.someProperty == expected)
}
}
```
## Assertion Conversions
| XCTest | Swift Testing |
|--------|---------------|
| `XCTAssert(expr)` | `#expect(expr)` |
| `XCTAssertEqual(a, b)` | `#expect(a == b)` |
| `XCTAssertNil(a)` | `#expect(a == nil)` |
| `XCTAssertNotNil(a)` | `#expect(a != nil)` |
| `try XCTUnwrap(a)` | `try #require(a)` |
| `XCTAssertThrowsError` | `#expect(throws: ErrorType.self) { }` |
| `XCTAssertNoThrow` | `#expect(throws: Never.self) { }` |
## Error Testing
```swift
#expect(throws: (any Error).self) { try riskyOperation() }
#expect(throws: NetworkError.self) { try fetch() }
#expect(throws: NetworkError.timeout) { try fetch() }
#expect(throws: Never.self) { try safeOperation() }
```
## Parameterized Tests
```swift
@Test("Validates inputs", arguments: zip(
["a", "b", "c"],
[1, 2, 3]
))
func testInputs(input: String, expected: Int) {
#expect(process(input) == expected)
}
```
**Warning:** Multiple collections WITHOUT zip creates Cartesian product.
## Async Testing
```swift
@Test func testAsync() async throws {
let result = try await fetchData()
#expect(!result.isEmpty)
}
```
### Confirmations
```swift
@Test func testCallback() async {
await confirmation("callback received") { confirm in
let sut = SomeType { confirm() }
sut.triggerCallback()
}
}
```
## Tags
```swift
extension Tag {
@Tag static var fast: Self
@Tag static var networking: Self
}
@Test(.tags(.fast, .networking))
func testNetworkCall() { }
```
## Common Pitfalls
1. **Overusing `#require`** — Use `#expect` for most checks
2. **Forgetting state isolation** — Each test gets a NEW instance
3. **Accidental Cartesian product** — Always use `zip` for paired inputs
4. **Not using `.serialized`** — Apply for thread-unsafe legacy tests
## Common Mistakes
1. **Overusing `#require`** — `#require` is for preconditions only. Using it for normal assertions means the test stops at first failure instead of reporting all failures. Use `#expect` for assertions, `#require` only when subsequent assertions depend on the value.
2. **Cartesian product bugs** — `@Test(arguments: [a, b], [c, d])` creates 4 combinations, not 2. Always use `zip` to pair arguments correctly: `arguments: zip([a, b], [c, d])`.
3. **Forgetting state isolation** — Swift Testing creates a new test instance per test method. BUT shared state between tests (static variables, singletons) still leak. Use dependency injection or clean up singletons between tests.
4. **Parallel test conflicts** — Swift Testing runs tests in parallel by default. Tests touching shared files, databases, or singletons will interfere. Use `.serialized` or isolation strategies.
5. **Not using `async` naturally** — Wrapping async operations in `Task { }` defeats the purpose. Use `async/await` directly in test function signature: `@Test func testAsync() async throws { }`.
6. **Confirmation misuse** — `confirmation` is for verifying callbacks were called. Using it for assertions is wrong. Use `#expect` for assertions, `confirmation` for callback counts.
© John Rogers (@johnrogers) · MIT · johnrogers/claude-swift-engineering
Похожие скиллы
Все скиллы по теме «Тесты и QA» →Сначала — swift-testing от других авторов.