Struct CloudItem 

pub struct CloudItem { /* private fields */ }

Stable item identity plus its current parent, name, kind, and revisions.

Implementations

impl CloudItem

pub fn directory( key: CloudItemKey, parent_id: Option<CloudItemId>, name: impl Into<String>, metadata_revision: MetadataRevision, ) -> Result<Self>

Creates a directory. parent_id = None identifies the root item for the scope.

Errors

Returns an error when validation fails or an underlying backend, store, or platform operation fails.

pub fn file( key: CloudItemKey, parent_id: CloudItemId, name: impl Into<String>, metadata_revision: MetadataRevision, content: CloudContentMetadata, ) -> Result<Self>

Creates a regular file. Files always require a parent within the same scope.

Errors

Returns an error when validation fails or an underlying backend, store, or platform operation fails.

pub const fn key(&self) -> &CloudItemKey

Returns the fully scoped stable identity.

pub const fn parent_id(&self) -> Option<&CloudItemId>

Returns the parent item identity, or None for the root item.

pub fn name(&self) -> &str

Returns the current item name.

pub const fn kind(&self) -> CloudItemKind

Returns the current item kind.

pub const fn metadata_revision(&self) -> &MetadataRevision

Returns the opaque metadata revision.

pub const fn content(&self) -> Option<&CloudContentMetadata>

Returns file content metadata, or None for a directory.

pub const fn is_root(&self) -> bool

Returns whether this item is the root directory of its scope.

pub fn moved( self, parent_id: CloudItemId, name: impl Into<String>, metadata_revision: MetadataRevision, ) -> Result<Self>

Applies a same-root rename or move while preserving the stable item key and content state.

Errors

Returns an error when validation fails or an underlying backend, store, or platform operation fails.

Trait Implementations

impl Clone for CloudItem

fn clone(&self) -> CloudItem

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CloudItem

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

Formats the value using the given formatter.

impl PartialEq for CloudItem

fn eq(&self, other: &CloudItem) -> 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 Eq for CloudItem

impl StructuralPartialEq for CloudItem