Rust 適用的 Cloud 用戶端程式庫可讓您虛設常式實際用戶端實作,並插入模擬項目進行單元測試。使用模擬用戶端,即可編寫可控、可靠的單元測試,不會發出網路呼叫或產生費用。
事前準備
執行本文件中的程式碼前,請先按照「開始使用 Rust」一文的說明安裝 Rust,並設定 Cargo 專案。
依附元件
本文使用 mockall crate 做為模擬架構,並使用 Speech-to-Text 的 Speech 用戶端來說明工作流程。其他產生的用戶端也適用相同模式。
將用戶端程式庫和 google-cloud-gax 新增至 Cargo.toml 檔案:
cargo add google-cloud-speech-v2 google-cloud-gax
新增 mockall 和 tokio 做為開發依附元件:
cargo add --dev mockall
cargo add --dev tokio --features macros,rt-multi-thread
模擬用戶端
如要測試程式碼,而不進行網路呼叫,請在模擬結構體上實作服務的虛設常式特徵,並設定其預期。接著,使用 from_stub 建構用戶端,並傳遞至應用程式函式:
新增
use別名,縮短 Crate 名稱:編寫應用程式函式,接受
Speech用戶端的參照、呼叫get_recognizer,並處理伺服器回應:使用
mockall::mock!定義實作speech::stub::Speech特徵的模擬結構體:在測試中建立模擬例項。
mockall::mock!巨集會在結構體名稱前加上Mock,建立MockSpeech:設定模擬物件的預期行為,驗證傳入的要求欄位,並傳回模擬的
Recognizer回應:使用
Speech::from_stub從模擬物件建構Speech用戶端:使用模擬用戶端呼叫應用程式函式:
驗證傳回的值:
模擬錯誤
如要測試錯誤處理,請將模擬預期設為傳回以 Error::service 建構的 Err:
完整程式碼
以下範例將成功和錯誤單元測試合併為完整的測試模組:
執行 cargo test 即可執行單元測試:
cargo test