emojis

✨ Lookup and iterate over emoji names, shortcodes, and groups.

Features

• Lookup up emoji by Unicode value.
• Lookup up emoji by GitHub shortcode.
• Iterate over emojis in recommended order.
• Iterate over emojis in an emoji group. E.g. "Smileys & Emotion" or "Flags".
• Iterate over the skin tones for an emoji.
• Uses Unicode emoji spec (v14.0).

Examples

let hand = emojis::get("🤌")?;
// Or
let hand = emojis::get_by_shortcode("pinched_fingers")?;

assert_eq!(hand.as_str(), "\u{1f90c}");
assert_eq!(hand.name(), "pinched fingers");
assert_eq!(hand.unicode_version(), emojis::UnicodeVersion::new(13, 0));
assert_eq!(hand.group(), emojis::Group::PeopleAndBody);
assert_eq!(hand.shortcode()?, "pinched_fingers");
assert_eq!(hand.skin_tone()?, emojis::SkinTone::Default);

// iterate over all the emojis.
let smiley = emojis::iter().next()?;
assert_eq!(smiley, "😀");

// iterate and filter out newer emoji versions.
let iter = emojis::iter().filter(|e| {
    e.unicode_version() < emojis::UnicodeVersion::new(13, 0)
});

// iterate over all the emojis in a group.
let grapes = emojis::Group::FoodAndDrink.emojis().next()?;
assert_eq!(grapes, "🍇");

// iterate over the skin tones for an emoji.
let raised_hands = emojis::get("🙌🏼")?;
let skin_tones: Vec<_> = raised_hands.skin_tones()?.map(|e| e.as_str()).collect();
assert_eq!(skin_tones, ["🙌", "🙌🏻", "🙌🏼", "🙌🏽", "🙌🏾", "🙌🏿"]);

See examples/replace.rs for an example that replaces gemoji names in text.

$ echo "launch :rocket:" | cargo run --example replace
launch 🚀

License

Licensed under either of

• Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
• MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)

at your option.