Struct DesktopFile 

pub struct DesktopFile { /* private fields */ }

An in-memory, order-preserving view of a .desktop file.

use runlatch_core::desktop_file::{DesktopFile, DESKTOP_ENTRY_GROUP};

let mut file = DesktopFile::parse("[Desktop Entry]\nName=Example\nExec=example\n");
assert_eq!(file.get(DESKTOP_ENTRY_GROUP, "Name"), Some("Example"));

// Editing one key leaves everything else byte-for-byte intact.
file.set(DESKTOP_ENTRY_GROUP, "Hidden", "true");
assert_eq!(
    file.to_text(),
    "[Desktop Entry]\nName=Example\nExec=example\nHidden=true\n",
);

Implementations

impl DesktopFile

pub fn parse(text: &str) -> Self

Parse desktop-file text into an editable, order-preserving model.

pub fn to_text(&self) -> String

Serialize back to desktop-file text (always newline-terminated).

pub fn get(&self, group: &str, key: &str) -> Option<&str>

Get the value of key within group, if present.

pub fn set(&mut self, group: &str, key: &str, value: &str)

Set key=value within group, updating in place if the key exists, appending to the end of the group otherwise. The group is created at the end of the file if it does not yet exist.

pub fn remove(&mut self, group: &str, key: &str) -> bool

Remove key from group. Returns true if a key was removed.

Trait Implementations

impl Clone for DesktopFile

fn clone(&self) -> DesktopFile

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DesktopFile

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

Formats the value using the given formatter.

impl Default for DesktopFile

fn default() -> DesktopFile

Returns the “default value” for a type.