К основному содержанию
скилл CX Codex

cargo-nextest — скилл для Claude Code: тесты Rust

Скилл для Claude Code запускает и фильтрует тесты Rust через cargo-nextest. Подключается при запуске тестов, настройке CI и поиске медленных или нестабильных тестов.

MIT 101 установок ★ 60 обновлён 2026-10-25

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add laurigates/claude-plugins --skill cargo-nextest -a claude-code
Открыть на GitHub

Что делает cargo-nextest

Скилл запускает тесты Rust через cargo nextest run, помогает отбирать их по имени, пакету или типу и настраивать повторы для нестабильных тестов. Он также описывает профили CI, параллельный запуск и вывод результатов в JUnit или JSON.

Для установки самого тест-раннера нужна команда cargo install cargo-nextest --locked. nextest не запускает doctests: для них используется cargo test --doc.

Какие задачи решает

  • запустить тесты Rust параллельно
  • отобрать тесты по имени или пакету
  • настроить повторы для нестабильных тестов в CI
  • сформировать JUnit-отчёт для CI

Примеры запросов агенту

  • Запусти тесты Rust через nextest и выведи подробный результат.
  • Настрой профиль CI с повторами нестабильных тестов и JUnit-отчётом.
  • Запусти doctests проекта отдельно от nextest.

Как установить cargo-nextest

1Через Skills CLI (Vercel)

npx skills add laurigates/claude-plugins --skill cargo-nextest -a claude-code

2Вручную: положить файлы

~/.claude/skills/cargo-nextest/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/cargo-nextest/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о cargo-nextest

Как установить cargo-nextest в Claude Code?

Выполни npx skills add laurigates/claude-plugins --skill cargo-nextest -a claude-code. Файл скилла находится по пути ~/.claude/skills/cargo-nextest/SKILL.md.

Что делает cargo-nextest?

Скилл помогает запускать и фильтровать тесты Rust, настраивать параллельное выполнение и повторы, а также готовить результаты для CI.

Как запускать doctests с cargo-nextest?

nextest не поддерживает doctests. Запускай их отдельно командой cargo test --doc.

Исходный текст

SKILL.md · MIT
---
created: 2025-12-16
modified: 2026-11-14
reviewed: 2026-04-25
name: cargo-nextest
description: "cargo-nextest: fast Rust test runner with parallel execution and advanced filtering. Use when running tests, setting up CI, or diagnosing flaky/slow tests."
user-invocable: false
allowed-tools: Bash(cargo nextest run *), Bash(cargo test *), Bash(cargo llvm-cov nextest *), Read, Grep, Glob
---

# cargo-nextest - Next-Generation Test Runner

cargo-nextest is a faster, more reliable test runner for Rust that executes each test in its own process for better isolation and parallel performance.

## When to Use This Skill

| Use this skill when... | Use sibling skill instead when... |
|---|---|
| Running tests in parallel with process isolation | Measuring code coverage -- use `cargo-llvm-cov` |
| Filtering tests by package, name, or pattern | Linting test code style -- use `clippy-advanced` |
| Setting up flaky-test retries in CI | Auditing unused test deps -- use `cargo-machete` |
| Optimizing test runtime via partitioning | Authoring tests / async patterns -- use `rust-development` |

## Installation

```bash
# Install cargo-nextest
cargo install cargo-nextest --locked

# Verify installation
cargo nextest --version
```

## Basic Usage

```bash
# Run all tests with nextest
cargo nextest run

# Run specific test
cargo nextest run test_name

# Run tests in specific package
cargo nextest run -p package_name

# Run with verbose output
cargo nextest run --verbose

# Run ignored tests
cargo nextest run -- --ignored

# Run all tests including ignored
cargo nextest run -- --include-ignored
```

## Configuration File

Create `.config/nextest.toml` in your project root:

```toml
[profile.default]
# Number of retries for flaky tests
retries = 0

# Test threads (default: number of logical CPUs)
test-threads = 8

# Fail fast - stop on first failure
fail-fast = false

# Show output for passing tests
success-output = "never"  # never, immediate, final, immediate-final

# Show output for failing tests
failure-output = "immediate"  # never, immediate, final, immediate-final

[profile.ci]
# CI-specific configuration
retries = 2
fail-fast = true
success-output = "never"
failure-output = "immediate-final"

# Slow test timeout
slow-timeout = { period = "60s", terminate-after = 2 }

[profile.ci.junit]
# JUnit XML output for CI
path = "target/nextest/ci/junit.xml"
```

