Struct TagSet 

pub struct TagSet(pub Vec<(String, String)>);

An ordered tag set. Insertion order is preserved (mirrors the AWS XML wire format, which is order-significant for the response). For duplicates on the same key, the last pair wins on lookup, matching AWS S3 behaviour for x-amz-tagging.

Tuple Fields

0: Vec<(String, String)>

Implementations

impl TagSet

pub fn new() -> Self

Empty tag set.

pub fn from_pairs(pairs: Vec<(String, String)>) -> Result<Self, TagError>

Construct a tag set from (key, value) pairs, validating the AWS S3 limits (max 10, key ≤ 128 B, value ≤ 256 B). Duplicate keys are retained in insertion order; lookup picks the last one.

pub fn get(&self, key: &str) -> Option<&str>

Look up the value for key. Last-wins on duplicates.

pub fn iter(&self) -> impl Iterator<Item = &(String, String)>

Iterate the pairs in insertion order.

pub fn len(&self) -> usize

pub fn is_empty(&self) -> bool

pub fn validate(&self) -> Result<(), TagError>

Enforce the AWS S3 spec: count ≤ 10, key ≤ 128 B, value ≤ 256 B, keys must be non-empty, and keys must be unique within the set. Called by Self::from_pairs; can also be called directly when constructing a TagSet from external input that wasn’t validated yet.

v0.8.4 #79: empty-key + duplicate-key rejection added so the x-amz-tagging header path and the PutObjectTagging XML body path both surface 400 InvalidArgument (matching AWS S3) instead of silently last-wins-collapsing duplicates.

Trait Implementations

impl Clone for TagSet

fn clone(&self) -> TagSet

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TagSet

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

Formats the value using the given formatter.

impl Default for TagSet

fn default() -> TagSet

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for TagSet

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for TagSet

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for TagSet

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for TagSet

impl StructuralPartialEq for TagSet