Struct MacosReadOnlyEngine 

pub struct MacosReadOnlyEngine<B> { /* private fields */ }

Product-neutral read-only engine for a single File Provider domain/root.

Implementations

impl<B> MacosReadOnlyEngine<B>

where B: CloudFilesBackend + 'static,

pub const fn new(backend: Arc<B>, root_key: CloudItemKey) -> Self

Creates an engine scoped to one exact product-neutral root item.

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

Returns the stable root item key mapped to Apple’s root system container.

pub async fn item( &self, identifier: &MacosFileProviderIdentifier, ) -> Result<MacosFileProviderItem>

Loads an item by persistent identifier and validates its identity/root role.

Errors

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

pub async fn enumerate( &self, request: &MacosEnumerationRequest, ) -> Result<MacosEnumerationPage>

Loads and validates one backend page for a File Provider enumerator.

Errors

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

pub async fn prepare_content_fetch( &self, identifier: &MacosFileProviderIdentifier, requested_revision: &ContentRevision, ) -> Result<MacosContentFetchPlan>

Validates metadata and revision before a caller creates native staging storage.

Errors

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

pub async fn read_content_chunk( &self, plan: &MacosContentFetchPlan, offset: u64, maximum_length: NonZeroU64, ) -> Result<MacosFetchedContentChunk>

Reads one bounded chunk for a validated fetch plan.

Errors

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

Trait Implementations

impl<B> Clone for MacosReadOnlyEngine<B>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.