Enum MessagePriority 

pub enum MessagePriority {
    Low = 0,
    Normal = 1,
    High = 2,
    Critical = 3,
}

Message priority levels

Variants

Low = 0

Low priority - status updates, periodic beacons

Normal = 1

Normal priority - standard operations

High = 2

High priority - important state changes

Critical = 3

Critical priority - leader election, emergencies

Implementations

impl MessagePriority

pub fn escalate(self, context: RoutingContext) -> Self

Escalate priority when crossing hierarchy boundaries

Priority Escalation Rules

1. Cell → Zone (Upward): All messages escalate +1 level (max: Critical)

   • Rationale: Zone coordinator processes fewer, more important messages
   • Low → Normal, Normal → High, High → Critical, Critical → Critical

2. Zone → Cell (Downward): No escalation (maintain priority)

   • Rationale: Zone directives already have appropriate priority

3. Intra-Cell/Intra-Zone: No escalation (lateral communication)

Examples

use peat_protocol::cell::messaging::{MessagePriority, RoutingContext};

let priority = MessagePriority::Normal;

// Escalates when going up the hierarchy
assert_eq!(
    priority.escalate(RoutingContext::CellToZone),
    MessagePriority::High
);

// No escalation for lateral or downward routing
assert_eq!(
    priority.escalate(RoutingContext::IntraCell),
    MessagePriority::Normal
);

pub fn can_preempt(self, other: MessagePriority) -> bool

Determine if this priority should preempt lower priority messages

Used for flow control and queue management decisions.

pub fn bandwidth_multiplier(self) -> f32

Get the numeric value for bandwidth allocation

Higher priorities get more bandwidth allocation in flow control. Returns a multiplier for bandwidth limits (1.0 = normal, 2.0 = double bandwidth, etc.)

Trait Implementations

impl Clone for MessagePriority

fn clone(&self) -> MessagePriority

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for MessagePriority

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

Formats the value using the given formatter.

impl Default for MessagePriority

fn default() -> MessagePriority

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for MessagePriority

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl From<MessagePriority> for QoSClass

fn from(priority: MessagePriority) -> Self

Converts to this type from the input type.

impl From<QoSClass> for MessagePriority

fn from(qos: QoSClass) -> Self

Converts to this type from the input type.

impl Ord for MessagePriority

fn cmp(&self, other: &MessagePriority) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for MessagePriority

fn eq(&self, other: &MessagePriority) -> 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 PartialOrd for MessagePriority

fn partial_cmp(&self, other: &MessagePriority) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl Serialize for MessagePriority

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Copy for MessagePriority

impl Eq for MessagePriority

impl StructuralPartialEq for MessagePriority