ash-flare 2.3.2

Fault-tolerant supervision trees for Rust with distributed capabilities inspired by Erlang/OTP
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

//! Python bindings for mailbox system
//!
//! For async Python code, wrap blocking methods with `asyncio.to_thread()`:
//! ```python
//! await asyncio.to_thread(handle.send, "message")
//! ```

use pyo3::exceptions::PyRuntimeError;
use pyo3::prelude::*;

use crate::mailbox::{Mailbox, MailboxConfig, MailboxHandle};

use super::get_runtime;

/// Python-facing mailbox configuration
#[pyclass(name = "MailboxConfig", skip_from_py_object)]
#[derive(Clone)]
pub struct PyMailboxConfig {
    pub(crate) inner: MailboxConfig,
}

#[pymethods]
impl PyMailboxConfig {
    #[staticmethod]
    fn unbounded() -> Self {
        PyMailboxConfig {
            inner: MailboxConfig::unbounded(),
        }
    }

    #[staticmethod]
    fn bounded(capacity: usize) -> Self {
        PyMailboxConfig {
            inner: MailboxConfig::bounded(capacity),
        }
    }

    fn __repr__(&self) -> String {
        match self.inner {
            MailboxConfig::Unbounded => "MailboxConfig.unbounded()".to_owned(),
            MailboxConfig::Bounded { capacity } => format!("MailboxConfig.bounded({capacity})"),
        }
    }
}

/// Python-facing mailbox handle
#[pyclass(name = "MailboxHandle")]
pub struct PyMailboxHandle {
    inner: MailboxHandle,
}

#[pymethods]
impl PyMailboxHandle {
    fn send(&self, message: String, _py: Python<'_>) -> PyResult<()> {
        let handle = self.inner.clone();
        let runtime = get_runtime();
        runtime.block_on(async move {
            handle
                .send(message)
                .await
                .map_err(|e| PyRuntimeError::new_err(format!("Failed to send: {e}")))
        })
    }

    fn try_send(&self, message: String) -> PyResult<()> {
        self.inner
            .try_send(message)
            .map_err(|e| PyRuntimeError::new_err(format!("Failed to send: {e}")))
    }

    fn worker_id(&self) -> &str {
        self.inner.worker_id()
    }

    fn is_open(&self) -> bool {
        self.inner.is_open()
    }

    fn __repr__(&self) -> String {
        format!("MailboxHandle(worker_id='{}')", self.inner.worker_id())
    }
}

/// Python-facing mailbox
#[pyclass(name = "Mailbox")]
pub struct PyMailbox {
    inner: Mailbox,
}

#[pymethods]
impl PyMailbox {
    fn recv(&mut self, _py: Python<'_>) -> Option<String> {
        let runtime = get_runtime();
        runtime.block_on(async move { self.inner.recv().await })
    }

    fn try_recv(&mut self) -> PyResult<String> {
        self.inner
            .try_recv()
            .map_err(|e| PyRuntimeError::new_err(format!("Failed to receive: {e}")))
    }

    #[allow(clippy::unused_self)]
    fn __repr__(&self) -> String {
        "Mailbox()".to_owned()
    }
}

#[pyfunction]
pub fn mailbox(config: &PyMailboxConfig) -> (PyMailboxHandle, PyMailbox) {
    let (handle, mailbox) = crate::mailbox::mailbox(config.inner);
    (
        PyMailboxHandle { inner: handle },
        PyMailbox { inner: mailbox },
    )
}

#[pyfunction]
pub fn mailbox_named(worker_id: String, config: &PyMailboxConfig) -> (PyMailboxHandle, PyMailbox) {
    let (handle, mailbox) = crate::mailbox::mailbox_named(config.inner, worker_id);
    (
        PyMailboxHandle { inner: handle },
        PyMailbox { inner: mailbox },
    )
}