hydra 0.1.40

A framework for writing fault tolerant, highly scalable applications with the Rust programming language.
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
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81

use std::borrow::Cow;
use std::num::NonZeroU64;

use bincode::Decode;
use bincode::Encode;

use crate::Pid;
use crate::Reference;

/// The target process information for a send frame.
#[derive(Debug, Encode, Decode)]
pub enum SendTarget {
    Pid(NonZeroU64),
    Named(String),
    Alias(NonZeroU64),
}

/// The frame used to send a message to remote processes.
#[derive(Debug, Encode, Decode)]
pub struct Send {
    pub targets: Vec<SendTarget>,
    pub message: Vec<u8>,
}

impl Send {
    /// Constructs a new [Send] frame with the given message.
    pub fn with_message(message: Vec<u8>) -> Self {
        Self {
            targets: Vec::new(),
            message,
        }
    }

    /// Constructs a new [Send] frame with the given process id.
    pub fn with_pid(id: NonZeroU64, message: Vec<u8>) -> Self {
        Self {
            targets: vec![SendTarget::Pid(id)],
            message,
        }
    }

    /// Constructs a new [Send] frame with the given process name.
    pub fn with_name(name: String, message: Vec<u8>) -> Self {
        Self {
            targets: vec![SendTarget::Named(name)],
            message,
        }
    }

    /// Constructs a new [Send] frame with the given alias.
    pub fn with_alias(alias: NonZeroU64, message: Vec<u8>) -> Self {
        Self {
            targets: vec![SendTarget::Alias(alias)],
            message,
        }
    }
}

impl From<Pid> for SendTarget {
    fn from(value: Pid) -> Self {
        SendTarget::Pid(NonZeroU64::new(value.id()).unwrap())
    }
}

impl From<String> for SendTarget {
    fn from(value: String) -> Self {
        Self::Named(value)
    }
}

impl<'a> From<Cow<'a, str>> for SendTarget {
    fn from(value: Cow<'a, str>) -> Self {
        Self::Named(String::from(value))
    }
}

impl From<Reference> for SendTarget {
    fn from(value: Reference) -> Self {
        Self::Alias(NonZeroU64::new(value.id()).unwrap())
    }
}