trellis-rs 0.10.17

Curated public Rust facade for Trellis clients and services.
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

use futures_util::future::BoxFuture;

use super::{
    validate_bootstrap_contract_state, BootstrapBinding, BootstrapContractRef, ServerError,
    ServiceResourceBindings,
};

/// A resolved service binding that can expose the validated contract id/digest pair.
pub trait BootstrapBindingInfo: Clone + Send + Sync {
    fn bootstrap_binding(&self) -> BootstrapBinding;

    /// Return typed resource bindings resolved for this bootstrap binding.
    fn resource_bindings(&self) -> ServiceResourceBindings {
        ServiceResourceBindings::default()
    }
}

impl BootstrapBindingInfo for BootstrapBinding {
    fn bootstrap_binding(&self) -> BootstrapBinding {
        self.clone()
    }
}

/// Port for querying Trellis core bootstrap data.
pub trait CoreBootstrapPort: Send + Sync {
    type Binding: BootstrapBindingInfo;

    fn fetch_catalog_contracts<'a>(
        &'a self,
    ) -> BoxFuture<'a, Result<Vec<BootstrapContractRef>, ServerError>>;

    fn fetch_binding<'a>(
        &'a self,
        expected: &'a BootstrapContractRef,
    ) -> BoxFuture<'a, Result<Option<Self::Binding>, ServerError>>;
}

/// Resolve and validate bootstrap state using the core bootstrap port.
pub async fn resolve_bootstrap_binding<C>(
    service_name: &str,
    expected: &BootstrapContractRef,
    core: &C,
) -> Result<C::Binding, ServerError>
where
    C: CoreBootstrapPort,
{
    let catalog = core.fetch_catalog_contracts().await?;

    let is_active = catalog
        .iter()
        .any(|contract| contract.id == expected.id && contract.digest == expected.digest);
    if !is_active {
        return Err(ServerError::BootstrapInactiveContract {
            service_name: service_name.to_string(),
            contract_id: expected.id.clone(),
            contract_digest: expected.digest.clone(),
        });
    }

    let binding = core.fetch_binding(expected).await?;

    let validated_binding = binding
        .as_ref()
        .map(BootstrapBindingInfo::bootstrap_binding);
    validate_bootstrap_contract_state(
        service_name,
        expected,
        &catalog,
        validated_binding.as_ref(),
    )?;

    binding.ok_or_else(|| ServerError::BootstrapMissingBinding {
        service_name: service_name.to_string(),
        contract_id: expected.id.clone(),
        contract_digest: expected.digest.clone(),
    })
}