Struct CausalContext 

pub struct CausalContext {
    pub parent: Option<MessageId>,
    pub parent_chain: Vec<MessageId>,
}

Causal metadata used to relate a message to an optional parent message.

Fields

parent: Option<MessageId>

Parent message that must causally precede this message, if any.

parent_chain: Vec<MessageId>

Full causal parent chain ordered as parent, grandparent, and so on.

Implementations

impl CausalContext

pub const fn root() -> Self

Creates an independent context with no parent message.

pub fn child_of(parent: MessageId) -> Self

Creates a context for a message that directly follows parent, with a depth-1 chain (parent_chain == [parent]).

WARNING: this records ONLY the immediate parent, so happened_before will not see parent’s own ancestors. Use this only when parent is a chain root (no ancestors of its own). When the parent itself has a causal context, build the child with child_of_context so transitive happens-before is preserved — otherwise causal ordering is silently truncated to one hop.

pub fn child_of_context(parent: MessageId, parent_context: &Self) -> Self

Creates a child context by prepending parent to the parent’s own causal chain.

pub fn from_parent_chain(parent_chain: Vec<MessageId>) -> Self

Creates a context from an explicit parent chain ordered parent to oldest ancestor.

pub fn parent_chain(&self) -> &[MessageId]

Returns the full parent chain ordered parent to oldest ancestor.

pub fn happened_before(&self, ancestor_id: MessageId) -> bool

Returns whether ancestor_id causally happened before this context’s message.

Trait Implementations

impl Clone for CausalContext

fn clone(&self) -> CausalContext

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CausalContext

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

Formats the value using the given formatter.

impl Default for CausalContext

fn default() -> Self

Returns the “default value” for a type.

impl Eq for CausalContext

impl PartialEq for CausalContext

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