Function parse_entry 

pub fn parse_entry(input: impl AsRef<Path>) -> Result<Entry>

Parse a FreeDesktop entry file.

Example

use freedesktop_entry_parser::parse_entry;

let entry = parse_entry("./test_data/sshd.service")?;
let start_cmd = &entry
    .get("Service", "ExecStart")
    .expect("File doesn't have Service -> ExecStart")[0];
assert_eq!(start_cmd, "/usr/bin/sshd -D");

Errors

If there is a parse error it’ll be return an ParseError wrapped std::io::Error with the std::io::ErrorKind::Other.

use freedesktop_entry_parser::parse_entry;

match parse_entry("./test_data/sshd.service") {
    Ok(entry) => println!("{entry:#?}"),
    Err(e) if e.kind() == std::io::ErrorKind::Other => println!("Parse error {e:?}"),
    Err(e) => println!("I/O Error {e:?}"),
}

Examples found in repository

examples/systemd_start_cmd.rs (line 5)

fn main() -> Result<()> {
    let entry = parse_entry("./test_data/sshd.service")?;
    let start_cmd = &entry
        .section("Service")
        .expect("Section Service doesn't exist")
        .attr("ExecStart")[0];
    println!("{}", start_cmd);
    Ok(())
}

examples/get_localized_name.rs (line 5)

fn main() -> std::io::Result<()> {
    let lang = std::env::args().nth(1).expect("Not enough args");
    let entry = parse_entry("./test_data/firefox.desktop")?;
    let desktop_section = entry.section("Desktop Entry").unwrap();
    match desktop_section.attr_with_param("GenericName", lang).get(0) {
        Some(localized_name) => println!("{localized_name}"),
        None => println!("No name for that lang"),
    }
    Ok(())
}