Skip to main content

Provides all Unicode Emojis as an enum.

Project description

Unicode Emoji

This library provides all unicode emojis as an enum. You can use it to:

  • Turn emojis into descriptions;
  • Use emojis from code by textual description;
  • Detecting emojis in text;

Turn an emoji into a description

You can turn an emoji into a description (for example for sentiment analysis) by converting a string into an Emoji enum:

from UnicodeEmoji import Emoji

print(Emoji("😸").name)

# >>> 'grinning_cat_with_smiling_eyes'

Using Emojis from code by description

Sometimes it is easier to use textual descriptions of emojis in your code instead of the unicode representation directly.

This is especially the case for emojis that are composed of multiple parts, for example the woman technologist emoji 👩‍💻 which in some editors and terminals renders as 👩💻.

It can also be easier to differentiate between hard to spot differences, for example the grinning cat 😺 and cat face 🐱

from UnicodeEmoji import Emoji

print(f"Can you see the difference between a grinning cat {Emoji.grinning_cat} and a cat face {Emoji.cat_face}?")

# >>> Can you see the difference between a grinning cat 😺 and a cat face 🐱?

Detecting emojis in text

It can also be useful to detect if a string contains an emoji:

from UnicodeEmoji import Emoji

input = "Hi there! 😄"

all_emojis = [str(emoji) for emoji in Emoji]
input_contains_emoji = any(c in all_emojis for c in input)

print(input_contains_emoji)

# >>> True

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

UnicodeEmoji-0.0.2.tar.gz (19.5 kB view hashes)

Uploaded Source

Built Distribution

UnicodeEmoji-0.0.2-py3-none-any.whl (18.8 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page