Enum Keys 

pub enum Keys {
    One(String),
    Several(Vec<String>),
    Prefix(String),
}

What a source reads: one key, several named keys, or a subtree.

Every constructor takes one, and a bare &str or String is Keys::one — so the single-key spelling every caller already wrote keeps working unchanged.

Variants

One(String)

One key, whose value is the whole document.

Several(Vec<String>)

Several named keys, merged in the order given — later wins.

The rule a list of .file(..) calls already teaches: the caller wrote the list, so the list is the precedence. One request per key, because Consul’s KV API has no batch read of a caller-chosen set.

Cannot be watched, for that same reason: a blocking query blocks on one key or one subtree, so watching a list would mean waking on one key and then reading the rest — collecting the new value of one beside the old value of another, a document that never existed.

Prefix(String)

Every key under a prefix, merged as disjoint sections.

A caller naming a prefix is not expressing an order — the order is whatever the agent lists — so two keys under it supplying the same path is a deployment bug, and reported as one rather than resolved. One ?recurse request, so the subtree is read at a single index.

Can be watched, and needs no re-read to do it: a recursive blocking query’s answer is the subtree at the index it woke on. See Consul::watch.

Implementations

impl Keys

pub fn one(key: impl Into<String>) -> Self

One key, whose value is the whole document.

pub fn several<I, S>(keys: I) -> Self

where I: IntoIterator<Item = S>, S: Into<String>,

Several named keys, merged in the order given — later wins.

pub fn prefix(prefix: impl Into<String>) -> Self

Every key under prefix, merged as disjoint sections.

Trait Implementations

impl Clone for Keys

fn clone(&self) -> Keys

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Keys

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

Formats the value using the given formatter.

impl Eq for Keys

impl From<&String> for Keys

fn from(key: &String) -> Self

Converts to this type from the input type.

impl From<&str> for Keys

fn from(key: &str) -> Self

Converts to this type from the input type.

impl From<String> for Keys

fn from(key: String) -> Self

Converts to this type from the input type.

impl PartialEq for Keys

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Keys