applications 0.3.1

A cross-platform library for finding installed applications.
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

//! Common Data Structures
use crate::utils::image::RustImageData;
use anyhow::Result;
use serde::{Deserialize, Serialize};
use std::{
    path::{Path, PathBuf},
    sync::{atomic::AtomicBool, Arc, Mutex},
};

#[derive(Debug, Clone, PartialEq, Serialize, Deserialize, Default, Eq, Hash)]
pub struct App {
    pub name: String,
    pub icon_path: Option<PathBuf>,
    pub app_path_exe: Option<PathBuf>, // Path to the .app file for mac, or Exec for Linux, or .exe for Windows
    pub app_desktop_path: PathBuf,     // Path to the .desktop file for Linux, .app for Mac
}

/// This trait specifies the methods that an app should implement, such as loading its logo
pub trait AppTrait
where
    Self: Sized,
{
    fn load_icon(&self) -> Result<RustImageData>;
    fn from_path(path: &Path) -> Result<Self>;
}

pub trait AppInfo {
    /// It could take a few seconds to retrieve all apps, so a cache needs to be maintained
    /// This method is used to refresh the cache
    fn refresh_apps(&mut self) -> Result<()>;
    fn get_all_apps(&self) -> Vec<App>;
    fn open_file_with(&self, file_path: PathBuf, app: App);
    fn get_running_apps(&self) -> Vec<App>;
    fn get_frontmost_application(&self) -> Result<App>;
    fn is_refreshing(&self) -> bool;
    fn empty_cache(&mut self);
}

#[derive(Debug, Clone, Default, Eq, PartialEq, Serialize, Deserialize, Hash)]
pub struct SearchPath {
    pub path: PathBuf,
    pub depth: u8,
}

impl SearchPath {
    pub fn new(path: PathBuf, depth: u8) -> Self {
        Self { path, depth }
    }
}

#[derive(Debug, Clone, Default)]
pub struct AppInfoContext {
    pub cached_apps: Arc<Mutex<Vec<App>>>,
    pub refreshing: Arc<AtomicBool>,
    pub extra_search_paths: Vec<SearchPath>,
}