Struct Attrs

pub struct Attrs { /* private fields */ }

A heterogeneous, strongly-typed attribute dictionary with serialization support.

This dictionary stores key-value pairs where:

• Keys are type-safe and must be predefined with their associated types
• Values must implement Send + Sync + Serialize + DeserializeOwned + Named + 'static
• The entire dictionary can be serialized to/from JSON automatically

Type Safety

The dictionary enforces type safety at compile time. You cannot retrieve a value with the wrong type, and the compiler will catch such errors.

Serialization

The dictionary can be serialized using serde. During serialization, each value is serialized with its key name. During deserialization, the automatically registered key information is used to determine the correct type for each value.

Implementations

impl Attrs

pub fn new() -> Self

Create a new empty attribute dictionary.

pub fn set<T: Send + Sync + Serialize + DeserializeOwned + Named + Clone + 'static>( &mut self, key: Key<T>, value: T, )

Set a value for the given key.

pub fn get<T: Send + Sync + Serialize + DeserializeOwned + Named + 'static>( &self, key: Key<T>, ) -> Option<&T>

Get a value for the given key, returning None if not present. If the key has a default value, that is returned instead.

pub fn get_mut<T: Send + Sync + Serialize + DeserializeOwned + Named + Clone + 'static>( &mut self, key: Key<T>, ) -> Option<&mut T>

Get a mutable reference to a value for the given key. If the key has a default value, it is first set, and then returned as a mutable reference.

pub fn remove<T: Send + Sync + Serialize + DeserializeOwned + Named + 'static>( &mut self, key: Key<T>, ) -> bool

Remove a value for the given key, returning it if present.

pub fn contains_key<T: Send + Sync + Serialize + DeserializeOwned + Named + 'static>( &self, key: Key<T>, ) -> bool

Checks if the given key exists in the dictionary.

pub fn len(&self) -> usize

Returns the number of key-value pairs in the dictionary.

pub fn is_empty(&self) -> bool

Returns true if the dictionary is empty.

pub fn clear(&mut self)

Clear all key-value pairs from the dictionary.

Trait Implementations

impl Clone for Attrs

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Attrs

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

Formats the value using the given formatter.

impl Default for Attrs

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Attrs

fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<T: Send + Sync + Serialize + DeserializeOwned + Named + 'static> Index<Key<T>> for Attrs

type Output = T

The returned type after indexing.

fn index(&self, key: Key<T>) -> &Self::Output

Performs the indexing (container[index]) operation.

impl<T: Send + Sync + Serialize + DeserializeOwned + Named + Clone + 'static> IndexMut<Key<T>> for Attrs

fn index_mut(&mut self, key: Key<T>) -> &mut Self::Output

Performs the mutable indexing (container[index]) operation.

impl Serialize for Attrs

fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>

where S: Serializer,

Serialize this value into the given Serde serializer.