Skip to main content

Crate rustress

Crate rustress 

Source
Expand description

RuStress — a high-performance load testing engine with an interactive terminal dashboard.

The crate is published as both a library and a binary. The library exposes the full load-generation stack so it can be embedded or driven programmatically; the rustress binary is a thin CLI shell over it.

§Subsystems

ModuleResponsibility
coreDomain types, configuration, and the error boundary
metricsLock-free counters and HDR latency histograms
templatesPer-request value injection and file-backed data
runnerOpen-loop (RPS) and closed-loop (Users) load scheduling
tuiInteractive ratatui dashboard
exportCSV / JSON / summary report writers
dummyBuilt-in target HTTP server for self-testing
cliArgument definitions and subcommand dispatch

§Example

use rustress::core::Config;
use rustress::runner::LoadEngine;
use tokio::sync::mpsc;

let cfg = Config {
    url: "http://127.0.0.1:8080/fast".into(),
    target_rps: 200,
    steady_dur_secs: 10,
    ..Default::default()
};
let (tx, _rx) = mpsc::channel(rustress::core::constants::STATS_CHANNEL_CAPACITY);
let engine = LoadEngine::new(cfg, tx)?;
engine.run(tokio_util::sync::CancellationToken::new()).await;

Re-exports§

pub use core::config::Config;
pub use core::config::Mode;
pub use core::result::ExperimentResult;
pub use core::snapshot::StatsSnapshot;
pub use runner::LoadEngine;

Modules§

cli
Command-line surface: argument definitions and subcommand dispatch.
core
Core domain types, configuration, and error boundaries.
dummy
Built-in target HTTP server used to exercise RuStress without external services.
export
Report generation — CSV, JSON, and summary exports.
metrics
Lock-free metric accumulation and latency histogram storage.
runner
Load generation engine: open-loop (RPS) and closed-loop (Users) scheduling.
templates
Request templating: per-request value injection and file-backed data sources.
tui
Interactive terminal dashboard (ratatui + crossterm).