freedesktop_desktop_entry/

decoder.rs

// Copyright 2021 System76 <info@system76.com>
// SPDX-License-Identifier: MPL-2.0

use std::{
    fs::{self},
    mem,
    path::{Path, PathBuf},
};

use crate::{DesktopEntry, Group};
use crate::{Groups, LocaleMap};
use thiserror::Error;

#[derive(Debug, Error)]
pub enum DecodeError {
    #[error("path does not contain a valid app ID")]
    AppID,
    #[error(transparent)]
    Io(#[from] std::io::Error),
    #[error("MultipleGroupWithSameName")]
    MultipleGroupWithSameName,
    #[error("KeyValueWithoutAGroup")]
    KeyValueWithoutAGroup,
    #[error("InvalidKey. Accepted: A-Za-z0-9")]
    InvalidKey,
    #[error("KeyDoesNotExist, this can happens when a localized key has no default value")]
    KeyDoesNotExist,
    #[error("InvalidValue")]
    InvalidValue,
}

impl DesktopEntry {
    pub fn from_str<L>(
        path: impl Into<PathBuf>,
        input: &str,
        locales_filter: Option<&[L]>,
    ) -> Result<DesktopEntry, DecodeError>
    where
        L: AsRef<str>,
    {
        let path: PathBuf = path.into();

        let appid = get_app_id(&path)?;

        let mut groups = Groups::default();
        let mut active_group: Option<ActiveGroup> = None;
        let mut active_keys: Option<ActiveKeys> = None;
        let mut ubuntu_gettext_domain = None;

        let locales_filter = locales_filter.map(add_generic_locales);

        let mut missing_keys = Vec::new();
        for line in input.lines() {
            process_line(
                line,
                &mut groups,
                &mut active_group,
                &mut active_keys,
                &mut ubuntu_gettext_domain,
                locales_filter.as_deref(),
                &mut missing_keys,
            )?;
        }
        if missing_keys.len() > 0 {
            let mut check_again = mem::take(&mut missing_keys);
            for missing in check_again.drain(..) {
                process_line(
                    missing,
                    &mut groups,
                    &mut active_group,
                    &mut active_keys,
                    &mut ubuntu_gettext_domain,
                    locales_filter.as_deref(),
                    &mut missing_keys,
                )?;
            }
            if missing_keys.len() > 0 {
                return Err(DecodeError::KeyDoesNotExist);
            }
        }

        if let Some(active_keys) = active_keys.take() {
            match &mut active_group {
                Some(active_group) => {
                    active_group.group.0.insert(
                        active_keys.key_name,
                        (active_keys.default_value, active_keys.locales),
                    );
                }
                None => return Err(DecodeError::KeyValueWithoutAGroup),
            }
        }

        if let Some(group) = active_group.take() {
            if groups.0.insert(group.group_name, group.group).is_some() {
                return Err(DecodeError::MultipleGroupWithSameName);
            }
        }

        Ok(DesktopEntry {
            appid: appid.to_string(),
            groups,
            path,
            ubuntu_gettext_domain,
        })
    }

