Struct LinkRefusal 

pub struct LinkRefusal {
    pub code: RefusalCode,
    pub detail: String,
    pub proto_min: u32,
    pub proto_max: u32,
}

A refusal: the code, the reason in words, and the protocol range of the refuser so a version mismatch is diagnosable from either end.

Carrying the refuser’s protocol range in every refusal, not only in the one about protocols, is what makes a version problem visible from the side that has the log: the dialer sees what the answerer speaks without anyone having to read the other machine.

use majordomus_cli::mesh::link::{LinkRefusal, RefusalCode, LINK_PROTOCOL_MAX};

let refusal = LinkRefusal::new(RefusalCode::Untrusted, "the key is not in the allowlist");
assert_eq!(refusal.code, RefusalCode::Untrusted);
assert_eq!(refusal.proto_max, LINK_PROTOCOL_MAX);
assert_eq!(refusal.to_string(), "untrusted: the key is not in the allowlist");

Fields

code: RefusalCode

The rule that refused.

detail: String

Why, in words.

proto_min: u32

The refuser’s oldest protocol.

proto_max: u32

The refuser’s newest protocol.

Implementations

impl LinkRefusal

pub fn new(code: RefusalCode, detail: impl Into<String>) -> Self

A refusal with this executable’s protocol range. Every refusal is built here rather than by hand, so that no call site can forget the range and leave the other end guessing whether it was turned down over a version or over a rule.

use majordomus_cli::mesh::link::{LinkRefusal, RefusalCode, LINK_PROTOCOL_MAX,
    LINK_PROTOCOL_MIN};

let refusal = LinkRefusal::new(RefusalCode::Capacity, "256 peers already linked");
assert_eq!((refusal.proto_min, refusal.proto_max), (LINK_PROTOCOL_MIN, LINK_PROTOCOL_MAX));
assert_eq!(refusal.detail, "256 peers already linked");

Trait Implementations

impl Clone for LinkRefusal

fn clone(&self) -> LinkRefusal

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for LinkRefusal

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for LinkRefusal

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for LinkRefusal

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

Formats the value using the given formatter.

impl Eq for LinkRefusal

impl JsonSchema for LinkRefusal

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 PartialEq for LinkRefusal

fn eq(&self, other: &LinkRefusal) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for LinkRefusal

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for LinkRefusal