Struct FsProvider 

pub struct FsProvider;

Local files, using the same discovery filters and no-follow walk as discover.

On Unix, read, open and version reach a resource from “/” one component at a time without following any symbolic link, so swapping an ancestor for a link cannot redirect them outside the tree that discovery walked. Resource ids must therefore be canonical paths, as discovery and SearchEngine produce. An id with a link component (an explicit symlink, or an alias such as /tmp or /var on macOS) fails closed with an error that says so; canonicalize such a path before building its id. On Windows these methods remain path-based and are not pinned.

Trait Implementations

impl Debug for FsProvider

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

Formats the value using the given formatter.

impl Default for FsProvider

fn default() -> Self

Returns the “default value” for a type.

impl ResourceProvider for FsProvider

fn open(&self, id: &ResourceId) -> Result<Box<dyn ReadSeek>>

Seekable source for bounded audio reads; no whole-file fallback.

fn list(&self, scope: &ResourceScope) -> Result<Vec<ProvidedResource>>

Return resources in deterministic order, without duplicate identities.

fn list_walked(&self, scope: &ResourceScope) -> Result<ResourceListing>

list, plus the resolved root identity each scope root was walked under when the provider can prove it. The default proves nothing.

fn read(&self, id: &ResourceId) -> Result<Vec<u8>>

fn version(&self, id: &ResourceId) -> Result<ResourceVersion>

Return a change token consistent with the token supplied by list. Equal known tokens let the warm pass skip reading when preparation is unchanged. Filesystem size and mtime are cheap change hints, not proof of unchanged bytes: an equal-size rewrite with a restored mtime can leave stale vectors and keyword rows. Extraction still checks the content hash and refuses changed text. Use unknown tokens in both list and version to force a reread and hash check.

fn deletion_scope(&self, scope: &ResourceScope) -> Result<ResourceScope>

Resolve deletion roots once per pass, before filtering cached identities. An error retains entries and is reported as skipped work by the engine.

fn is_deleted(&self, id: &ResourceId, scope: &ResourceScope) -> Result<bool>

True only for confirmed deletion inside scope. Errors and exclusions must not count as deletion. Pass the scope returned by deletion_scope. The conservative default retains entries.

fn supports_cached_listing(&self) -> bool

Opt in to authorizing indexed identities without discovering uncached descendants. Other providers retain their normal listing behavior in cached-only searches.

fn list_cached( &self, scope: &ResourceScope, _ids: &[ResourceId], ) -> Result<Vec<ProvidedResource>>

Current eligibility for supplied cached identities, including scope and policy. Called only after supports_cached_listing opts in; no content may be read here.