ferroui-hot-patch 0.4.0

Development-only FerroUI hot-patch support
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

use std::collections::BTreeSet;

/// A stable application declaration, supplied when its patch supervisor starts.
/// Changing registrations is a build-input change and requires process replacement.
#[derive(Clone, Debug)]
pub struct FunctionRegistration {
    pub(crate) source: String,
    pub(crate) function: String,
    pub(crate) views: Option<BTreeSet<String>>,
}
impl FunctionRegistration {
    /// A handler or command whose updated body takes effect on its next invocation.
    /// Register the function here and invoke it through a patch-aware callback helper.
    pub fn callback(source: impl Into<String>, function: impl Into<String>) -> Self {
        Self {
            source: source.into(),
            function: function.into(),
            views: None,
        }
    }

    /// A synchronous builder which explicitly requests reapplication of these views.
    /// View identifiers belong to the application; the view transaction must resolve
    /// them to reversible adapters. At least one nonempty identifier is required.
    pub fn view_builder(
        source: impl Into<String>,
        function: impl Into<String>,
        views: impl IntoIterator<Item = String>,
    ) -> Self {
        Self {
            source: source.into(),
            function: function.into(),
            views: Some(views.into_iter().collect()),
        }
    }
}