Struct RuntimelessServer 

pub struct RuntimelessServer { /* private fields */ }

A Server for testing that does not depend on any runtime

Implementations

impl RuntimelessServer

pub fn is_empty() -> bool

returns whether there are any currently registered servers

pub fn len() -> usize

returns the number of currently registered servers

Trait Implementations

impl Debug for RuntimelessServer

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

Formats the value using the given formatter.

impl Server for RuntimelessServer

type Runtime = RuntimelessRuntime

The RuntimeTrait for this Server.

type Transport = TestTransport

the individual byte stream that http will be communicated over. This is often an async “stream” like TcpStream or UnixStream. See Transport

type UdpTransport = ()

The async UDP socket type for this server. Used by QUIC adapters for HTTP/3 support. Runtimes that do not support UDP should set this to ().

fn runtime() -> Self::Runtime

Return this Server’s Runtime

async fn accept(&mut self) -> Result<Self::Transport>

Asynchronously return a single Self::Transport from a Self::Listener. Must be implemented.

fn from_host_and_port(host: &str, port: u16) -> Self

Build a listener from the config. The default logic for this is described elsewhere. To override the default logic, server implementations could potentially implement this directly. To use this default logic, implement Server::from_tcp and Server::from_unix.

async fn clean_up(self)

After the server has shut down, perform any housekeeping, eg unlinking a unix socket.

fn init(&self, info: &mut Info)

Populate Info with data from this server, such as the bound socket address. Called during server startup before any connections are accepted.

fn from_tcp(tcp_listener: TcpListener) -> Self

Build a Self::Listener from a tcp listener. This is called by the Server::from_host_and_port default implementation, and is mandatory if the default implementation is used.

fn from_unix(unix_listener: UnixListener) -> Self

Available on Unix only.

Build a Self from a unix listener. This is called by the Server::from_host_and_port default implementation. You will want to tag an implementation of this with #[cfg(unix)].

fn handle_signals(_swansong: Swansong) -> impl Future<Output = ()> + Send

Implementation hook for listening for any os signals and stopping the provided Swansong. The returned future will be spawned using RuntimeTrait::spawn