Struct MeshConfig 

pub struct MeshConfig {
    pub schema: String,
    pub kind: String,
    pub id: String,
    pub enabled: bool,
    pub multicast: MulticastConfig,
    pub broadcast: BroadcastConfig,
    pub rendezvous: RendezvousConfig,
    pub trust: TrustConfig,
    pub cooperation: CooperationConfig,
}

The whole declaration: the master switch and one section per mechanism. Unknown keys are refused, so a typo is an error and not a silently ignored wish.

Fields

schema: String

The format version: mesh/v1.

kind: String

The kind: mesh, the same word the discovery class carries.

id: String

The declaration’s identity.

enabled: bool

The master switch. false starts nothing.

multicast: MulticastConfig

UDP multicast, the preferred LAN mechanism.

broadcast: BroadcastConfig

UDP broadcast, the controlled fallback.

rendezvous: RendezvousConfig

Rendezvous endpoints, for networks multicast cannot cross.

trust: TrustConfig

Who to trust.

cooperation: CooperationConfig

Cooperation: the authenticated links to trusted runtimes of the same repository, and the journal they replicate (ADR 0067).

Implementations

impl MeshConfig

pub fn parse(object: &Object) -> Result<MeshConfig, MeshError>

Parse one indexed object into a mesh declaration, or say why it is not one: the wrong schema version, an unknown key, and a zero interval are each refused with the object’s URI in the reason.

pub fn from_metadata( metadata: &Value, uri: &str, ) -> Result<MeshConfig, MeshError>

MeshConfig::parse for a declaration that is not an indexed object: the metadata mapping as the YAML subset parsed it, and the name to quote in a refusal. The trunk’s copy of the declaration is read this way (see super::root).

use majordomus_cli::mesh::MeshConfig;
let ok = serde_json::json!({ "schema": "mesh/v1", "kind": "mesh-declaration", "id": "x" });
assert!(MeshConfig::from_metadata(&ok, "master:x.yaml").is_ok());
let wrong = serde_json::json!({ "schema": "mesh/v0", "kind": "mesh-declaration", "id": "x" });
assert!(MeshConfig::from_metadata(&wrong, "master:x.yaml").unwrap_err().to_string().contains("master:x.yaml"));

Trait Implementations

impl Clone for MeshConfig

fn clone(&self) -> MeshConfig

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for MeshConfig

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for MeshConfig

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl JsonSchema for MeshConfig

fn schema_name() -> Cow<'static, str>

The name of the generated JSON Schema.

fn schema_id() -> Cow<'static, str>

Returns a string that uniquely identifies the schema produced by this type.

fn json_schema(generator: &mut SchemaGenerator) -> Schema

Generates a JSON Schema for this type.

fn inline_schema() -> bool

Whether JSON Schemas generated for this type should be included directly in parent schemas, rather than being re-used where possible using the $ref keyword.

impl Serialize for MeshConfig

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.