## Test Filtering with Expression Language

```bash
# Run tests matching pattern
cargo nextest run -E 'test(auth)'

# Run tests in specific binary
cargo nextest run -E 'binary(my_app)'

# Run tests in specific package
cargo nextest run -E 'package(my_crate)'

# Complex expressions with operators
cargo nextest run -E 'test(auth) and not test(slow)'

# Run all integration tests
cargo nextest run -E 'kind(test)'

# Run only unit tests in library
cargo nextest run -E 'kind(lib) and test(/)'
```

### Expression Operators

- `test(pattern)` - Match test name (regex)
- `binary(pattern)` - Match binary name
- `package(pattern)` - Match package name
- `kind(type)` - Match test kind (lib, bin, test, bench, example)
- `platform(os)` - Match target platform
- `not expr` - Logical NOT
- `expr and expr` - Logical AND
- `expr or expr` - Logical OR

## Parallel Execution

Nextest runs each test in its own process by default, providing:

- **Better isolation** - Tests cannot interfere with each other
- **True parallelism** - No global state conflicts
- **Fault isolation** - One test crash doesn't affect others
- **Better resource management** - Each test has clean environment

```bash
# Control parallelism
cargo nextest run --test-threads 4

# Single-threaded execution
cargo nextest run --test-threads 1

# Use all available cores
cargo nextest run --test-threads 0
```

## Output Formats

```bash
# Human-readable output (default)
cargo nextest run

# JSON output for programmatic parsing
cargo nextest run --message-format json

# JSON with test output
cargo nextest run --message-format json-pretty

# Generate JUnit XML for CI
cargo nextest run --profile ci

# Combine with cargo-llvm-cov for coverage
cargo llvm-cov nextest --html
```

## Flaky Test Management

```toml
# In .config/nextest.toml
[profile.default]
# Retry flaky tests automatically
retries = 3

# Detect tests that pass on retry
[profile.default.overrides]
filter = 'test(flaky_)'
retries = 5
```

```bash
# Run with retries
cargo nextest run --retries 3

# Show retry statistics
cargo nextest run --retries 3 --failure-output immediate-final
```

## GitHub Actions Integration

```yaml
name: Test

on: [push, pull_request]

jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/[email protected]

      - name: Install the pinned toolchain
        run: rustup toolchain install --no-self-update

      - name: Install nextest
        uses: taiki-e/[email protected]
        with:
          tool: nextest

      - name: Run tests
        run: cargo nextest run --profile ci --all-features

      - name: Upload test results
        if: always()
        uses: actions/[email protected]
        with:
          name: test-results
          path: target/nextest/ci/junit.xml

      - name: Publish test results
        uses: EnricoMi/[email protected]
        if: always()
        with:
          files: target/nextest/ci/junit.xml
```

## Advanced Configuration

```toml
# .config/nextest.toml
[profile.default]
# Timeout for slow tests
slow-timeout = { period = "30s", terminate-after = 3 }

# Test groups for resource management
[test-groups.database]
max-threads = 1  # Serialize database tests

[profile.default.overrides]
filter = 'test(db_)'
test-group = 'database'

# Platform-specific overrides
[[profile.default.overrides]]
platform = 'x86_64-pc-windows-msvc'
slow-timeout = { period = "60s" }
```

## Doctests Limitation

**Important**: nextest does not support doctests. Use cargo test for doctests:

```bash
# Run doctests separately
cargo test --doc

# Run both nextest and doctests in CI
cargo nextest run && cargo test --doc
```

## Workspace Configuration

```toml
# In workspace root .config/nextest.toml
[profile.default]
default-filter = 'all()'

# Per-package overrides
[[profile.default.overrides]]
filter = 'package(slow_tests)'
test-threads = 1
slow-timeout = { period = "120s" }
```

## Comparison with cargo test

| Feature | cargo test | cargo nextest |
|---------|------------|---------------|
| Execution model | In-process | Per-test process |
| Parallelism | Thread-based | Process-based |
| Test isolation | Shared state | Complete isolation |
| Output format | Limited | Rich (JSON, JUnit) |
| Flaky test handling | Manual | Built-in retries |
| Doctests | Supported | Not supported |
| Performance | Good | Excellent |

## Best Practices

1. **Use profiles for different environments**:
   - `default` for local development
   - `ci` for continuous integration
   - `coverage` for coverage analysis

2. **Configure flaky test detection**:
   ```toml
   [profile.default]
   retries = 2
   ```

