Struct DesktopApp 

pub struct DesktopApp {
    pub id: String,
    pub name: String,
    pub exec: String,
    pub terminal: bool,
    pub mime_types: Vec<String>,
    pub path: PathBuf,
    pub icon: Option<String>,
}

A program, as its desktop entry describes it.

Fields

id: String

The desktop file id (org.gnome.TextEditor.desktop): the entry’s path below applications, folders joined with -. mimeapps.list names programs by it.

name: String

The program’s name in the person’s language when the entry has one.

exec: String

The Exec line, with the key file’s escapes resolved.

terminal: bool

Whether the program runs inside a terminal.

mime_types: Vec<String>

The kinds the program says it opens.

path: PathBuf

Where the desktop entry is.

icon: Option<String>

The program’s icon name, when it has one.

Implementations

impl DesktopApp

pub fn command(&self, file: &Path) -> Option<Vec<OsString>>

The command that opens file with this program, program first: the Exec line with its field codes filled in. None when the line is empty or malformed.

No shell is involved; the file is always one argument, whatever its name holds.

impl DesktopApp

pub fn can_start(&self, graphical: bool) -> bool

Whether this program can start here: a terminal program always can, a graphical one only in a graphical session (see graphical_session). A menu shows the others dimmed.

pub fn launch<Msg: Send + 'static>( &self, file: &Path, graphical: bool, on_done: impl FnOnce(Launched) -> Msg + Send + 'static, ) -> Result<Command<Msg>, LaunchError>

The command that opens file with this program, delivering on_done with how it ended.

A terminal program (Terminal=true) goes through a Handoff: the application steps aside, the program owns the terminal, and the screen comes back when it ends. A graphical one goes through Open::program and starts quietly beside the application. graphical says whether there is a graphical session; without one a graphical program is refused instead of tried. The arguments are those of DesktopApp::command, so no shell is involved.

Either way the program runs in the file’s folder, as desktop file managers start it: relative paths, “Save as” and a shell opened from the program begin beside the file, not wherever the application happened to be started. A file given without a folder leaves the application’s own.

In a Harness nothing runs: the handoff or the opening is recorded, and a test reads it, folder included, from handoffs() or opens().

Errors

LaunchError::NoGraphicalSession for a graphical program without a graphical session, LaunchError::NoCommand when the Exec line gives no command.

Trait Implementations

impl Clone for DesktopApp

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DesktopApp

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

Formats the value using the given formatter.

impl Eq for DesktopApp

impl PartialEq for DesktopApp

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for DesktopApp