IPCBuilder

Struct IPCBuilder 

Source
pub struct IPCBuilder { /* private fields */ }
Expand description

A builder for the IPC server or client.

use typemap_rev::TypeMapKey;
use rmp_ipc::IPCBuilder;

struct CustomKey;

impl TypeMapKey for CustomKey {
    type Value = String;
}

IPCBuilder::new()
    .address("127.0.0.1:2020")
   // register callback
    .on("ping", |_ctx, _event| Box::pin(async move {
        println!("Received ping event.");
        Ok(())
    }))
    // register a namespace    
    .namespace("namespace")
    .on("namespace-event", |_ctx, _event| Box::pin(async move {
        println!("Namespace event.");
        Ok(())
    }))
    .build()
    // add context shared data
    .insert::<CustomKey>("Hello World".to_string())
    // can also be build_client which would return an emitter for events
    .build_server().await.unwrap();

Implementations§

Source§

impl IPCBuilder

Source

pub fn new() -> Self

Source

pub fn insert<K: TypeMapKey>(self, value: K::Value) -> Self

Adds globally shared data

Source

pub fn on<F>(self, event: &str, callback: F) -> Self
where F: for<'a> Fn(&'a Context, Event) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'a>> + Send + Sync + 'static,

Adds an event callback

Source

pub fn address<S: ToString>(self, address: S) -> Self

Adds the address to connect to

Source

pub fn namespace<S: ToString>(self, name: S) -> NamespaceBuilder

Adds a namespace

Source

pub fn add_namespace(self, namespace: Namespace) -> Self

Adds a namespace to the ipc server

Source

pub async fn build_server(self) -> Result<()>

Builds an ipc server

Source

pub async fn build_client(self) -> Result<Context>

Builds an ipc client

Source

pub async fn build_pooled_client( self, pool_size: usize, ) -> Result<PooledContext>

Builds a pooled IPC client This causes the builder to actually create pool_size clients and return a crate::context::PooledContext that allows one to crate::context::PooledContext::acquire a single context to emit events.

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T> Instrument for T

Source§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
Source§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<T> WithSubscriber for T

Source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
Source§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more