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

rust-tests — правило для Claude Code: тесты Rust и установка

Правило rust-tests для Claude Code задаёт структуру и стиль тестов Rust: размещение модульных и интеграционных тестов, именование, фикстуры и изоляцию HTTP-запросов. Унифицирует тесты проекта.

MIT ★ 1 627 обновлён 2026-10-25

Установить в GitHub Copilot · Вручную: положить файлы Все способы и платформы ↓
.github/instructions/rust-tests.instructions.md
Открыть на GitHub

Что делает rust-tests

Модульные тесты правило размещает в #[cfg(test)] mod tests рядом с проверяемым кодом, а интеграционные — в корневой директории tests/. Имена тестов должны описывать поведение; для повторяющихся данных предлагаются функции-фикстуры. Правило также советует оставлять в тесте одно утверждение или несколько связанных проверок.

Для моков перечислены mockall для трейтов, wiremock для асинхронного HTTP и mockito для HTTP-тестов. Сетевые вызовы в модульных тестах ограничены loopback-адресами: подключение к внешним адресам и DNS-запросы нарушают это требование. Для тестирования HTTP используйте локальный тестовый сервер. Правило ссылается на rust.instructions.md, чьи соглашения тоже применяются.

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

  • разместить модульные тесты рядом с проверяемым Rust-кодом
  • назвать тест по контексту, действию и ожидаемому результату
  • изолировать HTTP-проверки от внешней сети
  • вынести повторяющиеся тестовые данные в фикстуры
  • отделить интеграционные тесты в директорию tests/

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

  • Добавь тесты Rust для этого модуля по правилу rust-tests.
  • Проверь, что HTTP-тест использует локальный мок-сервер и не обращается к внешней сети.
  • Перенеси интеграционные тесты в корневую директорию tests/ и приведи имена к описанию поведения.

Как установить rust-tests

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

.github/instructions/rust-tests.instructions.md

Поле applyTo задаёт, к каким файлам применять

По шагам, с командами для каждой платформы: AGENTS.md и CLAUDE.md: что это, кто читает и какой выбрать

Вопросы о rust-tests

Как установить rust-tests в Claude Code?

Скопируйте файл правила в .claude/rules/rust-tests.md.

Что делает rust-tests?

Задаёт соглашения для тестов Rust: где их размещать, как называть и как подготавливать тестовые данные. Также описывает моки HTTP и изоляцию модульных тестов от внешней сети.

Какие библиотеки для моков предлагает rust-tests?

Для моков на основе трейтов рекомендуется mockall, для асинхронного HTTP — wiremock, а mockito подходит для синхронных и асинхронных HTTP-тестов.

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

rust-tests.instructions.md · MIT
---
applyTo: '**/*.rs'
description: 'Rust test code authoring conventions'
---

# Rust Test Instructions

Conventions for Rust test code. All conventions from [rust.instructions.md](rust.instructions.md) apply, including naming, error handling, and module structure.

## Test Module Placement

Place unit tests in `#[cfg(test)] mod tests` within the source file they exercise:

<!-- <example-tests> -->
```rust
#[cfg(test)]
mod tests {
    use super::*;
    use wiremock::matchers::method;
    use wiremock::{Mock, MockServer, ResponseTemplate};

    #[test]
    fn given_valid_input_parse_returns_config() {
        let json = r#"{"endpoint": "http://127.0.0.1"}"#;
        let config: AppConfig = serde_json::from_str(json).unwrap();
        assert_eq!(config.polling_interval_secs, 10);
    }

    #[tokio::test]
    async fn when_endpoint_available_fetch_returns_data() {
        let mock_server = MockServer::start().await;
        Mock::given(method("GET"))
            .respond_with(ResponseTemplate::new(200).set_body_bytes(b"data"))
            .mount(&mock_server)
            .await;

        let config = AppConfig {
            endpoint: mock_server.uri(),
            polling_interval_secs: 10,
        };
        let service = PollingService::new(config);
        let result = service.fetch().await;
        assert!(result.is_ok(), "fetch should succeed when the mock endpoint is available");
    }
}
```
<!-- </example-tests> -->

## Test Naming

Test method format: `given_context_when_action_then_expected` or descriptive snake_case that reads as a behavior statement.

```text
given_valid_input_parse_returns_config
when_endpoint_unavailable_send_returns_error
parses_empty_payload_as_default
```

Prefer one assertion per test. Related assertions validating the same behavior are acceptable.

## Mocking Libraries

