Struct PinnedReader 

pub struct PinnedReader<A, O> { /* private fields */ }

Cheap immutable reader over one authenticated pinned checkout candidate.

Clones share the underlying stores and immutable generation root. Reads do not mutate checkout dependency state, so independent requests may overlap.

Implementations

impl<A: AsyncAuthorityStore, O: AsyncObjectStore> PinnedReader<A, O>

pub async fn list_directory_pages( &self, requests: &[DirectoryPageRequest], concurrency: usize, budget: WorkBudget, cancellation: &CancellationToken, ) -> FsResult<Vec<DirectoryPage>>

Lists ordered directory binding pages with at most concurrency requests in flight while preserving input order. Finite budgets are consumed sequentially so concurrent requests cannot each admit the complete group budget.

pub async fn resolve_directory_page( &self, path: &NamespacePath, after: Option<&LogicalName>, maximum_entries: u32, budget: WorkBudget, cancellation: &CancellationToken, ) -> FsResult<ResolvedDirectoryPage<A, O>>

Resolves one bounded directory page into generation-scoped child handles in the same authenticated traversal. Child metadata is fetched as one object batch; no child path is looked up again.

pub async fn plan_file_extents( &self, path: &NamespacePath, range: ByteRange, maximum_spans: u32, budget: WorkBudget, cancellation: &CancellationToken, ) -> FsResult<Option<ExtentPlan>>

Plans sparse physical spans without reading content bodies.

pub async fn read_file_range( &self, path: &NamespacePath, range: ByteRange, budget: WorkBudget, cancellation: &CancellationToken, ) -> FsResult<FileRangeRead>

Reads one exact logical range without mutating checkout state.

pub async fn read_symbolic_link( &self, path: &NamespacePath, budget: WorkBudget, cancellation: &CancellationToken, ) -> FsResult<Bytes>

Reads exact opaque symbolic-link target bytes without following it.

pub async fn read_metadata( &self, path: &NamespacePath, budget: WorkBudget, cancellation: &CancellationToken, ) -> FsResult<FileMetadata>

Reads complete canonical metadata for one exact path.

pub async fn describe_files( &self, paths: &[NamespacePath], budget: WorkBudget, cancellation: &CancellationToken, ) -> FsResult<Vec<Option<FileDescription>>>

Describes an ordered path batch while sharing namespace and object traversal.

pub async fn resolve_files( &self, paths: &[NamespacePath], budget: WorkBudget, cancellation: &CancellationToken, ) -> FsResult<Vec<Option<ResolvedFile<A, O>>>>

Resolves and describes paths once, returning reader-scoped handles for later body reads without another namespace traversal.

pub async fn read_resolved_ranges( &self, requests: &[ResolvedFileRangeReadRequest<'_, A, O>], concurrency: usize, budget: WorkBudget, cancellation: &CancellationToken, ) -> FsResult<Vec<FileRangeRead>>

Reads ranges from already resolved files with bounded concurrency and no additional namespace traversal.

Trait Implementations

impl<A, O> Clone for PinnedReader<A, O>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.