remoc 0.18.3

🦑 Remote multiplexed objects, channels, observable collections and RPC making remote interactions seamless. Provides multiple remote channels and RPC over TCP, TLS or any other transport.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42

//! A channel that exchanges values of arbitrary type with a remote endpoint and
//! is established by sending exactly one half of it over an existing channel.
//!
//! This is a lighter and more restricted version of an [MPSC channel](super::mpsc).
//! It does not spawn a task per connected channel, but forwarding is not supported
//! and exactly one half of the channel must be sent to a remote endpoint.

use std::sync::{Arc, Mutex};

mod receiver;
mod sender;

use super::{
    DEFAULT_MAX_ITEM_SIZE,
    interlock::{Interlock, Location},
};
pub use receiver::{Receiver, RecvError};
pub use sender::{SendError, SendErrorKind, Sender};

/// Creates a new local/remote channel that is established by sending either the sender or receiver
/// over a remote channel.
pub fn channel<T, Codec>() -> (Sender<T, Codec>, Receiver<T, Codec>) {
    let (sender_tx, sender_rx) = tokio::sync::mpsc::unbounded_channel();
    let (receiver_tx, receiver_rx) = tokio::sync::mpsc::unbounded_channel();
    let interlock = Arc::new(Mutex::new(Interlock { sender: Location::Local, receiver: Location::Local }));

    let sender = Sender {
        sender: None,
        sender_rx,
        receiver_tx: Some(receiver_tx),
        interlock: interlock.clone(),
        max_item_size: DEFAULT_MAX_ITEM_SIZE,
    };
    let receiver = Receiver {
        receiver: None,
        sender_tx: Some(sender_tx),
        receiver_rx,
        interlock,
        max_item_size: DEFAULT_MAX_ITEM_SIZE,
    };
    (sender, receiver)
}