Crate trillium_server_common

Utilities and traits for building trillium runtime adapters

Trillium applications should never need to depend directly on this library. Server adapters should reexport any types from this crate that an application author would need to use.

The parts of this crate that are not application facing should be expected to change more frequently than the parts that are application facing.

If you are depending on this crate for private code that cannot be discovered through docs.rs’ reverse dependencies, please open an issue.

Re-exports

pub use url;

Structs

CloneCounter

an atomic counter that increments on clone & decrements on drop

CloneCounterObserver

An observer that can be cloned without modifying the clone counter, but can be used to inspect its state and awaited

Config

Primary entrypoint for configuring and running a trillium server

ServerHandle

A handle for a spawned trillium server. Returned by Config::handle and Config::spawn

Stopper

This struct provides a synchronized mechanism for canceling Futures and Streams.

Url

A parsed URL record.

Enums

Binding

A wrapper enum that has blanket implementations for common traits like TryFrom, Stream, AsyncRead, and AsyncWrite. This can contain listeners (like TcpListener), Streams (like Incoming), or bytestreams (like TcpStream).

Traits

Acceptor

This trait provides the common interface for server-side tls acceptors, abstracting over various implementations

AsyncRead

Read bytes asynchronously.

AsyncWrite

Write bytes asynchronously.

ConfigExt

Server-implementer interfaces to Config

Connector

Interface for runtime and tls adapters for the trillium client

ObjectSafeConnector

Server

The server trait, for standard network-based server implementations.

Transport

The interface that the http protocol is communicated over.

Attribute Macros

async_trait