Struct MockIgdServer 

pub struct MockIgdServer { /* private fields */ }

A mock UPnP IGD server for testing.

Implementations

impl MockIgdServer

pub async fn start() -> Result<Self>

Start a new mock IGD server on a random available port.

pub fn builder() -> MockIgdServerBuilder

Create a builder for configuring the server.

pub fn url(&self) -> String

Get the URL of the HTTP server (for SOAP requests).

pub fn control_url(&self) -> String

Get the control URL for SOAP actions.

pub fn description_url(&self) -> String

Get the device description URL.

pub fn http_addr(&self) -> SocketAddr

Get the HTTP server address.

pub fn ssdp_addr(&self) -> Option<SocketAddr>

Get the SSDP server address (if enabled).

pub async fn mock( &self, action: impl Into<Action>, responder: impl Into<Responder>, )

Register a mock for the given action.

pub async fn mock_with_priority( &self, action: impl Into<Action>, responder: impl Into<Responder>, priority: u32, )

Register a mock with a specific priority (higher = checked first).

pub async fn mock_with_times( &self, action: impl Into<Action>, responder: impl Into<Responder>, times: u32, )

Register a mock that only matches a limited number of times.

pub async fn clear_mocks(&self)

Clear all registered mocks.

pub async fn received_requests(&self) -> Vec<ReceivedRequest>

Get all received requests.

Returns a list of all SOAP requests received by the server. Useful for verifying that expected requests were made.

Example

let requests = server.received_requests().await;
assert_eq!(requests.len(), 1);
assert_eq!(requests[0].action_name, "GetExternalIPAddress");

pub async fn clear_received_requests(&self)

Clear all received requests.

pub async fn received_ssdp_requests(&self) -> Vec<ReceivedSsdpRequest>

Get all received SSDP requests (M-SEARCH).

Returns a list of all SSDP M-SEARCH requests received by the server. Useful for verifying device discovery behavior.

Example

let requests = server.received_ssdp_requests().await;
assert_eq!(requests.len(), 1);
assert_eq!(requests[0].search_target, "ssdp:all");

pub async fn clear_received_ssdp_requests(&self)

Clear all received SSDP requests.

pub fn shutdown(self)

Shutdown the server.

Trait Implementations

impl Drop for MockIgdServer

fn drop(&mut self)

Executes the destructor for this type.