Struct FilePicker 

pub struct FilePicker;

Frontend-agnostic file picker that delegates to the native platform dialog.

FilePicker has no state and is cheap to construct. All methods return standard Future values that can be awaited from any async runtime, including pollster::block_on for synchronous contexts.

Examples

use loki_file_access::{FilePicker, PickOptions};

let picker = FilePicker::new();
let token = picker
    .pick_file_to_open(PickOptions::default())
    .await?;

if let Some(token) = token {
    println!("Selected: {}", token.display_name());
}

Implementations

impl FilePicker

pub fn new() -> Self

Create a new FilePicker instance.

pub async fn pick_file_to_open( &self, options: PickOptions, ) -> Result<Option<FileAccessToken>, PickerError>

Present a platform dialog for the user to select a single file.

Returns Ok(Some(token)) if the user selected a file, or Ok(None) if the user cancelled the dialog. The multi field of options is ignored — use pick_files_to_open for multi-selection.

Errors

Returns PickerError if the platform dialog could not be presented.

pub async fn pick_files_to_open( &self, options: PickOptions, ) -> Result<Vec<FileAccessToken>, PickerError>

Present a platform dialog for the user to select multiple files.

Returns a (possibly empty) vector of tokens. An empty vector means the user cancelled the dialog. The multi field of options is forced to true.

Errors

Returns PickerError if the platform dialog could not be presented.

pub async fn pick_file_to_save( &self, options: SaveOptions, ) -> Result<Option<FileAccessToken>, PickerError>

Present a platform dialog for the user to choose a save location.

Returns Ok(Some(token)) if the user confirmed a save location, or Ok(None) if the user cancelled.

Platform notes

On WASM, this triggers a browser download via a Blob URL rather than presenting a traditional save dialog. The returned token wraps an in-memory buffer.

Errors

Returns PickerError if the platform dialog could not be presented.

Trait Implementations

impl Clone for FilePicker

fn clone(&self) -> FilePicker

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FilePicker

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

Formats the value using the given formatter.

impl Default for FilePicker

fn default() -> FilePicker

Returns the “default value” for a type.