BDD trong Rust: Xây Web App Vững Chắc với Cucumber

Khi nhắc đến Rust trong phát triển web, những từ như blazing fast, memory safety, và zero-cost abstractions thường xuất hiện. Trình biên dịch khắt khe của Rust đảm bảo web service của bạn không bị data race hay null pointer exception. Nhưng làm thế nào để chắc chắn rằng ứng dụng web thực sự đáp ứng yêu cầu nghiệp vụ?

Câu trả lời là Behavior-Driven Development (BDD) và framework Cucumber cho Rust (crate cucumber).

Bằng cách kết hợp hiệu năng backend mạnh mẽ của Rust với spec dễ đọc của Cucumber, đội ngũ có thể xây dựng web app vừa vững chắc về cấu trúc vừa chính xác về chức năng.

Cucumber trong Rust là gì?#

Cucumber là framework BDD phổ biến cho phép bạn viết kịch bản test bằng ngôn ngữ tự nhiên, dễ hiểu với cú pháp Gherkin (Given-When-Then).

Trong hệ sinh thái Rust, crate cucumber hoạt động như một test harness runner. Nó phân tích file .feature và ánh xạ trực tiếp đến các hàm Rust bất đồng bộ (step definitions). Bạn có được cả hai:

Spec hướng business, có thể thực thi được.
Sự an toàn, tốc độ, và đồng thời của code Rust thuần.

Tại sao dùng Rust và Cucumber cho Web?#

Living Documentation: File feature là tài liệu sống mà product owner, QA, và developer đều đọc và hiểu được.
Tin cậy cả Compile lẫn Runtime: Rust bắt lỗi bộ nhớ và kiểu dữ liệu tại compile time, Cucumber đảm bảo logic ứng dụng khớp với luồng công việc thực tế.
Async Native: Các web framework Rust hiện đại (Axum, Actix-web, Warp) đều bất đồng bộ. Cucumber cho Rust hỗ trợ async/await tự nhiên, giúp test HTTP endpoint và database gọi dễ dàng.

Hướng dẫn từng bước: Cài đặt Cucumber trong dự án Rust Web#

Hãy cùng thiết lập cơ bản để test một API route web với Rust và Cucumber.

1. Cấu hình Cargo.toml#

Đầu tiên, thêm dependencies. Bạn cần cucumber, async runtime như tokio, và một cách để gửi HTTP request đến web server (như reqwest).

[package]
name = "rust_web_bdd"
version = "0.1.0"
edition = "2021"

[[test]]
name = "cucumber"
harness = false

[dependencies]
axum = "0.7"
tokio = { version = "1.0", features = ["full"] }
serde = { version = "1.0", features = ["derive"] }

[dev-dependencies]
cucumber = "0.20"
reqwest = { version = "0.11", features = ["json"] }

toml

2. Viết File Feature Gherkin#

Tạo thư mục tests/features/ và thêm file user_api.feature:

Feature: User Management API
  As a client of the web service
  I want to register a new user
  So that I can access protected resources

  Scenario: Successfully registering a new user
    Given the web server is running
    When I send a POST request to "/users" with username "alice"
    Then the response status should be 201
    And the response body should contain "User alice created successfully"

gherkin

3. Triển khai World và Step Definitions#

“World” trong Cucumber đại diện cho trạng thái chia sẻ giữa các scenario. Tạo tests/cucumber.rs:

use cucumber::{given, when, then, World};
use reqwest::Client;

#[derive(Debug, World)]
#[world(init)]
pub struct ApiWorld {
    client: Client,
    server_url: String,
    status_code: Option<u16>,
    response_body: Option<String>,
}

#[given("the web server is running")]
async fn server_is_running(world: &mut ApiWorld) {
    world.client = Client::new();
    world.server_url = "http://127.0.0.1:8080".to_string();
}

#[when(expr = "I send a POST request to {string} with username {string}")]
async fn send_post_request(world: &mut ApiWorld, path: String, username: String) {
    let url = format!("{}{}", world.server_url, path);
    let res = world.client
        .post(&url)
        .json(&serde_json::json!({ "username": username }))
        .send()
        .await
        .expect("Failed to execute request");

    world.status_code = Some(res.status().as_u16());
    world.response_body = Some(res.text().await.unwrap_or_default());
}

#[then(expr = "the response status should be {int}")]
async fn verify_status_code(world: &mut ApiWorld, expected_status: u16) {
    assert_eq!(world.status_code, Some(expected_status));
}

#[then(expr = "the response body should contain {string}")]
async fn verify_response_body(world: &mut ApiWorld, expected_text: String) {
    let body = world.response_body.as_ref().expect("No response body");
    assert!(body.contains(&expected_text));
}

#[tokio::main]
async fn main() {
    ApiWorld::cucumber()
        .run("tests/features/user_api.feature")
        .await;
}

rust

4. Chạy BDD Tests#

Chạy test suite với Cargo:

cargo test --test cucumber

bash

Cucumber sẽ phân tích kịch bản Gherkin, giao tiếp với ứng dụng Rust và hiển thị kết quả xanh!

Best Practices cho Rust BDD#

Cô lập State: Đảm bảo World struct reset sạch giữa các scenario. Nếu dùng database, spin up container tạm (qua Testcontainers-rs) hoặc dùng transaction rollback cho mỗi scenario.
Step Tái sử dụng: Thiết kế Gherkin steps với tham số (dùng {string} hoặc {int}) để dùng chung cho nhiều endpoint thay vì viết step mới cho từng route.
Xử lý async gọn gàng: Tận dụng Tokio multi-threaded runtime bên trong step definitions để xử lý concurrent web request dễ dàng.

Kết luận#

Xây dựng web app với Rust cho bạn hiệu năng và độ tin cậy vượt trội. Tích hợp Cucumber framework giúp kết nối khoảng cách giữa thực thi kỹ thuật và yêu cầu nghiệp vụ, đảm bảo web service của bạn không chỉ nhanh và an toàn — mà còn làm đúng việc cần làm.