A Rust Load Testing framework with real-time tui support.
rlt provides a simple way to create load test tools in Rust. It is designed to be a universal load test framework, which means you can use rlt for various services, such as Http, gRPC, Thrift, Database, or other customized services.
- Flexible: Customize the work load with your own logic.
- Easy to use: Little boilerplate code, just focus on testing.
- Rich Statistics: Collect and display rich statistics.
- High performance: Optimized for performance and resource usage.
- Real-time TUI: Monitor testing progress with a powerful real-time TUI.
Run cargo add rlt to add rlt as a dependency to your Cargo.toml:
[dependencies]
rlt = "0.1.1"
Then create your bench suite by implementing the BenchSuite trait. flatten attribute can be used to embed the predefined BenchCli into your own.
#[derive(Parser, Clone)]
pub struct HttpBench {
/// Target URL.
pub url: Url,
/// Embed BenchCli into this Opts.
#[command(flatten)]
pub bench_opts: BenchCli,
}
#[async_trait]
impl BenchSuite for HttpBench {
type WorkerState = Client;
async fn state(&self, _: u32) -> Result<Self::WorkerState> {
Ok(Client::new())
}
async fn bench(&mut self, client: &mut Self::WorkerState, _: &IterInfo) -> Result<IterReport> {
let t = Instant::now();
let resp = client.get(self.url.clone()).send().await?;
let status = resp.status().into();
let bytes = resp.bytes().await?.len() as u64;
let duration = t.elapsed();
Ok(IterReport { duration, status, bytes, items: 1 })
}
}
You can also create a separate struct to hold the cli options for more flexibility. There is an example in examples/http_hyper.rs.
Finally, create the main function to run the load test:
#[tokio::main]
async fn main() -> Result<()> {
let bs = HttpBench::parse();
rlt::cli::run(bs.bench_opts, bs).await
}
More examples can be found in the examples directory.
The TUI layout in rlt is inspired by oha.
rlt is distributed under the terms of both the MIT License and the Apache License 2.0.
See the LICENSE-APACHE and LICENSE-MIT files for license details.
2.1k Jan 3, 2023
40 Nov 23, 2022
17 Dec 18, 2022
629 Jun 14, 2023
5 Jun 28, 2023
148 Oct 10, 2023
26 Oct 10, 2023
120 Dec 3, 2022
6 Dec 10, 2022
72 Dec 31, 2022
3 Feb 14, 2024
9 Mar 27, 2024
14 Apr 1, 2023
16 Sep 8, 2022
0 Nov 14, 2022
4 Nov 17, 2022
18 Sep 23, 2024
7 Dec 21, 2022
29 Oct 9, 2023