Struct SharedRepositoryContext 

pub struct SharedRepositoryContext { /* private fields */ }

Explicit context for read-only shared repository lookup.

Implementations

impl SharedRepositoryContext

pub fn lookup_thumbnail_path( &self, original_facts: SharedOriginalFacts, size: ThumbnailSize, ) -> Result<SharedThumbnailLookup<ThumbnailPathLookupEntry>>

Returns a validated shared-repository path for integrations that must pass a filename.

Errors

Returns an error for unexpected filesystem I/O while reading the candidate or for PNG metadata parse failures after validation succeeds.

pub fn lookup_thumbnail_png_bytes( &self, original_facts: SharedOriginalFacts, size: ThumbnailSize, ) -> Result<SharedThumbnailLookup<ThumbnailPngBytesLookupEntry>>

Returns exact validated PNG bytes from a shared thumbnail repository.

Errors

Returns an error for unexpected filesystem I/O while reading the candidate or for PNG metadata parse failures after validation succeeds.

pub fn lookup_thumbnail_rgba8( &self, original_facts: SharedOriginalFacts, size: ThumbnailSize, ) -> Result<SharedThumbnailLookup<ThumbnailRgba8LookupEntry>>

Returns decoded tightly packed RGBA8 pixels from a shared thumbnail repository.

The returned pixels are row-major [red, green, blue, alpha] bytes with straight alpha and stride == width * 4.

Errors

Returns an error for unexpected filesystem I/O while reading the candidate or for PNG decoding failures after validation succeeds.

pub fn lookup_display_thumbnail_rgba8( &self, original_facts: SharedOriginalFacts, size: ThumbnailSize, ) -> Result<SharedThumbnailLookup<DisplayThumbnailRgba8LookupEntry>>

Returns decoded RGBA8 display pixels, falling back to larger shared-repository namespaces.

The exact namespace is checked first. If it is missing, larger namespaces are checked in ascending order. The first non-missing candidate controls the result.

Errors

Returns an error for unexpected filesystem I/O while reading the candidate or for PNG decoding failures after validation succeeds.

pub fn inspect_thumbnails( &self, sizes: &[ThumbnailSize], original: SharedOriginalMetadata, ) -> Result<Vec<SharedCacheEntryInspection>>

Inspects existing shared-repository thumbnails without exposing removal handles.

Errors

Returns an error when a selected shared thumbnail cannot be inspected due to unexpected filesystem I/O.

impl SharedRepositoryContext

pub fn new( repository_root: impl AsRef<Path>, original_child_name: impl AsRef<OsStr>, ) -> Result<Self>

Creates a shared repository context for one direct child of repository_root.

Errors

Returns an error when repository_root is not absolute or original_child_name cannot be represented as a shared direct-child URI identity.

pub fn repository_root(&self) -> &Path

Returns the shared repository root directory.

pub fn original_child_name(&self) -> &OsStr

Returns the direct child original filename.

pub const fn shared_uri(&self) -> &SharedRelativeOriginalUri

Returns the shared URI used for hashing and optional metadata comparison.

pub fn cache_entry_path(&self, size: ThumbnailSize) -> PathBuf

Computes the shared repository cache entry path for a successful thumbnail size.

Trait Implementations

impl Clone for SharedRepositoryContext

fn clone(&self) -> SharedRepositoryContext

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SharedRepositoryContext

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

Formats the value using the given formatter.

impl PartialEq for SharedRepositoryContext

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

impl StructuralPartialEq for SharedRepositoryContext