telar-services-core 0.1.4

Platform path providers and an optional dependency-injection scope for Telar.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80

use std::path::PathBuf;
use std::sync::{Arc, OnceLock};

/// One entry of a dialog's type filter: a name the user reads and the extensions it accepts.
#[derive(Clone, Debug, Default)]
pub struct FileFilter {
    pub name: String,
    pub extensions: Vec<String>,
}

impl FileFilter {
    pub fn new(name: impl Into<String>, extensions: &[&str]) -> Self {
        Self {
            name: name.into(),
            extensions: extensions.iter().map(|e| (*e).to_string()).collect(),
        }
    }
}

/// What to ask the OS for. Every field is optional: an empty request opens the platform's default
/// "any file, last directory" dialog.
#[derive(Clone, Debug, Default)]
pub struct FileDialog {
    pub title: Option<String>,
    pub directory: Option<PathBuf>,
    /// Pre-filled name, for a save dialog.
    pub file_name: Option<String>,
    pub filters: Vec<FileFilter>,
}

impl FileDialog {
    pub fn new() -> Self {
        Self::default()
    }

    pub fn title(mut self, title: impl Into<String>) -> Self {
        self.title = Some(title.into());
        self
    }

    pub fn directory(mut self, dir: impl Into<PathBuf>) -> Self {
        self.directory = Some(dir.into());
        self
    }

    pub fn file_name(mut self, name: impl Into<String>) -> Self {
        self.file_name = Some(name.into());
        self
    }

    pub fn filter(mut self, name: impl Into<String>, extensions: &[&str]) -> Self {
        self.filters.push(FileFilter::new(name, extensions));
        self
    }
}

/// The OS file-chooser, as the vocabulary crate sees it.
///
/// Every method BLOCKS until the user answers, which is why the whole trait is `Send + Sync`: the caller
/// runs it on a worker thread and takes the answer back on the UI thread. Nothing here touches the event
/// loop, so a backend is free to be a portal call, a native panel, or a stub in a test.
pub trait FileDialogs: Send + Sync + 'static {
    fn open_file(&self, request: FileDialog) -> Option<PathBuf>;
    fn open_files(&self, request: FileDialog) -> Vec<PathBuf>;
    fn save_file(&self, request: FileDialog) -> Option<PathBuf>;
    fn pick_folder(&self, request: FileDialog) -> Option<PathBuf>;
}

static DIALOGS: OnceLock<Arc<dyn FileDialogs>> = OnceLock::new();

/// Installs the backend the app's dialogs go through. The desktop runner calls this at startup; a test or
/// a headless build can install a stub instead. The first call wins.
pub fn set_file_dialogs(provider: Arc<dyn FileDialogs>) {
    let _ = DIALOGS.set(provider);
}

/// The installed backend, or `None` on a platform with no file chooser (headless, Android today).
pub fn file_dialogs() -> Option<Arc<dyn FileDialogs>> {
    DIALOGS.get().cloned()
}