klirr-core 0.2.1

Zero-maintenance and smart FOSS generating beautiful invoices for services and expenses.
Documentation
use core::fmt;

use crate::prelude::*;

#[derive(
    Clone, Copy, PartialEq, Eq, Default, Hash, DeserializeFromStr, SerializeDisplay, EnumIter,
)]
pub enum Language {
    /// πŸ‡¬πŸ‡§ English
    #[default]
    EN,
    /// πŸ‡ΈπŸ‡ͺ Swedish
    SV,
}

pub trait VariantIterable {
    fn all() -> impl Iterator<Item = Self>;
}

impl VariantIterable for Language {
    /// Returns all available languages as an iterator.
    /// This can be used to iterate over all supported languages.
    /// # Examples
    /// ```
    /// use klirr_core::prelude::*;
    /// for lang in Language::all() {
    ///     println!("Supported language: {}", lang);
    /// }
    /// ```
    fn all() -> impl Iterator<Item = Self> {
        Self::iter()
    }
}

impl fmt::Debug for Language {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        let debug_str = match self {
            Language::EN => "EN",
            Language::SV => "SV",
        };
        write!(f, "{}", debug_str)
    }
}

impl fmt::Display for Language {
    /// Formats the language as a human-readable string.
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        let name = match self {
            Language::EN => "english",
            Language::SV => "swedish",
        };
        write!(f, "{}", name)
    }
}

impl FromStr for Language {
    type Err = String;

    /// Parses a language code or name into a `Language` enum.
    /// Accepts "en", "english", "sv", and "swedish" (case-insensitive).
    ///
    /// # Errors
    /// Returns an error if the string does not match any known language.
    ///
    /// # Examples
    /// ```
    /// extern crate klirr_core;
    /// use klirr_core::prelude::*;
    /// let lang: Language = "en".parse().unwrap();
    /// assert_eq!(lang, Language::EN);
    /// let lang: Language = "swedish".parse().unwrap();
    /// assert_eq!(lang, Language::SV);
    /// ```
    fn from_str(s: &str) -> Result<Self, Self::Err> {
        match s.to_ascii_lowercase().as_str() {
            "en" | "english" => Ok(Language::EN),
            "sv" | "swedish" => Ok(Language::SV),
            _ => Err(format!("unknown language code: {}", s)),
        }
    }
}

#[cfg(test)]
mod tests {
    use super::*;
    use insta::assert_debug_snapshot;
    use test_log::test;

    #[test]
    fn test_language_debug() {
        assert_debug_snapshot!(Language::EN, @"EN");
        assert_debug_snapshot!(Language::SV, @"SV");
    }

    #[test]
    fn test_language_display() {
        assert_eq!(Language::EN.to_string(), "english");
        assert_eq!(Language::SV.to_string(), "swedish");
    }

    #[test]
    fn test_language_from_str() {
        assert_eq!("en".parse::<Language>().unwrap(), Language::EN);
        assert_eq!("sv".parse::<Language>().unwrap(), Language::SV);
        assert!("unknown".parse::<Language>().is_err());
    }
}