A test harness for writing integration / regression tests in Rust.
Its main goals are to provide all of the basic test harness functionality to bootstrap your test case, so that you can just focus on writing the tests.
This includes: - Logging (already set up with a unique workspace directory created for your test) - Configuration parameters - Setting up a test workspace directory - Managing artifacts (provide methods to attach artifacts to the test result) - Submit test results to external webhook easily - Derive test status code from error return values - Useful utilities
NOTE This project is WIP and not ready for production use.
This is a complete example (see https://github.com/stevepryde/kevlar-example).
NOTE It is still WIP. I plan to remove a lot of boilerplate and shrink this down as much as possible. Both synchronous and asyncronous tests are supported.
```rust use kevlar::{ConfigType, TestConfig, TestHarness, TestStatus, TestResult, AsyncTestCase}; use std::path::PathBuf; use asynctrait::asynctrait; use fantoccini::Client; use log::*;
async fn main() -> Result<(), String>{ let harness = TestHarness::new( "kevlarexample", ConfigType::File(PathBuf::from("./config.json")), ); let mytest = MyTest::default(); harness.runasync(mytest).await; Ok(()) }
struct MyTest { internal_data: String, }
impl AsyncTestCase for MyTest { async fn runasync(&mut self, _testconfig: TestConfig, testresult: &mut TestResult) -> TestStatus { // TODO: update return value to be a Result with custom error type that also understands CmdError match self.dostuff().await { Ok() => TestStatus::Passed, Err(_) => TestStatus::Failed } } }
impl MyTest { async fn dostuff(&mut self) -> Result<(), fantoccini::error::CmdError> { debug!("Load browser at localhost:4444"); // Some example code taken from fantoccini project. let mut c = Client::new("http://localhost:4444").await.expect("failed to start session"); info!("Load wikipedia"); c.goto("https://en.wikipedia.org/wiki/Foobar").await?; self.internaldata = c.currenturl().await?.tostring(); asserteq!(self.internaldata, "https://en.wikipedia.org/wiki/Foobar"); c.close().await?; Ok(()) } } ```
and much more!