3. **Group resource-intensive tests**:
   ```toml
   [test-groups.expensive]
   max-threads = 2
   ```

4. **Set appropriate timeouts**:
   ```toml
   [profile.default]
   slow-timeout = { period = "60s", terminate-after = 2 }
   ```

5. **Use expression filters effectively**:
   ```bash
   # Run fast tests during development
   cargo nextest run -E 'not test(slow_)'
   ```

6. **Always run doctests separately in CI**:
   ```yaml
   - run: cargo nextest run --all-features
   - run: cargo test --doc --all-features
   ```

## Troubleshooting

**Tests timeout too quickly:**
```toml
[profile.default]
slow-timeout = { period = "120s", terminate-after = 3 }
```

**Too much parallel execution:**
```bash
cargo nextest run --test-threads 4
```

**Need test output for debugging:**
```bash
cargo nextest run --success-output immediate --failure-output immediate
```

**Flaky tests in CI:**
```toml
[profile.ci]
retries = 3
failure-output = "immediate-final"
```

## References

- [nextest documentation](https://nexte.st/)
- [Configuration reference](https://nexte.st/docs/configuration/)
- [Expression language](https://nexte.st/docs/running/)
- [CI Features](https://nexte.st/docs/ci-features/archiving/)

© laurigates · MIT · laurigates/claude-plugins

Похожие скиллы

Все скиллы по теме «Тесты и QA» →
rust-write-tests pproenca Скилл rust-write-tests направляет агента при написании надёжных тестов на Rust: проверяет инварианты, выносит тесты в отдельные файлы и устраняет флакующие проверки. CX Codex +1 257установок cargo-workflows mohitmishra786 Скилл cargo-workflows для Claude Code ведёт агента по воркспейсам Cargo, фичам, build.rs, кэшу сборки и аудиту зависимостей. Покрывает Rust-проекты с несколькими крейтами. CX Codex +1 651установок cargo-fuzz trailofbits Скилл cargo-fuzz для Claude Code помогает настроить фаззинг Rust-проекта и разобрать найденные сбои. Включается при работе с fuzz_target!, небезопасным кодом или FFI. CX Codex +1 6 000установок tui-testing dominikmartn Скилл tui-testing для Claude Code настраивает модульные тесты для headless TUI в Warp. Запускает проверку интерфейсных элементов через отрисовку в строки символов. CX Codex +1 ★ 720звёзд репо rust-best-practices apollographql Скилл rust-best-practices для написания и ревью Rust-кода по хендбуку Apollo GraphQL: заимствование против клонирования, обработка ошибок, тесты. CX Codex +1 23 400установок jackin-release-check jackin-project Скилл jackin-release-check прогоняет релизные гейты проекта jackin❯ и выдаёт отчёт по каждому. Нужен перед выпуском версии, когда надо понять, всё ли зелёное. CX Codex +1 469установок

Из того же набора27

Весь набор →
git-commit-workflow Скилл git-commit-workflow для Claude Code задаёт формат сообщений и правила staging. Помогает разделять изменения по смыслу и не смешивать файлы в одном коммите. CX Codex +1 161установок binary-analysis Скилл binary-analysis помогает агенту исследовать неизвестные бинарные файлы, дампить шестнадцатеричные данные и находить скрытые строки. CX Codex +1 146установок shell-expert Скилл shell-expert для Claude Code помогает писать скрипты Bash, zsh и POSIX, а также собирать автоматизацию из команд. Подключается к задачам с конвейерами и переносимым shell-кодом. CX Codex +1 141установок rust-development Скилл rust-development помогает писать и проверять Rust-код: от Cargo и владения памятью до async и Tokio. Срабатывает при задачах про Rust. CX Codex +1 108установок clippy-advanced Скилл clippy-advanced помогает настроить линтинг Clippy для Rust: категории правил, параметры clippy.toml, подавление предупреждений и запуск проверок в CI. CX Codex +1 107установок playwright-testing Скилл playwright-testing помогает писать E2E-тесты для веб-приложений в Playwright: проверять браузеры, мобильные viewport, API и визуальные снимки. CX Codex +1 106установок api-testing Скилл api-testing для написания тестов REST и GraphQL API через Supertest (TypeScript) и httpx/pytest (Python). Проверяет статусы, схемы ответов, аутентификацию и обработку ошибок. CX Codex +1 106установок bevy-game-engine Скилл bevy-game-engine учит ассистента создавать игры на Bevy: настраивать архитектуру ECS, рендеринг, ввод и загрузку ресурсов. CX Codex +1 3установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой