Rust Testing

affaan-m/ECC/docs/tr/skills/rust-testing

作者 affaan-mef648e01899ba3e8dc6371642deaaf64b4477775無授權條款275K 個星標收錄於 2026年10月9日更新於 2026年10月9日儲存庫4 天前更新

Rust testing patterns including unit tests, integration tests, async testing, property-based testing, mocking, and coverage. Follows TDD methodology.

僅含說明Software Development
AI 產生的概覽

Rust 測試模式，涵蓋 TDD 下的單元、整合、非同步、屬性、mock、文件測試、基準與覆蓋率。

功能
此技能提供在 Rust 中撰寫測試的參考指引與程式碼範例，遵循 TDD 的紅-綠-重構流程。內容涵蓋使用 #[cfg(test)] 模組的單元測試、整合測試、以 tokio 進行的非同步測試、使用 rstest 的參數化測試、使用 proptest 的屬性測試、使用 mockall 的 mock、文件測試、Criterion 基準測試，以及使用 cargo-llvm-cov 量測覆蓋率。此外也列出 cargo test 指令、覆蓋率目標、最佳實務，以及一個 GitHub Actions CI 範例。
適用情境
適用於撰寫新的 Rust 函式、方法或 trait，為現有程式碼補充測試覆蓋率，為效能關鍵程式碼建立基準測試，為輸入驗證套用屬性測試，或在 Rust 專案中遵循 TDD 工作流程。
執行需求
僅為說明文件，不附帶指令碼。範例假定已安裝 Rust 工具鏈與 cargo，並可選用 tokio、rstest、proptest、mockall、criterion 和 cargo-llvm-cov 等 crate 與工具。

Rust Test Desenleri

TDD metodolojisini takip ederek güvenilir, bakım yapılabilir testler yazmak için kapsamlı Rust test desenleri.

Ne Zaman Kullanılır

  • Yeni Rust fonksiyonları, metotları veya trait'leri yazma
  • Mevcut koda test kapsamı ekleme
  • Performans-kritik kod için benchmark'lar oluşturma
  • Girdi doğrulama için property-based testler uygulama
  • Rust projelerinde TDD iş akışını takip etme

Nasıl Çalışır

  1. Hedef kodu tanımla — Test edilecek fonksiyon, trait veya modülü bul
  2. Bir test yaz — #[cfg(test)] modülünde #[test] kullan, parametreli testler için rstest veya property-based testler için proptest
  3. Bağımlılıkları mock'la — Test altındaki birimi izole etmek için mockall kullan
  4. Testleri çalıştır (RED) — Testin beklenen hata ile başarısız olduğunu doğrula
  5. Uygula (GREEN) — Geçmek için minimal kod yaz
  6. Refactor — Testleri yeşil tutarken iyileştir
  7. Kapsamı kontrol et — cargo-llvm-cov kullan, 80%+ hedefle

Rust için TDD İş Akışı

RED-GREEN-REFACTOR Döngüsü

RED     → Önce başarısız bir test yazGREEN   → Testi geçmek için minimal kod yazREFACTOR → Testleri yeşil tutarken kodu iyileştirREPEAT  → Bir sonraki gereksinimle devam et

Rust'ta Adım-Adım TDD

rust
// RED: Önce testi yaz, yer tutucu olarak todo!() kullanpub fn add(a: i32, b: i32) -> i32 { todo!() }
#[cfg(test)]mod tests {    use super::*;    #[test]    fn test_add() { assert_eq!(add(2, 3), 5); }}// cargo test → 'not yet implemented'da panic
rust
// GREEN: todo!()'yu minimal implementasyonla değiştirpub fn add(a: i32, b: i32) -> i32 { a + b }// cargo test → GEÇTİ, sonra testleri yeşil tutarken REFACTOR

Unit Testler

Modül Seviyesi Test Organizasyonu

rust
// src/user.rspub struct User {    pub name: String,    pub email: String,}
impl User {    pub fn new(name: impl Into<String>, email: impl Into<String>) -> Result<Self, String> {        let email = email.into();        if !email.contains('@') {            return Err(format!("invalid email: {email}"));        }        Ok(Self { name: name.into(), email })    }
    pub fn display_name(&self) -> &str {        &self.name    }}
#[cfg(test)]mod tests {    use super::*;
    #[test]    fn creates_user_with_valid_email() {        let user = User::new("Alice", "[email protected]").unwrap();        assert_eq!(user.display_name(), "Alice");        assert_eq!(user.email, "[email protected]");    }
    #[test]    fn rejects_invalid_email() {        let result = User::new("Bob", "not-an-email");        assert!(result.is_err());        assert!(result.unwrap_err().contains("invalid email"));    }}

Assertion Makroları

rust
assert_eq!(2 + 2, 4);                                    // Eşitlikassert_ne!(2 + 2, 5);                                    // Eşitsizlikassert!(vec![1, 2, 3].contains(&2));                     // Booleanassert_eq!(value, 42, "expected 42 but got {value}");    // Özel mesajassert!((0.1_f64 + 0.2 - 0.3).abs() < f64::EPSILON);   // Float karşılaştırma

Hata ve Panic Testi

Result Dönüşlerini Test Etme

rust
#[test]fn parse_returns_error_for_invalid_input() {    let result = parse_config("}{invalid");    assert!(result.is_err());
    // Spesifik hata varyantını doğrula    let err = result.unwrap_err();    assert!(matches!(err, ConfigError::ParseError(_)));}
#[test]fn parse_succeeds_for_valid_input() -> Result<(), Box<dyn std::error::Error>> {    let config = parse_config(r#"{"port": 8080}"#)?;    assert_eq!(config.port, 8080);    Ok(()) // Herhangi bir ? Err döndürürse test başarısız olur}

Panic'leri Test Etme

rust
#[test]#[should_panic]fn panics_on_empty_input() {    process(&[]);}
#[test]#[should_panic(expected = "index out of bounds")]fn panics_with_specific_message() {    let v: Vec<i32> = vec![];    let _ = v[0];}

Entegrasyon Testleri

Dosya Yapısı

text
my_crate/├── src/│   └── lib.rs├── tests/              # Entegrasyon testleri│   ├── api_test.rs     # Her dosya ayrı bir test binary'si│   ├── db_test.rs│   └── common/         # Paylaşılan test yardımcıları│       └── mod.rs

Entegrasyon Testleri Yazma

rust
// tests/api_test.rsuse my_crate::{App, Config};
#[test]fn full_request_lifecycle() {    let config = Config::test_default();    let app = App::new(config);
    let response = app.handle_request("/health");    assert_eq!(response.status, 200);    assert_eq!(response.body, "OK");}

Async Testler

Tokio ile

rust
#[tokio::test]async fn fetches_data_successfully() {    let client = TestClient::new().await;    let result = client.get("/data").await;    assert!(result.is_ok());    assert_eq!(result.unwrap().items.len(), 3);}
#[tokio::test]async fn handles_timeout() {    use std::time::Duration;    let result = tokio::time::timeout(        Duration::from_millis(100),        slow_operation(),    ).await;
    assert!(result.is_err(), "should have timed out");}

Test Organizasyon Desenleri

rstest ile Parametreli Testler

rust
use rstest::{rstest, fixture};
#[rstest]#[case("hello", 5)]#[case("", 0)]#[case("rust", 4)]fn test_string_length(#[case] input: &str, #[case] expected: usize) {    assert_eq!(input.len(), expected);}
// Fixture'lar#[fixture]fn test_db() -> TestDb {    TestDb::new_in_memory()}
#[rstest]fn test_insert(test_db: TestDb) {    test_db.insert("key", "value");    assert_eq!(test_db.get("key"), Some("value".into()));}

Test Yardımcıları

rust
#[cfg(test)]mod tests {    use super::*;
    /// Mantıklı varsayılanlarla test kullanıcısı oluşturur.    fn make_user(name: &str) -> User {        User::new(name, &format!("{name}@test.com")).unwrap()    }
    #[test]    fn user_display() {        let user = make_user("alice");        assert_eq!(user.display_name(), "alice");    }}

proptest ile Property-Based Testing

Temel Property Testleri

rust
use proptest::prelude::*;
proptest! {    #[test]    fn encode_decode_roundtrip(input in ".*") {        let encoded = encode(&input);        let decoded = decode(&encoded).unwrap();        assert_eq!(input, decoded);    }
    #[test]    fn sort_preserves_length(mut vec in prop::collection::vec(any::<i32>(), 0..100)) {        let original_len = vec.len();        vec.sort();        assert_eq!(vec.len(), original_len);    }
    #[test]    fn sort_produces_ordered_output(mut vec in prop::collection::vec(any::<i32>(), 0..100)) {        vec.sort();        for window in vec.windows(2) {            assert!(window[0] <= window[1]);        }    }}

Özel Stratejiler

rust
use proptest::prelude::*;
fn valid_email() -> impl Strategy<Value = String> {    ("[a-z]{1,10}", "[a-z]{1,5}")        .prop_map(|(user, domain)| format!("{user}@{domain}.com"))}
proptest! {    #[test]    fn accepts_valid_emails(email in valid_email()) {        assert!(User::new("Test", &email).is_ok());    }}

mockall ile Mock'lama

Trait-Tabanlı Mock'lama

rust
use mockall::{automock, predicate::eq};
#[automock]trait UserRepository {    fn find_by_id(&self, id: u64) -> Option<User>;    fn save(&self, user: &User) -> Result<(), StorageError>;}
#[test]fn service_returns_user_when_found() {    let mut mock = MockUserRepository::new();    mock.expect_find_by_id()        .with(eq(42))        .times(1)        .returning(|_| Some(User { id: 42, name: "Alice".into() }));
    let service = UserService::new(Box::new(mock));    let user = service.get_user(42).unwrap();    assert_eq!(user.name, "Alice");}
#[test]fn service_returns_none_when_not_found() {    let mut mock = MockUserRepository::new();    mock.expect_find_by_id()        .returning(|_| None);
    let service = UserService::new(Box::new(mock));    assert!(service.get_user(99).is_none());}

Doc Testleri

Çalıştırılabilir Dokümantasyon

rust
/// İki sayıyı toplar.////// # Examples////// ```/// use my_crate::add;////// assert_eq!(add(2, 3), 5);/// assert_eq!(add(-1, 1), 0);/// ```pub fn add(a: i32, b: i32) -> i32 {    a + b}
/// Bir config string'i parse eder.////// # Errors////// Girdi geçerli TOML değilse `Err` döner.////// ```no_run/// use my_crate::parse_config;////// let config = parse_config(r#"port = 8080"#).unwrap();/// assert_eq!(config.port, 8080);/// ```////// ```no_run/// use my_crate::parse_config;////// assert!(parse_config("}{invalid").is_err());/// ```pub fn parse_config(input: &str) -> Result<Config, ParseError> {    todo!()}

Criterion ile Benchmark'lama

toml
# Cargo.toml[dev-dependencies]criterion = { version = "0.5", features = ["html_reports"] }
[[bench]]name = "benchmark"harness = false
rust
// benches/benchmark.rsuse criterion::{black_box, criterion_group, criterion_main, Criterion};
fn fibonacci(n: u64) -> u64 {    match n {        0 | 1 => n,        _ => fibonacci(n - 1) + fibonacci(n - 2),    }}
fn bench_fibonacci(c: &mut Criterion) {    c.bench_function("fib 20", |b| b.iter(|| fibonacci(black_box(20))));}
criterion_group!(benches, bench_fibonacci);criterion_main!(benches);

Test Kapsamı

Kapsamı Çalıştırma

bash
# Kurulum: cargo install cargo-llvm-cov (veya CI'da taiki-e/install-action kullan)cargo llvm-cov                    # Özetcargo llvm-cov --html             # HTML raporucargo llvm-cov --lcov > lcov.info # CI için LCOV formatıcargo llvm-cov --fail-under-lines 80  # Eşiğin altındaysa başarısız yap

Kapsam Hedefleri

Kod TipiHedef
Kritik iş mantığı100%
Public API90%+
Genel kod80%+
Oluşturulmuş / FFI binding'leriHariç tut

Test Komutları

bash
cargo test                        # Tüm testleri çalıştırcargo test -- --nocapture         # println çıktısını göstercargo test test_name              # Desene uyan testleri çalıştırcargo test --lib                  # Sadece unit testlercargo test --test api_test        # Sadece entegrasyon testlericargo test --doc                  # Sadece doc testlericargo test --no-fail-fast         # İlk başarısızlıkta durmacargo test -- --ignored           # Yok sayılan testleri çalıştır

En İyi Uygulamalar

