Emoji

Emoji for Python. This project was inspired by kyokomi.

Example

The entire set of Emoji codes as defined by the Unicode consortium is supported in addition to a bunch of aliases. By default, only the official list is enabled but doing emoji.emojize(language='alias') enables both the full list and aliases.

>>> import emoji
>>> print(emoji.emojize('Python is :thumbs_up:'))
Python is 👍
>>> print(emoji.emojize('Python is :thumbsup:', language='alias'))
Python is 👍
>>> print(emoji.demojize('Python is 👍'))
Python is :thumbs_up:
>>> print(emoji.emojize("Python is fun :red_heart:"))
Python is fun ❤
>>> print(emoji.emojize("Python is fun :red_heart:", variant="emoji_type"))
Python is fun ❤️ #red heart, not black heart
>>> print(emoji.is_emoji("👍"))
True

By default, the language is English (language='en') but also supported languages are:

Spanish ('es')
Portuguese ('pt')
Italian ('it')
French ('fr')
German ('de')
Farsi/Persian ('fa')
Indonesian ('id')
Simplified Chinese ('zh')
Japanese ('ja')
Korean ('ko')
Russian ('ru')
Arabic ('ar')
Turkish ('tr')

>>> print(emoji.emojize('Python es :pulgar_hacia_arriba:', language='es'))
Python es 👍
>>> print(emoji.demojize('Python es 👍', language='es'))
Python es :pulgar_hacia_arriba:
>>> print(emoji.emojize("Python é :polegar_para_cima:", language='pt'))
Python é 👍
>>> print(emoji.demojize("Python é 👍", language='pt'))
Python é :polegar_para_cima:️

Installation

Via pip:

$ python -m pip install emoji --upgrade

From master branch:

$ git clone https://github.com/carpedm20/emoji.git
$ cd emoji
$ python -m pip install .

Developing

$ git clone https://github.com/carpedm20/emoji.git
$ cd emoji
$ python -m pip install -e .\[dev\]
$ pytest
$ coverage run -m pytest
$ coverage report

The utils/get_codes_from_unicode_emoji_data_files.py is used to generate unicode_codes/data_dict.py. Generally speaking it scrapes a table on the Unicode Consortium’s website with BeautifulSoup and prints the contents to stdout as a Python dictionary. For more information take a look in the utils/README.md file.

Links

Documentation

https://carpedm20.github.io/emoji/docs/

Overview of all emoji:

https://carpedm20.github.io/emoji/

(auto-generated list of the emoji that are supported by the current version of this package)

For English:

Emoji Cheat Sheet

Official Unicode list

For Spanish:

For Portuguese:

For Italian:

For French:

For German:

Authors

Taehoon Kim / @carpedm20

Kevin Wurster / @geowurster

Maintainer

Tahir Jalilov / @TahirJalilov

Release files for emoji 2.10.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for emoji 2.10.1
File	Size	Uploaded
emoji-2.10.1.tar.gz	428.3 kB	Jan 31, 2024	Details

Built distribution (wheel)

Table of built distributions (wheels) for emoji 2.10.1
File	Interpreter	ABI	Platform	Reset
emoji-2.10.1-py2.py3-none-any.whl 421.5 kB Jan 31, 2024	Python 2, Python 3	none	any	Details

Total release size: 849.8 kB

Release files / emoji-2.10.1.tar.gz

Download URL	emoji-2.10.1.tar.gz
Size	428.3 kB
Tags	Source
SHA-256 checksum How to use checksums	`16287283518fb7141bde00198f9ffff4e1c1cb570efb68b2f1ec50975c3a581d`
BLAKE2b-256 checksum How to use checksums	`6c5c486737f2f26b9a3f684cfe2f642b618d79635905513f1d14a265f3b47b70`
Upload date	Jan 31, 2024
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/4.0.1 CPython/3.11.7`

Release files / emoji-2.10.1-py2.py3-none-any.whl

Download URL	emoji-2.10.1-py2.py3-none-any.whl
Size	421.5 kB
Tags	Python 2 Python 3
SHA-256 checksum How to use checksums	`11fb369ea79d20c14efa4362c732d67126df294a7959a2c98bfd7447c12a218e`
BLAKE2b-256 checksum How to use checksums	`980000d56e704d69cee4a92b1d517676579b4af5f2f8bc72946c464a504705b2`
Upload date	Jan 31, 2024
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/4.0.1 CPython/3.11.7`