| Library    | Usage                                                   |
|------------|---------------------------------------------------------|
| `mockall`  | Preferred for trait-based mocking                       |
| `wiremock` | HTTP server mocking in async tests                      |
| `mockito`  | Lightweight HTTP mocking for synchronous or async tests |

Keep unit tests network-isolated. Unit tests must not perform DNS resolution or connect to non-loopback addresses. For HTTP behavior, inject a loopback endpoint supplied by `wiremock`, `mockito`, or an equivalent local test double. Tests that require a deployed service belong in a separately controlled integration-test environment.

Use `mockall` to generate mock implementations from traits via `#[automock]`:

```rust
use mockall::automock;

// Application types — defined in your crate (see rust.instructions.md)
pub struct Item {
    pub id: String,
}

// Uses the module-scoped Result alias from rust.instructions.md
#[automock]
pub trait Repository: Send + Sync {
    fn find_by_id(&self, id: &str) -> Result<Option<Item>>;
}

pub struct ItemService {
    repo: Box<dyn Repository>,
}

impl ItemService {
    pub fn new(repo: Box<dyn Repository>) -> Self {
        Self { repo }
    }

    pub fn get(&self, id: &str) -> Result<Option<Item>> {
        self.repo.find_by_id(id)
    }
}

#[cfg(test)]
mod tests {
    use super::*;
    use mockall::predicate::*;

    #[test]
    fn given_existing_item_service_returns_it() {
        let mut mock = MockRepository::new();
        mock.expect_find_by_id()
            .with(eq("42"))
            .returning(|_| Ok(Some(Item { id: "42".into() })));

        let service = ItemService::new(Box::new(mock));
        let result = service.get("42").unwrap();
        assert_eq!(result.unwrap().id, "42");
    }
}
```

Use `wiremock` to mock HTTP servers in async tests:

```rust
use wiremock::{MockServer, Mock, ResponseTemplate};
use wiremock::matchers::method;

#[tokio::test]
async fn when_api_returns_ok_fetch_succeeds() {
    let mock_server = MockServer::start().await;

    Mock::given(method("GET"))
        .respond_with(ResponseTemplate::new(200).set_body_string(r#"{"id": "1"}"#))
        .mount(&mock_server)
        .await;

    let client = reqwest::Client::new();
    let response = client.get(mock_server.uri()).send().await.unwrap();
    assert_eq!(response.status(), 200);
}
```

Add test dependencies to `[dev-dependencies]` in `Cargo.toml`:

```toml
[dev-dependencies]
mockall = "0.13"
reqwest = { version = "0.12", features = ["json"] }
tokio = { version = "1", features = ["macros", "rt"] }
wiremock = "0.6"
```

## Test Data Patterns

Use builder functions or fixture helpers for test data rather than repeating inline construction:

```rust
#[cfg(test)]
mod tests {
    use super::*;

    fn sample_config() -> AppConfig {
        AppConfig {
            endpoint: "http://127.0.0.1".into(),
            polling_interval_secs: 10,
        }
    }

    #[test]
    fn given_custom_interval_config_uses_override() {
        let config = AppConfig {
            polling_interval_secs: 30,
            ..sample_config()
        };
        assert_eq!(config.polling_interval_secs, 30);
    }
}
```

Inline construction is acceptable for simple one-field tests where a builder adds no clarity.

## Integration Tests

Place integration tests in the `tests/` directory at the crate root. Each file in `tests/` compiles as a separate crate with access to the library's public API only:

```rust
// tests/polling_integration.rs
use my_service::AppConfig;

#[tokio::test]
async fn given_valid_config_service_starts() {
    let config = AppConfig {
        endpoint: "https://example.com".into(),
        polling_interval_secs: 1,
    };
    assert!(!config.endpoint.is_empty());
}
```

## Test Conventions

* Use `#[tokio::test]` for async tests.
* Prefer assertion messages that explain intent: `assert!(result.is_ok(), "should parse valid JSON")`.
* Use builder functions or fixture helpers for test data rather than repeating inline construction.
* Place integration tests in the `tests/` directory at the crate root.

## Complete Example

Types referenced below (`AppConfig`, `ServiceError`, `Result` alias) are defined in [rust.instructions.md](rust.instructions.md).

