Struct MockNetProvider

pub struct MockNetProvider { /* private fields */ }

A view of a single host’s access to a MockNetwork.

Each simulated host has its own addresses that it’s allowed to listen on, and a reference to the network.

This type implements NetStreamProvider for SocketAddr so that it can be used as a drop-in replacement for testing code that uses the network.

Limitations

There’s no randomness here, so we can’t simulate the weirdness of real networks.

So far, there’s no support for DNS or UDP.

We don’t handle localhost specially, and we don’t simulate providers that can connect to some addresses but not all.

We don’t do the right thing (block) if there is a listener that never calls accept.

UDP is completely broken: datagrams appear to be transmitted, but will never be received. And local address assignment is not implemented so .local_addr() can return NONE

We use a simple u16 counter to decide what arbitrary port numbers to use: Once that counter is exhausted, we will fail with an assertion. We don’t do anything to prevent those arbitrary ports from colliding with specified ports, other than declare that you can’t have two listeners on the same addr:port at the same time.

We pretend to provide TLS, but there’s no actual encryption or authentication.

Implementations

impl MockNetProvider

pub fn listen_tls( &self, addr: &SocketAddr, tls_cert: Vec<u8>, ) -> IoResult<MockNetListener>

Create a mock TLS listener with provided certificate.

Note that no encryption or authentication is actually performed! Other parties are simply told that their connections succeeded and were authenticated against the given certificate.

Trait Implementations

impl Clone for MockNetProvider

fn clone(&self) -> MockNetProvider

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for MockNetProvider

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

Formats the value using the given formatter.

impl Default for MockNetProvider

fn default() -> Self

Returns the “default value” for a type.

impl NetStreamProvider for MockNetProvider

type Stream = LocalStream

The type for the connections returned by Self::connect().

type Listener = MockNetListener

The type for the listeners returned by Self::listen().

fn connect<'life0, 'life1, 'async_trait>( &'life0 self, addr: &'life1 SocketAddr, ) -> Pin<Box<dyn Future<Output = IoResult<LocalStream>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Launch a connection connection to a given socket address.

fn listen<'life0, 'life1, 'async_trait>( &'life0 self, addr: &'life1 SocketAddr, ) -> Pin<Box<dyn Future<Output = IoResult<Self::Listener>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Open a listener on a given socket address.

impl<R: Runtime> TlsProvider<<MockNetProvider as NetStreamProvider>::Stream> for MockNetRuntime<R>

type Connector = <MockNetProvider as TlsProvider<<MockNetProvider as NetStreamProvider>::Stream>>::Connector

The Connector object that this provider can return.

type TlsStream = <MockNetProvider as TlsProvider<<MockNetProvider as NetStreamProvider>::Stream>>::TlsStream

The type of the stream returned by that connector.

fn tls_connector(&self) -> Self::Connector

Return a TLS connector for use with this runtime.

fn supports_keying_material_export(&self) -> bool

Return true iff the keying material exporters (RFC 5705) is supported.

impl TlsProvider<<MockNetProvider as NetStreamProvider>::Stream> for MockRuntime

type Connector = <MockNetProvider as TlsProvider<<MockNetProvider as NetStreamProvider>::Stream>>::Connector

The Connector object that this provider can return.

type TlsStream = <MockNetProvider as TlsProvider<<MockNetProvider as NetStreamProvider>::Stream>>::TlsStream

The type of the stream returned by that connector.

fn tls_connector(&self) -> Self::Connector

Return a TLS connector for use with this runtime.

fn supports_keying_material_export(&self) -> bool

Return true iff the keying material exporters (RFC 5705) is supported.

impl TlsProvider<LocalStream> for MockNetProvider

type Connector = MockTlsConnector

The Connector object that this provider can return.

type TlsStream = MockTlsStream

The type of the stream returned by that connector.

fn tls_connector(&self) -> MockTlsConnector

Return a TLS connector for use with this runtime.

fn supports_keying_material_export(&self) -> bool

Return true iff the keying material exporters (RFC 5705) is supported.

impl UdpProvider for MockNetProvider

type UdpSocket = MockUdpSocket

The type of Udp Socket returned by Self::bind()

fn bind<'life0, 'life1, 'async_trait>( &'life0 self, addr: &'life1 SocketAddr, ) -> Pin<Box<dyn Future<Output = IoResult<MockUdpSocket>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Bind a local port to send and receive packets from