    /// Return an owned [`DesktopEntry`]
    pub fn from_path<L>(
        path: impl Into<PathBuf>,
        locales_filter: Option<&[L]>,
    ) -> Result<DesktopEntry, DecodeError>
    where
        L: AsRef<str>,
    {
        let path: PathBuf = path.into();
        let input = fs::read_to_string(&path)?;
        Self::from_str(path, &input, locales_filter)
    }
}

fn get_app_id<P: AsRef<Path> + ?Sized>(path: &P) -> Result<&str, DecodeError> {
    let appid = path
        .as_ref()
        .file_stem()
        .ok_or(DecodeError::AppID)?
        .to_str()
        .ok_or(DecodeError::AppID)?;
    Ok(appid)
}

#[derive(Debug)]
struct ActiveGroup {
    group_name: String,
    group: Group,
}

#[derive(Debug)]
struct ActiveKeys {
    key_name: String,
    default_value: String,
    locales: LocaleMap,
}

#[inline]
fn process_line<'a, L: AsRef<str>>(
    line: &'a str,
    groups: &mut Groups,
    active_group: &mut Option<ActiveGroup>,
    active_keys: &mut Option<ActiveKeys>,
    ubuntu_gettext_domain: &mut Option<String>,
    locales_filter: Option<&[L]>,
    missing_keys: &mut Vec<&'a str>,
) -> Result<(), DecodeError> {
    if line.trim().is_empty() || line.starts_with('#') {
        return Ok(());
    }

    let line_bytes = line.as_bytes();

    if line_bytes[0] == b'[' {
        if missing_keys.len() > 0 {
            let mut check_again = mem::take(missing_keys);
            for missing in check_again.drain(..) {
                process_line(
                    missing,
                    groups,
                    active_group,
                    active_keys,
                    ubuntu_gettext_domain,
                    locales_filter,
                    missing_keys,
                )?;
            }
            if missing_keys.len() > 0 {
                return Err(DecodeError::KeyDoesNotExist);
            }
        }
        if let Some(end) = memchr::memrchr(b']', &line_bytes[1..]) {
            let group_name = &line[1..end + 1];

            if let Some(active_keys) = active_keys.take() {
                match active_group {
                    Some(active_group) => {
                        active_group.group.0.insert(
                            active_keys.key_name,
                            (active_keys.default_value, active_keys.locales),
                        );
                    }
                    None => return Err(DecodeError::KeyValueWithoutAGroup),
                }
            }

            if let Some(group) = active_group.take() {
                if groups.0.insert(group.group_name, group.group).is_some() {
                    return Err(DecodeError::MultipleGroupWithSameName);
                }
            }

            active_group.replace(ActiveGroup {
                group_name: group_name.to_string(),
                group: Group::default(),
            });
        }
    } else if let Some(delimiter) = memchr::memchr(b'=', line_bytes) {
        let key = &line[..delimiter];
        let value = format_value(&line[delimiter + 1..])?;

        if key.is_empty() {
            return Err(DecodeError::InvalidKey);
        }

        // if locale
        if key.as_bytes()[key.len() - 1] == b']' {
            if let Some(start) = memchr::memchr(b'[', key.as_bytes()) {
                // verify that the name is the same of active key ?
                // or we can assume this is the case
                // let local_key = &key[..start];

                let locale = &key[start + 1..key.len() - 1];

                match locales_filter {
                    Some(locales_filter)
                        if !locales_filter.iter().any(|l| l.as_ref() == locale) =>
                    {
                        return Ok(())
                    }
                    _ => (),
                }

                match active_keys {
                    Some(active_keys) => {
                        active_keys.locales.insert(locale.to_string(), value);
                    }
                    None => {
                        missing_keys.push(line);
                    }
                }

                return Ok(());
            }
        }

        if key == "X-Ubuntu-Gettext-Domain" {
            *ubuntu_gettext_domain = Some(value.to_string());
            return Ok(());
        }

        if let Some(active_keys) = active_keys.take() {
            match active_group {
                Some(active_group) => {
                    active_group.group.0.insert(
                        active_keys.key_name,
                        (active_keys.default_value, active_keys.locales),
                    );
                }
                None => return Err(DecodeError::KeyValueWithoutAGroup),
            }
        }
        active_keys.replace(ActiveKeys {
            // todo: verify that the key only contains A-Za-z0-9 ?
            key_name: key.trim().to_string(),
            default_value: value,
            locales: LocaleMap::default(),
        });
    }
    Ok(())
}

// https://specifications.freedesktop.org/desktop-entry-spec/latest/value-types.html
#[inline]
fn format_value(input: &str) -> Result<String, DecodeError> {
    let input = if let Some(input) = input.strip_prefix(" ") {
        input
    } else {
        input
    };

    let mut res = String::with_capacity(input.len());

    let mut last: usize = 0;

    for i in memchr::memchr_iter(b'\\', input.as_bytes()) {
        // edge case for //
        if last > i {
            continue;
        }

        // when there is an \ at the end
        if input.len() <= i + 1 {
            return Err(DecodeError::InvalidValue);
        }

        if last < i {
            res.push_str(&input[last..i]);
        }

        last = i + 2;

        match input.as_bytes()[i + 1] {
            b's' => res.push(' '),
            b'n' => res.push('\n'),
            b't' => res.push('\t'),
            b'r' => res.push('\r'),
            b'\\' => res.push('\\'),
            _ => {
                return Err(DecodeError::InvalidValue);
            }
        }
    }

    if last < input.len() {
        res.push_str(&input[last..input.len()]);
    }

    Ok(res)
}

/// Ex: if a locale equal fr_FR, add fr
pub(crate) fn add_generic_locales<L: AsRef<str>>(locales: &[L]) -> Vec<&str> {
    let mut v = Vec::with_capacity(locales.len() + 1);

    for l in locales {
        let l = l.as_ref();

        v.push(l);

        if let Some(start) = memchr::memchr(b'_', l.as_bytes()) {
            v.push(l.split_at(start).0)
        }
    }

    v
}