Struct MockServerBuilder 

pub struct MockServerBuilder { /* private fields */ }

Builder for creating and configuring mock servers

Implementations

impl MockServerBuilder

pub const fn new() -> Self

Create a new mock server builder

pub const fn port(self, port: u16) -> Self

Set the HTTP port

pub const fn auto_port(self) -> Self

Automatically discover an available port

By default, uses port 0 which lets the OS assign any available ephemeral port. This is atomic and avoids race conditions in parallel tests.

Use port_range() if you need ports within a specific range.

pub const fn port_range(self, start: u16, end: u16) -> Self

Set the port range for automatic port discovery

When set, auto_port() will scan this range for an available port instead of using OS-assigned ports.

Note: Scanning a range has a small TOCTOU race condition. For parallel tests, prefer using auto_port() without a range.

pub fn host(self, host: impl Into<String>) -> Self

Set the host address

pub fn config_file(self, path: impl Into<PathBuf>) -> Self

Load configuration from a YAML file

pub fn openapi_spec(self, path: impl Into<PathBuf>) -> Self

Load routes from an OpenAPI specification

pub fn latency(self, profile: LatencyProfile) -> Self

Set the latency profile for simulating network delays

pub fn failures(self, config: FailureConfig) -> Self

Enable failure injection with configuration

pub fn proxy(self, config: ProxyConfig) -> Self

Enable proxy mode with configuration

pub const fn admin(self, enabled: bool) -> Self

Enable admin API

pub const fn admin_port(self, port: u16) -> Self

Set admin API port

pub async fn start(self) -> Result<MockServer>

Start the mock server

Trait Implementations

impl Default for MockServerBuilder

fn default() -> Self

Returns the “default value” for a type.