YAPIN:

  • ÖNCE testleri yazın (TDD)
  • Unit testler için #[cfg(test)] modülleri kullanın
  • Implementasyon değil, davranışı test edin
  • Senaryoyu açıklayan açıklayıcı test isimleri kullanın
  • Daha iyi hata mesajları için assert! yerine assert_eq! tercih edin
  • Daha temiz hata çıktısı için Result döndüren testlerde ? kullanın
  • Testleri bağımsız tutun — paylaşılan mutable state yok

YAPMAYIN:

  • Result::is_err() test edebiliyorsanız #[should_panic] kullanmayın
  • Her şeyi mock'lamayın — mümkün olduğunda entegrasyon testlerini tercih edin
  • Kararsız testleri yok saymayın — düzeltin veya karantinaya alın
  • Testlerde sleep() kullanmayın — channel'lar, barrier'lar veya tokio::time::pause() kullanın
  • Hata yolu testini atlamayın

CI Entegrasyonu

yaml
# GitHub Actionstest:  runs-on: ubuntu-latest  steps:    - uses: actions/checkout@v4    - uses: dtolnay/rust-toolchain@stable      with:        components: clippy, rustfmt
    - name: Check formatting      run: cargo fmt --check
    - name: Clippy      run: cargo clippy -- -D warnings
    - name: Run tests      run: cargo test
    - uses: taiki-e/install-action@cargo-llvm-cov
    - name: Coverage      run: cargo llvm-cov --fail-under-lines 80

Unutmayın: Testler dokümantasyondur. Kodunuzun nasıl kullanılması gerektiğini gösterirler. Onları net yazın ve güncel tutun.

來源與署名

來源：affaan-m/ECC位於docs/tr/skills/rust-testing提交ef648e0

授權條款： 無授權條款

內容歸原作者所有。SourceWeft 從公開儲存庫中收錄這些內容。

檢舉或申請下架

更多來自 affaan-m/ECC 的技能

Unified Notifications Ops

affaan-m

設計統一的通知策略，對來自 GitHub、Linear、鉤子與聊天工具的通知進行分類、路由、去重與升級。

Productivity & Workflow275K4 天前更新

Verification Loop

affaan-m

執行六階段程式碼驗證流程，並產出 PASS/FAIL 就緒報告。

Software Development275K4 天前更新

Ui To Vue

affaan-m

將批次 UI 設計截圖轉換為使用 Vant、Element Plus 或 Ant Design Vue 的 Vue 3 元件。

Software Development275K4 天前更新

Unified Memory

affaan-m

指導代理透過本機 ECC Memory Vault 在不同執行框架之間共享持久脈絡與交接資訊。

AI & Agents275K4 天前更新

Visa Doc Translate

affaan-m

透過 OCR 將簽證文件影像翻譯成英文，並產出原圖與譯文對照的雙語 PDF。

Documents & Office275K4 天前更新

Team Builder

affaan-m

互動式挑選器：探索可用的代理角色，讓使用者最多選五個，平行執行同一任務並彙整結果。

AI & Agents275K4 天前更新

更多Software Development技能

Playground

anthropics

精選

建立自成一體的互動式 HTML 遊樂場，包含控制項、即時預覽與可複製的提示詞輸出。

Software Development37K今天更新

M5 Onboard

anthropics

精選

透過 USB 偵測 M5Stack ESP32 開發板，燒錄 UIFlow 2.0 韌體並安裝 MicroPython 應用程式套件。

Software Development37K今天更新

Cardputer Buddy

anthropics

精選

指導迭代 Cardputer-Adv 的 MicroPython 應用程式套件：新增應用程式、透過 USB 序列埠推送檔案、查看日誌並執行 REPL 指令。

Software Development37K今天更新

Web Design Guidelines

vercel-labs

精選

依據從遠端來源取得的 Web Interface Guidelines 審查 UI 程式碼，並以 file:line 形式回報問題。

Software Development32K5 週前更新

Vercel React Native Skills

vercel-labs

精選

React Native 與 Expo 最佳實務規則，涵蓋清單效能、動畫、導覽、UI 模式、狀態與 monorepo 設定。

Software Development32K5 週前更新

Vercel React Best Practices

vercel-labs

精選

Vercel 的 React 與 Next.js 效能指南，以 70 條規則的形式用於撰寫、審查與重構程式碼。

Software Development32K5 週前更新