Struct trillium_testing::TestTransport

pub struct TestTransport {
    pub read: Arc<CloseableCursor>,
    pub write: Arc<CloseableCursor>,
}

a readable and writable transport for testing

Fields

read: Arc<CloseableCursor>

the read side of this transport

write: Arc<CloseableCursor>

the write side of this transport

Implementations

impl TestTransport

pub fn new() -> (TestTransport, TestTransport)

constructs a new test transport pair, representing two ends of a connection. either of them can be written to, and the content will be readable from the other. either of them can also be closed.

pub fn close(&mut self)

close this transport, representing a disconnection

pub fn snapshot(&self) -> Vec<u8>

take an owned snapshot of the received data

pub fn write_all(&self, bytes: impl AsRef<[u8]>)

synchronously append the supplied bytes to the write side of this transport, notifying the read side of the other end

pub async fn read_available(&self) -> Vec<u8>

waits until there is content and then reads that content to a vec until there is no further content immediately available

pub async fn read_available_string(&self) -> String

waits until there is content and then reads that content to a string until there is no further content immediately available

Trait Implementations

impl AsyncRead for TestTransport

where Self: Unpin,

fn poll_read( self: Pin<&mut Self>, cx: &mut Context<'_>, buf: &mut [u8], ) -> Poll<Result<usize>>

Attempt to read from the AsyncRead into buf.

fn poll_read_vectored( self: Pin<&mut Self>, cx: &mut Context<'_>, bufs: &mut [IoSliceMut<'_>], ) -> Poll<Result<usize>>

Attempt to read from the AsyncRead into bufs using vectored IO operations.

impl AsyncWrite for TestTransport

where Self: Unpin,

fn poll_write( self: Pin<&mut Self>, cx: &mut Context<'_>, buf: &[u8], ) -> Poll<Result<usize>>

Attempt to write bytes from buf into the object.

fn poll_flush(self: Pin<&mut Self>, cx: &mut Context<'_>) -> Poll<Result<()>>

Attempt to flush the object, ensuring that any buffered data reach their destination.

fn poll_close(self: Pin<&mut Self>, cx: &mut Context<'_>) -> Poll<Result<()>>

Attempt to close the object.

fn poll_write_vectored( self: Pin<&mut Self>, cx: &mut Context<'_>, bufs: &[IoSlice<'_>], ) -> Poll<Result<usize>>

Attempt to write bytes from bufs into the object using vectored IO operations.

impl Clone for TestTransport

fn clone(&self) -> TestTransport

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for TestTransport

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

Formats the value using the given formatter.

impl Default for TestTransport

fn default() -> TestTransport

Returns the “default value” for a type.

impl Drop for TestTransport

fn drop(&mut self)

Executes the destructor for this type.

impl Transport for TestTransport

fn set_linger(&mut self, linger: Option<Duration>) -> Result<(), Error>

Sets the linger duration of this transport by setting the SO_LINGER option

fn set_nodelay(&mut self, nodelay: bool) -> Result<(), Error>

Sets the value of the TCP_NODELAY option on this transport.

fn set_ip_ttl(&mut self, ttl: u32) -> Result<(), Error>

Sets the value for the IP_TTL option on this transport.

fn peer_addr(&self) -> Result<Option<SocketAddr>, Error>

Returns the socket address of the remote peer of this transport.