Enum Keys 

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

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

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. Read as one etcd transaction, so every key is read at the same revision.

Cannot be watched. etcd establishes a watch on a key or on a range, so an arbitrary list is one stream per key, and N independent streams never say the set moved — they say one key did, N times. Watch a prefix, or poll refresh_remote_async().

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 etcd lists, which is nobody’s decision — so two keys under the prefix supplying the same path is a deployment bug, and reported as one rather than resolved. Read as a single range request.

Can be watched, and is the only multi-key shape here that can: one stream over the range says the set moved and carries the revision it moved at, and one range read at that revision is the set as of one instant. See Etcd::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