Project: emoji

Emoji for Python

Project Details

Latest version
2.9.0
Home Page
https://github.com/carpedm20/emoji/
PyPI Page
https://pypi.org/project/emoji/

Project Popularity

PageRank
0.003487894253971226
Number of downloads
2526697

Emoji

Emoji for Python. This project was inspired by kyokomi <https://github.com/kyokomi/emoji>__.

Example

The entire set of Emoji codes as defined by the Unicode consortium <https://unicode.org/emoji/charts/full-emoji-list.html>__ is supported in addition to a bunch of aliases <https://www.webfx.com/tools/emoji-cheat-sheet/>__. By default, only the official list is enabled but doing emoji.emojize(language='alias') enables both the full list and aliases.

.. code-block:: python

>>> 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')

.. code-block:: python

>>> 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:

.. code-block:: console

$ python -m pip install emoji --upgrade

From master branch:

.. code-block:: console

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

Developing

.. code-block:: console

$ 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 <https://www.unicode.org/reports/tr51/#emoji_data>__ with BeautifulSoup <http://www.crummy.com/software/BeautifulSoup/>__ and prints the contents to stdout as a Python dictionary. For more information take a look in the utils/README.md <utils/README.md>__ file.

Links

Documentation

https://carpedm20.github.io/emoji/docs/ <https://carpedm20.github.io/emoji/docs/>__

Overview of all emoji:

https://carpedm20.github.io/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 <https://www.webfx.com/tools/emoji-cheat-sheet/>__

Official Unicode list <http://www.unicode.org/emoji/charts/full-emoji-list.html>__

For Spanish:

Unicode list <https://emojiterra.com/es/lista-es/>__

For Portuguese:

Unicode list <https://emojiterra.com/pt/lista/>__

For Italian:

Unicode list <https://emojiterra.com/it/lista-it/>__

For French:

Unicode list <https://emojiterra.com/fr/liste-fr/>__

For German:

Unicode list <https://emojiterra.com/de/liste/>__

Authors

Taehoon Kim / @carpedm20 <http://carpedm20.github.io/about/>__

Kevin Wurster / @geowurster <http://twitter.com/geowurster/>__

Maintainer

Tahir Jalilov / @TahirJalilov <https://github.com/TahirJalilov>__