Struct Address 

pub struct Address {
    pub component: String,
    pub occurrence: usize,
    pub node_key: Option<String>,
}

An addressable location in the document.

Fields

component: String

Component name (queue, exchange, backlog, …).

occurrence: usize

Zero-based occurrence of the component in the document.

node_key: Option<String>

Stable node key when the address is narrowed to a single node; None addresses the whole component occurrence.

Implementations

impl Address

pub fn component(name: &str, occurrence: usize) -> Self

A whole-component address.

pub fn node(component: &str, occurrence: usize, node_key: &str) -> Self

A node-level address inside a component.

pub fn from_component_node_key(component: &str, node_key: &str) -> Self

Build a node address from a component name and a stable node key, parsing the component occurrence out of the comp:occurrence:id:n node key. This is the single source of occurrence parsing shared by op_address and the finalize-path drift gate, so an op’s address and the scope’s driver address agree for the same node key.

pub fn is_component_level(&self) -> bool

True when this address targets a whole component rather than one node.

pub fn overlaps(&self, other: &Address) -> bool

True when two addresses refer to overlapping document regions: the same component, and either side is component-level (whole component) or both name the same node key. This is the overlaps primitive behind the affectedness conflict relation (#op-scoped-drift-3).

Overlap is keyed on the component name plus the node key. The occurrence field is informational and is intentionally not part of the match: a node key already encodes the component index (comp:index:id:n), and the canonical write-set members built by TurnScope::for_driver are whole-component addresses (occurrence: 0) that must match the component wherever it sits in the document (#nm1x).

Trait Implementations

impl Clone for Address

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Address

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Address

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for Address

impl PartialEq for Address

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for Address

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 Address