Enum Keys 

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

What a source reads: one object, several named ones, or a prefix.

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 object, whose body is the whole document.

Several(Vec<String>)

Several named objects, 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 GetObject per key, because S3 has no batch read — so the set is not read atomically.

Prefix(String)

Every object under a literal prefix, merged as disjoint sections.

A caller naming a prefix is not expressing an order — S3 lists keys in UTF-8 order, which is nobody’s precedence — so two objects under it supplying the same path is a deployment bug, and reported as one rather than resolved. One ListObjectsV2 (paginated) and then one GetObject per key.

Implementations

impl Keys

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

One object, whose body is the whole document.

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

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

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

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

Every object 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