wasmcloud-actor-extras 0.1.3

Interface to the extras contract for use by wasmCloud Actors
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
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135

extern crate rmp_serde as rmps;
use rmps::{Deserializer, Serializer};
use serde::{Deserialize, Serialize};
use std::io::Cursor;

#[cfg(feature = "guest")]
extern crate wapc_guest as guest;
#[cfg(feature = "guest")]
use guest::prelude::*;

#[cfg(feature = "guest")]
pub struct Host {
    binding: String,
}

#[cfg(feature = "guest")]
impl Default for Host {
    fn default() -> Self {
        Host {
            binding: "default".to_string(),
        }
    }
}

/// Creates a named host binding
#[cfg(feature = "guest")]
pub fn host(binding: &str) -> Host {
    Host {
        binding: binding.to_string(),
    }
}

/// Creates the default host binding
#[cfg(feature = "guest")]
pub fn default() -> Host {
    Host::default()
}

#[cfg(feature = "guest")]
impl Host {
    /// Request a Globally Unique Identifier
    pub fn request_guid(&self, req: GeneratorRequest) -> HandlerResult<GeneratorResult> {
        host_call(
            &self.binding,
            "wasmcloud:extras",
            "RequestGuid",
            &serialize(req)?,
        )
        .map(|vec| {
            let resp = deserialize::<GeneratorResult>(vec.as_ref()).unwrap();
            resp
        })
        .map_err(|e| e.into())
    }
    /// Request a random number with minimum and maximum parameters. Inclusivity depends
    /// on implementation and is not guaranteed on either end
    pub fn request_random(&self, req: GeneratorRequest) -> HandlerResult<GeneratorResult> {
        host_call(
            &self.binding,
            "wasmcloud:extras",
            "RequestRandom",
            &serialize(req)?,
        )
        .map(|vec| {
            let resp = deserialize::<GeneratorResult>(vec.as_ref()).unwrap();
            resp
        })
        .map_err(|e| e.into())
    }
    /// Request the next number in a monotonically increasing sequence, starting at 0
    pub fn request_sequence(&self, req: GeneratorRequest) -> HandlerResult<GeneratorResult> {
        host_call(
            &self.binding,
            "wasmcloud:extras",
            "RequestSequence",
            &serialize(req)?,
        )
        .map(|vec| {
            let resp = deserialize::<GeneratorResult>(vec.as_ref()).unwrap();
            resp
        })
        .map_err(|e| e.into())
    }
}

#[derive(Debug, PartialEq, Deserialize, Serialize, Default, Clone)]
pub struct GeneratorResult {
    #[serde(rename = "guid")]
    pub guid: Option<String>,
    #[serde(rename = "sequenceNumber")]
    pub sequence_number: u64,
    #[serde(rename = "random_number")]
    pub random_number: u32,
}

#[derive(Debug, PartialEq, Deserialize, Serialize, Default, Clone)]
pub struct GeneratorRequest {
    #[serde(rename = "guid")]
    pub guid: bool,
    #[serde(rename = "sequence")]
    pub sequence: bool,
    #[serde(rename = "random")]
    pub random: bool,
    #[serde(rename = "min")]
    pub min: u32,
    #[serde(rename = "max")]
    pub max: u32,
}

/// The standard function for serializing codec structs into a format that can be
/// used for message exchange between actor and host. Use of any other function to
/// serialize could result in breaking incompatibilities.
pub fn serialize<T>(
    item: T,
) -> ::std::result::Result<Vec<u8>, Box<dyn std::error::Error + Send + Sync>>
where
    T: Serialize,
{
    let mut buf = Vec::new();
    item.serialize(&mut Serializer::new(&mut buf).with_struct_map())?;
    Ok(buf)
}

/// The standard function for de-serializing codec structs from a format suitable
/// for message exchange between actor and host. Use of any other function to
/// deserialize could result in breaking incompatibilities.
pub fn deserialize<'de, T: Deserialize<'de>>(
    buf: &[u8],
) -> ::std::result::Result<T, Box<dyn std::error::Error + Send + Sync>> {
    let mut de = Deserializer::new(Cursor::new(buf));
    match Deserialize::deserialize(&mut de) {
        Ok(t) => Ok(t),
        Err(e) => Err(format!("Failed to de-serialize: {}", e).into()),
    }
}