Crate httpress 

httpress

A fast HTTP benchmarking library built in Rust.

httpress provides a simple yet powerful API for load testing HTTP services. It supports concurrent requests, rate limiting, custom request generation, and hooks for metrics collection.

Quick Start

use httpress::{Benchmark, Result};
use std::time::Duration;

#[tokio::main]
async fn main() -> Result<()> {
    let results = Benchmark::builder()
        .url("http://localhost:3000")
        .concurrency(50)
        .duration(Duration::from_secs(10))
        .build()?
        .run()
        .await?;

    results.print();
    Ok(())
}

Features

• Simple API: Builder pattern for easy configuration
• Flexible Rate Control: Fixed rates or dynamic rate functions
• Custom Request Generation: Generate requests dynamically per-worker
• Hook System: Inject custom logic before/after requests
• Detailed Metrics: Latency percentiles, throughput, status codes

Re-exports

pub use benchmark::Benchmark;

pub use benchmark::BenchmarkBuilder;

pub use config::AfterRequestContext;

pub use config::AfterRequestHook;

pub use config::BeforeRequestContext;

pub use config::BeforeRequestHook;

pub use config::HookAction;

pub use config::HttpMethod;

pub use config::RateContext;

pub use config::RateFunction;

pub use config::RequestConfig;

pub use config::RequestContext;

pub use config::RequestGenerator;

pub use config::RequestSource;

pub use error::Error;

pub use error::Result;

pub use metrics::BenchmarkResults;

Modules

benchmark

Benchmark runner and builder.

cli

client

config

Configuration types and contexts for benchmarks.

error

Error types for httpress.

executor

metrics

Benchmark results and metrics.

progress

Progress reporting types and indicatif rendering.