Struct SharedFilePicker 

pub struct SharedFilePicker(/* private fields */);

Thread-safe shared handle to the FilePicker instance. This accumulates only asynchronous non-blocking operations against the file picker: creating, triggering various rescans and so on.

For blocking access use internal picker via .read() or .write()

let shared_picker = SharedFilePicker::default();

if let Some(picker) = shared_picker.read()?.as_ref() {
    let files = picker.fuzzy_search(&query, options);
    println!("Found {} files", files.len());
} else {
    println!("Picker not initialized");
}

Implementations

impl SharedFilePicker

pub fn read(&self) -> Result<RwLockReadGuard<'_, Option<FilePicker>>, Error>

pub fn write(&self) -> Result<RwLockWriteGuard<'_, Option<FilePicker>>, Error>

pub fn need_complex_rebuild(&self) -> bool

Return true if this is an instance of the picker that requires a complicated post-scan indexing/cache warmup job. The indexing is not crazy but it takes time.

pub fn wait_for_scan(&self, timeout: Duration) -> bool

Block until the background filesystem scan finishes. Returns true if scan completed, false on timeout.

pub fn wait_for_watcher(&self, timeout: Duration) -> bool

Block until the background file watcher is ready. Returns true if watcher ready, false on timeout.

pub fn trigger_full_rescan_async( &self, shared_frecency: &SharedFrecency, ) -> Result<(), Error>

Trigger a full filesystem rescan without blocking the caller. Performs a safe async rescan. Guarantees only single active rescan per picker. If many rescans requested the last one guaranteed to be finished.

pub fn refresh_git_status( &self, shared_frecency: &SharedFrecency, ) -> Result<usize, Error>

Refresh git statuses for all indexed files.

Trait Implementations

impl Clone for SharedFilePicker

fn clone(&self) -> SharedFilePicker

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SharedFilePicker

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

Formats the value using the given formatter.

impl Default for SharedFilePicker

fn default() -> SharedFilePicker

Returns the “default value” for a type.