Struct tor_rtmock::net::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 TcpProvider 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 copy 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 TcpProvider for MockNetProvider

type TcpStream = LocalStream

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

type TcpListener = MockNetListener

The type for the TCP 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 TCP connection to a given socket address.

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

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

Open a TCP listener on a given socket address.

impl<R: Runtime> TlsProvider<<MockNetProvider as TcpProvider>::TcpStream> for MockNetRuntime<R>

type Connector = <MockNetProvider as TlsProvider<<MockNetProvider as TcpProvider>::TcpStream>>::Connector

The Connector object that this provider can return.

type TlsStream = <MockNetProvider as TlsProvider<<MockNetProvider as TcpProvider>::TcpStream>>::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.

impl TlsProvider<<MockNetProvider as TcpProvider>::TcpStream> for MockRuntime

type Connector = <MockNetProvider as TlsProvider<<MockNetProvider as TcpProvider>::TcpStream>>::Connector

The Connector object that this provider can return.

type TlsStream = <MockNetProvider as TlsProvider<<MockNetProvider as TcpProvider>::TcpStream>>::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.

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.

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