lxmf-sdk 0.7.0

High-level Rust SDK for LXMF clients and RPC-backed LXMF workflows.
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

use serde::{Deserialize, Serialize};

#[derive(Clone, Debug, Serialize, Deserialize, PartialEq, Eq)]
#[serde(rename_all = "snake_case")]
#[non_exhaustive]
pub enum RuntimeState {
    New,
    Starting,
    Running,
    Draining,
    Stopped,
    Failed,
    #[serde(other)]
    Unknown,
}

#[derive(Clone, Debug, Serialize, Deserialize, PartialEq)]
#[non_exhaustive]
pub struct RuntimeSnapshot {
    pub runtime_id: String,
    pub state: RuntimeState,
    pub active_contract_version: u16,
    pub event_stream_position: u64,
    pub config_revision: u64,
    pub queued_messages: u64,
    pub in_flight_messages: u64,
}

#[derive(Clone, Debug, Serialize, Deserialize, PartialEq, Eq)]
#[serde(rename_all = "snake_case")]
#[non_exhaustive]
pub enum ShutdownMode {
    Graceful,
    Immediate,
}

#[derive(Clone, Debug, Serialize, Deserialize, PartialEq, Eq)]
#[non_exhaustive]
pub struct TickBudget {
    pub max_work_items: usize,
    pub max_duration_ms: Option<u64>,
}

impl TickBudget {
    pub fn new(max_work_items: usize) -> Self {
        Self { max_work_items, max_duration_ms: None }
    }

    pub fn with_max_duration_ms(mut self, max_duration_ms: u64) -> Self {
        self.max_duration_ms = Some(max_duration_ms);
        self
    }
}

#[derive(Clone, Debug, Serialize, Deserialize, PartialEq, Eq)]
#[non_exhaustive]
pub struct TickResult {
    pub processed_items: usize,
    pub yielded: bool,
    pub next_recommended_delay_ms: Option<u64>,
}