Trait tor_rtcompat::Runtime

pub trait Runtime:
    Sync
    + Send
    + Spawn
    + BlockOn
    + Clone
    + SleepProvider
    + CoarseTimeProvider
    + TcpProvider
    + TlsProvider<Self::TcpStream>
    + UdpProvider
    + Debug
    + 'static { }

A runtime that we can use to run Tor as a client.

This trait comprises several other traits that we require all of our runtimes to provide:

• [futures::task::Spawn] to launch new background tasks.
• SleepProvider to pause a task for a given amount of time.
• CoarseTimeProvider for a cheaper but less accurate notion of time.
• TcpProvider to launch and accept TCP connections.
• TlsProvider to launch TLS connections.
• BlockOn to block on a future and run it to completion (This may become optional in the future, if/when we add WASM support).

We require that every Runtime has an efficient Clone implementation that gives a new opaque reference to the same underlying runtime.

Additionally, every Runtime is Send and Sync, though these requirements may be somewhat relaxed in the future.

At some future point, Arti may require that the runtime impl<S> TlsProvider<S> (for suitableS), rather than just for their own TcpStreams. I.e., Arti may start to require that the runtime’s TLS provider can wrap any streams, not only the runtime’s own TCP streams. This might be expressed as an additional supertrait bound on Runtime, eg when Rust supports GATs, or as an additional bound on the Arti APIs that currently use Runtime. For API future compatibility, if you impl Runtime for MyRuntime, you should also ensure that you

impl<S> TlsProvider<S> for MyRuntime
where S: futures::AsyncRead + futures::AsyncWrite + Unpin + Send + 'static

Perhaps we will need this if we make our own TLS connections through Tor, rather than just channels to guards.

Object Safety

This trait is not object safe.

Implementors

impl<T> Runtime for T

where T: Sync + Send + Spawn + BlockOn + Clone + SleepProvider + CoarseTimeProvider + TcpProvider + TlsProvider<Self::TcpStream> + UdpProvider + Debug + 'static,