// Copyright 2023 System76 // SPDX-License-Identifier: GPL-3.0-only use bstr::{BString, ByteSlice, ByteVec}; #[cfg(feature = "desktop")] use cosmic::desktop; use cosmic::widget; pub use mime_guess::Mime; #[cfg(feature = "desktop")] use notify_debouncer_full::notify; use rustc_hash::FxHashMap; use std::ffi::OsStr; use std::os::unix::ffi::OsStrExt; use std::path::{Path, PathBuf}; use std::sync::atomic::AtomicBool; use std::sync::{Arc, atomic}; use std::time::{self, Instant}; use std::{fs, io, process}; #[cfg(feature = "desktop")] pub async fn watch(mut emitter: impl FnMut() + 'static + Send) { let watcher_result = notify_debouncer_full::new_debouncer( time::Duration::from_millis(250), Some(time::Duration::from_millis(250)), move |event_res: notify_debouncer_full::DebounceEventResult| { let Ok(events) = event_res else { return; }; if events.iter().any(|event| { event.kind.is_create() || event.kind.is_modify() || event.kind.is_remove() }) { emitter(); } }, ); if let Ok(mut watcher) = watcher_result { let system_paths = cosmic_mime_apps::list_paths(); let local_paths = (|| { let base_dirs = xdg::BaseDirectories::new(); let Some(home) = base_dirs.get_config_home() else { return Err(std::io::Error::other("XDG config home not set")); }; let Ok(desktop) = std::env::var("XDG_CURRENT_DESKTOP") else { return Err(std::io::Error::other("XDG_CURRENT_DESKTOP unset")); }; let default_mimeapps = home.join("mimeapps.list"); let desktop_mimeapps = home.join([&desktop.to_ascii_lowercase(), "-mimeapps.list"].concat()); Ok([desktop_mimeapps, default_mimeapps]) })() .ok(); for path in system_paths .iter() .chain(local_paths.as_ref().into_iter().flatten()) { _ = watcher.watch(path.as_path(), notify::RecursiveMode::NonRecursive); } std::future::pending().await } } pub fn exec_to_command( exec: &str, entry_name: &str, entry_path: Option<&Path>, path_opt: &[impl AsRef], ) -> Option> { let arguments = shlex::split(exec)?; if arguments.is_empty() { tracing::error!("command does not contain any arguments"); return None; } let mut commands = Vec::new(); let paths = path_opt .iter() .map(AsRef::as_ref) .map(Some) // Add a single `None` if no path was given. .chain(std::iter::repeat_n( None, if path_opt.is_empty() { 1 } else { 0 }, )); for path in paths { let mut batch_process = false; let mut args = Vec::with_capacity(arguments.len()); let mut field_code_used = false; for argument in arguments.iter().skip(1) { let mut new_argument = BString::new(Vec::with_capacity(argument.capacity())); let mut chars = argument.chars(); while let Some(char) = chars.next() { // https://specifications.freedesktop.org/desktop-entry/latest/exec-variables.html if char == '%' { match chars.next() { Some('%') => new_argument.push_char(char), Some('c') => new_argument.push_str(entry_name), Some('k') => { if let Some(path) = entry_path { new_argument.push_str(path.as_os_str().as_bytes()); } } // %f and %u behave the same in a file manager. Some('f' | 'u') => { if let Some(path) = path && !field_code_used { // TODO: files on remote file systems should be copied to a temporary local file. batch_process = true; field_code_used = true; new_argument.push_str(path.as_bytes()); } } // %F and %U behave the same in a file manager. Some('F') | Some('U') => { if !field_code_used && new_argument.is_empty() { field_code_used = true; for path in path_opt.iter().map(AsRef::as_ref) { args.push(BString::new(path.as_bytes().to_owned())); } } } _ => (), } } else { new_argument.push_char(char); } } if !new_argument.is_empty() { args.push(new_argument); } } let mut command = process::Command::new(&arguments[0]); for arg in args { match arg.to_os_str() { Ok(arg) => { command.arg(arg); } Err(_) => { tracing::error!("invalid string encoding in command"); return None; } } } commands.push(command); if !batch_process { break; } } #[cfg(debug_assertions)] for command in &commands { log::debug!( "Parsed program {} with args: {:?}", command.get_program().to_string_lossy(), command.get_args() ); } Some(commands) } #[derive(Clone, Debug)] pub struct MimeApp { pub id: String, pub path: Option, pub name: String, pub exec: Option, pub icon: widget::icon::Handle, is_default: Arc, } impl MimeApp { //TODO: move to libcosmic, support multiple files pub fn command>(&self, path_opt: &[O]) -> Option> { exec_to_command( self.exec.as_deref()?, &self.name, self.path.as_deref(), path_opt, ) } pub fn is_default(&self) -> bool { self.is_default.load(atomic::Ordering::SeqCst) } } // This allows usage of MimeApp in a dropdown impl AsRef for MimeApp { fn as_ref(&self) -> &str { &self.name } } #[cfg(feature = "desktop")] impl From<&desktop::DesktopEntryData> for MimeApp { fn from(app: &desktop::DesktopEntryData) -> Self { Self { id: app.id.clone(), path: app.path.clone(), name: app.name.clone(), exec: app.exec.clone(), icon: match &app.icon { desktop::fde::IconSource::Name(name) => { widget::icon::from_name(name.as_str()).size(32).handle() } desktop::fde::IconSource::Path(path) => widget::icon::from_path(path.clone()), }, is_default: Arc::new(AtomicBool::new(false)), } } } pub struct MimeAppCache { apps: Vec>, cache: FxHashMap>>, icons: FxHashMap>, terminals: Vec>, } impl MimeAppCache { pub fn new() -> Self { let mut mime_app_cache = Self { apps: Vec::new(), cache: FxHashMap::default(), icons: FxHashMap::default(), terminals: Vec::new(), }; mime_app_cache.reload(); mime_app_cache } #[cfg(not(feature = "desktop"))] pub fn reload(&mut self) {} /// Reload mime types and their known app associations and defaults. #[cfg(feature = "desktop")] pub fn reload(&mut self) { use crate::localize::LANGUAGE_SORTER; use cosmic::desktop::fde; use std::borrow::Cow; let start = Instant::now(); self.apps.clear(); self.cache.clear(); self.icons.clear(); self.terminals.clear(); let mut list = cosmic_mime_apps::List::default(); let paths = cosmic_mime_apps::list_paths(); list.load_from_paths(&paths); let locales = fde::get_languages_from_env(); for desktop_entry in fde::Iter::new(fde::default_paths()).entries(Some(&locales)) { let name = desktop_entry .name(&locales) .unwrap_or_else(|| Cow::Borrowed(desktop_entry.id())); let app = Arc::new(MimeApp { id: desktop_entry.appid.clone(), path: Some(desktop_entry.path.clone()), name: name.into(), exec: desktop_entry.exec().map(String::from), icon: { let icon = desktop_entry.icon().unwrap_or_default(); if icon.starts_with('/') { cosmic::widget::icon::from_path(PathBuf::from(icon)) } else { cosmic::widget::icon::from_name(icon).size(32).handle() } }, is_default: Arc::new(AtomicBool::new(false)), }); tracing::info!(target: "mime-apps", id = app.id, "detected desktop entry"); self.apps.push(app.clone()); if desktop_entry .categories() .into_iter() .flatten() .any(|c| c == "TerminalEmulator") { self.terminals.push(app.clone()); } // Cache associations defined by the desktop entry. let mime_types = desktop_entry.mime_type().unwrap_or_else(Vec::new); for mime in mime_types.iter().filter_map(|m| m.parse::().ok()) { let apps = self.cache.entry(mime.clone()).or_default(); if apps.iter().all(|cached_app| cached_app.id != app.id) { apps.push(app.clone()); } } } // Cache added associations from mimeapps lists. for (added_mime, added_apps) in &list.added_associations { for added_app in added_apps { if let Some(app) = self .apps .iter() .find(|cached| cached.id.as_str() == added_app.as_ref()) { let apps = self.cache.entry(added_mime.clone()).or_default(); if apps.iter().all(|cached_app| cached_app.id != app.id) { apps.push(app.clone()); } } } } // Remove associations for (removed_mime, removed_apps) in &list.removed_associations { for removed_app in removed_apps { if let Some(app) = self .apps .iter() .find(|cached| cached.id.as_str() == removed_app.as_ref()) && let Some(apps) = self.cache.get_mut(removed_mime) { apps.retain(|cached_app| cached_app.id != app.id); } } } // Fetch defaults and sort apps by their default precedence. for (mime, mut apps) in std::mem::take(&mut self.cache).into_iter() { let defaults = list.default_app_for(&mime); let cache = self .cache .entry(mime.clone()) .or_insert_with(|| Vec::with_capacity(apps.len())); // Sort cached apps for this mime by default precedence. for default in defaults.into_iter().flatten() { let default = default.strip_suffix(".desktop").unwrap_or(default.as_ref()); apps.retain(|app| { let found = app.id.as_str() == default; if found { app.is_default.store(true, atomic::Ordering::Relaxed); cache.push(app.clone()); } !found }); } // Sort remaining apps by name apps.sort_by(|a, b| LANGUAGE_SORTER.compare(&a.name, &b.name)); cache.extend_from_slice(&apps); tracing::debug!(target: "mime-apps", mime = mime.essence_str(), apps = ?(cache.iter().map(|app| &*app.id).collect::>()), "mime defaults found") } // Copy icons to special cache //TODO: adjust dropdown API so this is no longer needed self.icons.extend(self.cache.iter().map(|(mime, apps)| { ( mime.clone(), apps.iter().map(|app| app.icon.clone()).collect(), ) })); let elapsed = start.elapsed(); tracing::info!(target: "mime-apps", "loaded mime app cache in {elapsed:?}"); } pub fn apps(&self) -> &[Arc] { &self.apps } pub fn get(&self, key: &Mime) -> &[Arc] { self.cache.get(key).map_or(&[], Vec::as_slice) } pub fn icons(&self, key: &Mime) -> &[widget::icon::Handle] { self.icons.get(key).map_or(&[], Box::as_ref) } fn get_default_terminal(&self) -> Option { let output = process::Command::new("xdg-mime") .args(["query", "default", "x-scheme-handler/terminal"]) .output() .ok()?; if !output.status.success() { return None; } String::from_utf8(output.stdout) .ok() .map(|string| string.trim().replace(".desktop", "")) } pub fn terminal(&self) -> Option<&Arc> { //TODO: consider rules in https://github.com/Vladimir-csp/xdg-terminal-exec // The current approach works but might not adhere to the spec (yet) // Look for and return preferred terminals //TODO: fallback order beyond cosmic-term? let mut preference_order = vec!["com.system76.CosmicTerm".to_string()]; if let Some(id) = self.get_default_terminal() { preference_order.insert(0, id); } for id in &preference_order { for terminal in &self.terminals { if &terminal.id == id { return Some(terminal); } } } // Return whatever was the first terminal found self.terminals.first() } #[cfg(not(feature = "desktop"))] pub fn set_default(&mut self, mime: Mime, id: String) { log::warn!( "failed to set default handler for {mime:?} to {id:?}: desktop feature not enabled" ); } #[cfg(feature = "desktop")] pub fn set_default(&mut self, mime: Mime, mut id: String) { let Some(path) = cosmic_mime_apps::local_list_path() else { log::warn!("failed to find mimeapps.list path"); return; }; let mut list = cosmic_mime_apps::List::default(); match fs::read_to_string(&path) { Ok(string) => { list.load_from(&string); } Err(err) => { if err.kind() != io::ErrorKind::NotFound { log::warn!("failed to read {}: {}", path.display(), err); return; } } } let suffix = ".desktop"; if !id.ends_with(suffix) { id.push_str(suffix); } list.set_default_app(mime, id); let mut string = list.to_string(); string.push('\n'); match fs::write(&path, string) { Ok(()) => { self.reload(); } Err(err) => { log::warn!("failed to write {}: {}", path.display(), err); } } } } impl Default for MimeAppCache { fn default() -> Self { Self::new() } } #[cfg(test)] mod tests { use super::exec_to_command; #[test] fn keys_within_words() { let exec = "/usr/bin/foo --option=%f"; let paths = ["file1"]; let commands = exec_to_command(exec, "keys_within_words", None, &paths) .expect("Should parse valid exec"); assert_eq!(1, commands.len()); let command = commands.first().unwrap(); assert_eq!("/usr/bin/foo", command.get_program().to_str().unwrap()); assert_eq!( "--option=file1", command.get_args().next().unwrap().to_str().unwrap() ); } #[test] fn no_path_f_field_code() { let exec = "/usr/bin/foo %f"; let paths: [&str; 0] = []; let commands = exec_to_command(exec, "no_path_f_field_code", None, &paths) .expect("Should parse valid exec"); assert_eq!(1, commands.len()); let command = commands.first().unwrap(); assert_eq!("/usr/bin/foo", command.get_program().to_str().unwrap()); assert_eq!(0, command.get_args().len()); } #[test] fn one_path_f_field_code() { let exec = "/usr/bin/foo %f"; let paths = ["file1"]; let commands = exec_to_command(exec, "one_path_f_field_code", None, &paths) .expect("Should parse valid exec"); assert_eq!(1, commands.len()); let command = commands.first().unwrap(); assert_eq!("/usr/bin/foo", command.get_program().to_str().unwrap()); assert_eq!( "file1", command.get_args().next().unwrap().to_str().unwrap() ); } #[test] #[allow(non_snake_case)] fn one_path_F_field_code() { let exec = "/usr/bin/cosmic-term -w %F"; let paths = ["/home/user"]; let commands = exec_to_command(exec, "one_path_F_field_code", None, &paths) .expect("Should parse valid exec"); assert_eq!(1, commands.len()); let command = commands.first().unwrap(); let mut args = command.get_args(); assert_eq!( "/usr/bin/cosmic-term", command.get_program().to_str().unwrap() ); assert_eq!("-w", args.next().unwrap().to_str().unwrap()); assert_eq!(paths[0], args.next().unwrap().to_str().unwrap()); } #[test] fn one_path_u_field_code() { let exec = "/usr/bin/cosmic-term -w %u"; let paths = ["/home/user"]; let commands = exec_to_command(exec, "one_path_u_field_code", None, &paths) .expect("Should parse valid exec"); assert_eq!(1, commands.len()); let command = commands.first().unwrap(); let mut args = command.get_args(); assert_eq!( "/usr/bin/cosmic-term", command.get_program().to_str().unwrap() ); assert_eq!("-w", args.next().unwrap().to_str().unwrap()); assert_eq!(paths[0], args.next().unwrap().to_str().unwrap()); } #[test] #[allow(non_snake_case)] fn one_path_U_field_code() { let exec = "/usr/bin/rmrfbye %U"; let paths = ["/"]; let commands = exec_to_command(exec, "one_path_U_field_code", None, &paths) .expect("Should parse valid exec"); assert_eq!(1, commands.len()); let command = commands.first().unwrap(); assert_eq!("/usr/bin/rmrfbye", command.get_program().to_str().unwrap()); assert_eq!("/", command.get_args().next().unwrap().to_str().unwrap()); } #[test] fn mult_path_f_field_code() { let exec = "/usr/games/ppsspp %f"; let paths = [ "/usr/share/games/psp/miku.iso", "/usr/share/games/psp/eternia.iso", ]; let commands = exec_to_command(exec, "mult_path_f_field_code", None, &paths) .expect("Should parse valid exec"); assert_eq!(paths.len(), commands.len()); for (command, path) in commands.into_iter().zip(paths.iter()) { assert_eq!("/usr/games/ppsspp", command.get_program().to_str().unwrap()); assert_eq!(1, command.get_args().len()); let command_path = command.get_args().next().unwrap(); assert_eq!(*path, command_path.to_str().unwrap()); } } #[test] #[allow(non_snake_case)] fn mult_path_F_field_code() { let exec = "/usr/games/gzdoom %F"; let paths = [ "/usr/share/games/doom2/hr.wad", "/usr/share/games/doom2/hrmus.wad", ]; let commands = exec_to_command(exec, "mult_path_F_field_code", None, &paths) .expect("Should parse valid exec"); assert_eq!(1, commands.len()); let command = commands.first().unwrap(); assert_eq!("/usr/games/gzdoom", command.get_program().to_str().unwrap()); assert!( paths .iter() .zip(command.get_args()) .all(|(&expected, actual)| expected == actual.to_string_lossy()) ); } #[test] fn mult_path_u_field_code() { let exec = "/usr/bin/cosmic_browser %u"; let paths = [ "file:///home/josh/Books/osstep.pdf", "https://redox-os.org/", "https://system76.com/", ]; let commands = exec_to_command(exec, "mult_path_u_field_code", None, &paths) .expect("Should parse valid exec"); assert_eq!(paths.len(), commands.len()); for (command, path) in commands.into_iter().zip(paths.iter()) { assert_eq!( "/usr/bin/cosmic_browser", command.get_program().to_str().unwrap() ); assert_eq!(1, command.get_args().len()); let command_path = command.get_args().next().unwrap(); assert_eq!(*path, command_path.to_str().unwrap()); } } #[test] #[allow(non_snake_case)] fn mult_path_U_field_code() { let exec = "/usr/bin/mpv %U"; let paths = [ "frieren01.mkv", "rtmp://example.org/this/video/doesnt/exist.avi", ]; let commands = exec_to_command(exec, "mult_path_U_field_code", None, &paths) .expect("Should parse valid exec"); assert_eq!(1, commands.len()); let command = commands.first().unwrap(); assert_eq!(paths.len(), command.get_args().count()); assert_eq!("/usr/bin/mpv", command.get_program().to_str().unwrap()); assert!( paths .iter() .zip(command.get_args()) .all(|(&expected, actual)| expected == actual.to_string_lossy()) ); } #[test] fn flatpak_style_exec() { // Tests args before field codes let exec = "/usr/bin/flatpak run --branch=stable --command=ferris --file-forwarding org.joshfake.ferris @@u %U"; let args = [ "run", "--branch=stable", "--command=ferris", "--file-forwarding", "org.joshfake.ferris", "@@u", ]; let paths = ["file1.rs", "file2.rs"]; let commands = exec_to_command(exec, "flatpak_style_exec", None, &paths) .expect("Should parse valid exec"); assert_eq!(1, commands.len()); let command = commands.first().unwrap(); assert_eq!(args.len() + paths.len(), command.get_args().count()); assert_eq!("/usr/bin/flatpak", command.get_program().to_str().unwrap()); assert!( args.iter() .chain(paths.iter()) .zip(command.get_args()) .all(|(&expected, actual)| expected == actual.to_string_lossy()) ); } #[test] fn multiple_field_codes() { // Tests that only one field code is used rather than passing paths to each field code let exec = "/usr/games/roguelike %U %f"; let paths = [ "file:///usr/share/games/roguelike/mods/mod1", "file:///usr/share/games/roguelike/mods/mod2", ]; let commands = exec_to_command(exec, "multiple_field_codes", None, &paths) .expect("Should parse valid exec"); assert_eq!(1, commands.len()); let command = commands.first().unwrap(); assert_eq!( "/usr/games/roguelike", command.get_program().to_str().unwrap() ); assert!( paths .iter() .zip(command.get_args()) .all(|(&expected, actual)| expected == actual.to_string_lossy()) ); } #[test] fn sandwiched_field_code() { // Tests that arguments before and after the field code works // (Borrowed from KDE because someone had this exact line in an issue) let exec = "/usr/bin/flatpak run --branch=stable --arch=x86_64 --command=okular --file-forwarding org.kde.okular @@u %U @@"; let args_leading = [ "run", "--branch=stable", "--arch=x86_64", "--command=okular", "--file-forwarding", "org.kde.okular", "@@u", ]; let paths = ["rust_game_dev.pdf", "superhero_ferris.epub"]; let args_trailing = ["@@"]; let commands = exec_to_command(exec, "sandwiched_field_code", None, &paths) .expect("Should parse valid exec"); assert_eq!(1, commands.len()); let command = commands.first().unwrap(); assert_eq!( args_leading.len() + paths.len() + args_trailing.len(), command.get_args().len() ); assert_eq!("/usr/bin/flatpak", command.get_program().to_str().unwrap()); assert!( args_leading .iter() .chain(paths.iter()) .chain(args_trailing.iter()) .zip(command.get_args()) .all(|(&expected, actual)| expected == actual.to_string_lossy()) ); } }