```rust
#[cfg(test)]
mod tests {
    use super::*;
    use wiremock::matchers::method;
    use wiremock::{Mock, MockServer, ResponseTemplate};

    // Fixture helper — see Test Data Patterns
    fn sample_config(endpoint: String) -> AppConfig {
        AppConfig {
            endpoint,
            polling_interval_secs: 10,
        }
    }

    #[test]
    fn given_defaults_config_has_ten_second_interval() {
        let config = sample_config("http://127.0.0.1".into());
        assert_eq!(config.polling_interval_secs, 10);
    }

    #[test]
    fn service_error_not_found_formats_message() {
        let err = ServiceError::not_found("item 42");
        assert_eq!(err.to_string(), "Not found: item 42");
    }

    #[tokio::test]
    async fn when_api_returns_service_unavailable_fetch_error_contains_status() {
        let mock_server = MockServer::start().await;
        Mock::given(method("GET"))
            .respond_with(ResponseTemplate::new(503))
            .mount(&mock_server)
            .await;

        let config = sample_config(mock_server.uri());
        let service = PollingService::new(config);
        let error = service.fetch().await.expect_err("503 response should fail");
        assert!(error.to_string().contains("HTTP 503"), "error should include status");
    }
}
```

© microsoft · MIT · microsoft/hve-core

Похожие правила IDE

Все правила IDE по теме «Тесты и QA» →
rust-write-tests pproenca Скилл rust-write-tests направляет агента при написании надёжных тестов на Rust: проверяет инварианты, выносит тесты в отдельные файлы и устраняет флакующие проверки. CX Codex +1 257установок run-rust-tests RediSearch Скилл run-rust-tests запускает Rust-тесты RediSearch по изменённым крейтам через cargo nextest и сама чинит упавшие проверки. CX Codex +1 ★ 6 244звёзд репо rust-unit-tests dominikmartn Скилл rust-unit-tests для Claude Code помогает писать и улучшать модульные тесты в кодовой базе Rust. Запускается при работе над логикой обработки данных и исправлении ошибок. CX Codex +1 ★ 720звёзд репо write-rust-tests RediSearch Скилл write-rust-tests для Claude Code создаёт тесты для Rust-кода с учётом ветвей, ошибок и граничных случаев. Помогает восполнить недостаточное покрытие. CX Codex +1 ★ 6 244звёзд репо rust-best-practices apollographql Скилл rust-best-practices для написания и ревью Rust-кода по хендбуку Apollo GraphQL: заимствование против клонирования, обработка ошибок, тесты. CX Codex +1 23 400установок rust-testing affaan-m Скилл rust-testing для Claude Code и других платформ: юнит-тесты, интеграционные, async, property-based, моки и покрытие в Rust. Держит единый стиль тестов по циклу TDD. CX Codex +1 8 400установок

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

Весь набор →
risk-register Скилл risk-register создаёт качественный реестр рисков проекта с матрицей вероятность × последствие, назначает владельцев, описывает стратегии смягчения и планы на случай срабатывания. CX Codex +1 ★ 1 627звёзд репо hve-builder Правило hve-builder задаёт конвенции для промптов, агентов, субагентов, инструкций и скиллов. Оно срабатывает при изменении файлов с указанными расширениями. CX Codex +1 ★ 1 627звёзд репо python-tests Правило python-tests задаёт конвенции написания тестов на pytest: структуру AAA, именование test_given_when_then и выбор между mocker, monkeypatch и MagicMock. CX Codex +1 ★ 1 627звёзд репо vex Справочник по спецификации OpenVEX v0.2.0 и сценарии для оформления, проверки и публикации документов уязвимостей в проекте. CX Codex +1 ★ 1 627звёзд репо CVE Analyzer Субагент CVE Analyzer для глубокого анализа CVE: проверяет достижимость уязвимого кода в проекте и возвращает статус VEX с доказательствами. CX Codex +1 ★ 1 627звёзд репо python-script Правило python-script задаёт стандарты написания утилит автоматизации на Python 3.11+ для Claude Code: управление пакетами через uv, строгие типы и единая структура CLI. CX Codex +1 ★ 1 627звёзд репо hve-artifact-authoring Скилл hve-artifact-authoring для Claude Code помогает создавать и проверять агентов, промпты, инструкции и скиллы для HVE Core. Помогает подготовить артефакт и проверить его в репозитории. CX Codex +1 ★ 1 627звёзд репо vex-generation Правило vex-generation задаёт требования к доказательствам, уровням уверенности и статусам при подготовке VEX-документов. Оно пригодится для анализа CVE с участием ИИ. CX Codex +1 ★ 1 627звёзд репо

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

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