Struct Object 

pub struct Object {
    pub id: ObjectId,
    pub name: String,
    pub object_type: String,
    pub traits: HashMap<String, Trait>,
    pub metadata: HashMap<String, String>,
    pub created_at: DateTime<Utc>,
    pub updated_at: DateTime<Utc>,
}

An object is an identity container that composes traits

Fields

id: ObjectId

Unique identifier for this object

name: String

Name of the object

object_type: String

Type of the object

traits: HashMap<String, Trait>

Traits associated with this object

metadata: HashMap<String, String>

Metadata about the object

created_at: DateTime<Utc>

Creation timestamp

updated_at: DateTime<Utc>

Last update timestamp

Implementations

impl Object

pub fn new(name: impl Into<String>, object_type: impl Into<String>) -> Self

Create a new object with the given name and type

pub fn with_traits( name: impl Into<String>, object_type: impl Into<String>, traits: Vec<Trait>, ) -> Self

Create a new object with initial traits

pub fn with_capacity( name: impl Into<String>, object_type: impl Into<String>, trait_capacity: usize, metadata_capacity: usize, ) -> Self

Create a new object with pre-allocated capacity

pub fn name(&self) -> &str

Get the object name

pub fn object_type(&self) -> &str

Get the object type

pub fn id(&self) -> ObjectId

Get the object ID

pub fn add_trait(&mut self, trait_obj: Trait)

Add a trait to this object

pub fn add_traits(&mut self, traits: impl IntoIterator<Item = Trait>)

Add multiple traits efficiently

pub fn add_traits_bulk(&mut self, traits: impl IntoIterator<Item = Trait>)

Add multiple traits without timestamp updates (for bulk operations)

pub fn add_trait_internal(&mut self, trait_obj: Trait)

Add a trait without timestamp update (for internal operations)

pub fn remove_trait(&mut self, trait_name: &str) -> Option<Trait>

Remove a trait from this object

pub fn get_trait(&self, trait_name: &str) -> Option<&Trait>

Get a trait by name

pub fn get_trait_mut(&mut self, trait_name: &str) -> Option<&mut Trait>

Get a trait by name (mutable)

pub fn get_trait_data(&self, trait_name: &str) -> Option<&TraitData>

Get trait data by name (zero-copy access)

pub fn get_trait_data_mut(&mut self, trait_name: &str) -> Option<&mut TraitData>

Get trait data by name (mutable, zero-copy access)

pub fn traits(&self) -> &HashMap<String, Trait>

Get all traits

pub fn has_trait(&self, trait_name: &str) -> bool

Check if the object has a specific trait

pub fn has_traits(&self, trait_names: &[&str]) -> bool

Check if the object has multiple traits (efficient batch check)

pub fn has_any_traits(&self) -> bool

Check if the object has any traits

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

Get a metadata value

pub fn set_metadata(&mut self, key: impl Into<String>, value: impl Into<String>)

Set a metadata value

pub fn metadata(&self) -> &HashMap<String, String>

Get all metadata

pub fn created_at(&self) -> DateTime<Utc>

Get the creation timestamp

pub fn updated_at(&self) -> DateTime<Utc>

Get the last update timestamp

pub fn trait_names(&self) -> Vec<&String>

Get trait names as a vector

pub fn trait_ids(&self) -> Vec<TraitId>

Get trait IDs as a vector

pub fn trait_count(&self) -> usize

Get the number of traits

pub fn metadata_count(&self) -> usize

Get the number of metadata entries

pub fn reserve_traits(&mut self, additional: usize)

Reserve capacity for traits

pub fn reserve_metadata(&mut self, additional: usize)

Reserve capacity for metadata

pub fn validate_required_traits( &self, required_traits: &[&str], ) -> Result<(), OatsError>

Validate that the object has required traits

pub fn is_valid(&self) -> bool

Check if the object is valid (has required fields)

Trait Implementations

impl Clone for Object

fn clone(&self) -> Object

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Object

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Object

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Hash for Object

fn hash<H: Hasher>(&self, state: &mut H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for Object

fn eq(&self, other: &Self) -> 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 Object

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 Object