Struct MockServer 

pub struct MockServer { /* private fields */ }

A mock server that can be embedded in tests

The mock server supports dynamically adding stubs at runtime after the server has started. Stubs added via stub_response() or add_stub() will be served by a fallback handler that matches requests against the stub store.

Implementations

impl MockServer

pub const fn new() -> MockServerBuilder

Create a new mock server builder

pub async fn start(&mut self) -> Result<()>

Start the mock server

pub async fn stop(self) -> Result<()>

Stop the mock server

pub async fn stub_response( &mut self, method: impl Into<String>, path: impl Into<String>, body: Value, ) -> Result<()>

Stub a response for a given method and path

pub async fn add_stub(&mut self, stub: ResponseStub) -> Result<()>

Add a response stub

Stubs can be added before or after the server starts. Stubs added after start are served via a fallback handler.

pub async fn clear_stubs(&mut self) -> Result<()>

Remove all stubs

pub const fn port(&self) -> u16

Get the server port

pub fn url(&self) -> String

Get the server base URL

Note: If the server is bound to 0.0.0.0 (all interfaces), this returns 127.0.0.1 as the host for client connections.

pub const fn is_running(&self) -> bool

Check if the server is running

Trait Implementations

impl Debug for MockServer

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for MockServer

fn default() -> Self

Returns the “default value” for a type.

impl Drop for MockServer

fn drop(&mut self)

Executes the destructor for this type.

impl Verification for MockServer

async fn verify( &self, pattern: &VerificationRequest, expected: VerificationCount, ) -> Result<VerificationResult, Error>

Verify requests against a pattern and count assertion

async fn verify_never( &self, pattern: &VerificationRequest, ) -> Result<VerificationResult, Error>

Verify that a request was never made

async fn verify_at_least( &self, pattern: &VerificationRequest, min: usize, ) -> Result<VerificationResult, Error>

Verify that a request was made at least N times

async fn verify_sequence( &self, patterns: &[VerificationRequest], ) -> Result<VerificationResult, Error>

Verify that requests occurred in a specific sequence