Struct OwnershipTable 

pub struct OwnershipTable { /* private fields */ }

Immutable ownership table. Build once at startup from [[cluster.scope]] config; share across reactor threads via Arc<OwnershipTable>.

Implementations

impl OwnershipTable

pub fn new(scopes: Vec<Scope>) -> Result<Self, OwnershipError>

Validate + sort the scope list. Rejects duplicate prefixes and strict overlap (T3.6 linter). O(n²) over the scope list, which is tiny (~ N scopes per cluster); no need for a trie at startup time.

pub fn scopes(&self) -> &[Scope]

Iterate over declared scopes (read-only). Mostly useful for INFO-style telemetry.

pub fn scopes_without_fallback(&self) -> Vec<&Scope>

T3.13 linter: scopes that declared no fallback. The server emits a WARN log per entry at boot so operators are aware that this scope has zero availability if its writer dies — not an error (the operator may have explicitly chosen availability < strict ownership), just a heads-up.

pub fn len(&self) -> usize

Number of declared scopes.

pub fn is_empty(&self) -> bool

true when no scopes are declared (the keyspace runs in pre-Phase-3 mode by default).

pub fn lookup(&self, key: &[u8]) -> Option<&Scope>

Longest-prefix match: the most specific scope that owns key, or None when no scope matches.

pub fn route<'a>(&'a self, key: &[u8], self_node_id: &str) -> Routing<'a>

Route key from the local node’s perspective. Treats the declared writer as the active owner; F4 fallback handling is layered on top in the server’s cement (this fn doesn’t know about live kevy-elect state — pure config view).

pub fn route_with_fallback_state<'a, F>( &'a self, key: &[u8], self_node_id: &str, is_writer_down: F, ) -> Routing<'a>

where F: FnMut(&str) -> bool,

Fallback-aware routing: when writer_down is true for the matched scope’s writer, the fallback (if declared) is treated as the active owner. Used by the cement after kevy-elect flags the writer DOWN (F4).

is_writer_down(node_id) -> bool is a callback so kevy-scope stays elect-agnostic; the cement plugs in its live snapshot.

Trait Implementations

impl Clone for OwnershipTable

fn clone(&self) -> OwnershipTable

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for OwnershipTable

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

Formats the value using the given formatter.