An implementation of the [Cucumber] testing framework for Rust. Fully native, no external test runners or dependencies.
Describe testing scenarios in .feature files:
```gherkin
Feature: Eating too much cucumbers may not be good for you
Scenario: Eating a few isn't a problem Given Alice is hungry When she eats 3 cucumbers Then she is full ```
Implement World trait and describe steps:
```rust
//! tests/readme.rs
use std::{convert::Infallible, time::Duration};
use asynctrait::asynctrait; use cucumber::{given, then, when, WorldInit}; use tokio::time::sleep;
struct World {
user: Option
impl cucumber::World for World { type Error = Infallible;
async fn new() -> Result<Self, Self::Error> {
Ok(Self { user: None, capacity: 0 })
}
}
async fn someoneishungry(w: &mut World, user: String) { sleep(Duration::from_secs(2)).await;
w.user = Some(user);
}
async fn eatcucumbers(w: &mut World, count: usize) { sleep(Duration::fromsecs(2)).await;
w.capacity += count;
assert!(w.capacity < 4, "{} exploded!", w.user.as_ref().unwrap());
}
async fn isfull(w: &mut World) { sleep(Duration::fromsecs(2)).await;
assert_eq!(w.capacity, 3, "{} isn't full!", w.user.as_ref().unwrap());
}
async fn main() { World::run("tests/features/readme").await; } ```
Add test to Cargo.toml:
toml
[[test]]
name = "readme"
harness = false # allows Cucumber to print output instead of libtest
For more examples check out the Book (current | edge).
macros (default): Enables step attributes and auto-wiring.timestamps: Enables timestamps collecting for all [Cucumber] events.The full gamut of Cucumber's [Gherkin] language is implemented by the gherkin-rust crate. Most features of the [Gherkin] language are parsed already and accessible via the relevant structs.
Scenario Outline is treated the same as Outline or Example in the parser (gherkin/#19).This project is licensed under either of
at your option.