Skip to main content

Emoji for Python

Project description

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/generate_emoji.py script is used to generate unicode_codes/emoji.json. Generally speaking it scrapes a table on the Unicode Consortium’s website with BeautifulSoup For more information take a look in the utils/README.md file.

Check the code style with:

$ python -m pip install ruff
$ ruff check emoji

Test the type checks with:

$ python -m pip install pyright mypy typeguard
$ pyright emoji
$ pyright tests
$ mypy emoji
$ pytest --typeguard-packages=emoji

Authors

Taehoon Kim / @carpedm20

Kevin Wurster / @geowurster

Maintainer

Tahir Jalilov / @TahirJalilov

Download files

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

Source Distribution

emoji-2.14.1.tar.gz (597.2 kB view details)

Uploaded Source

Built Distribution

emoji-2.14.1-py3-none-any.whl (590.6 kB view details)

Uploaded Python 3

File details

Details for the file emoji-2.14.1.tar.gz.

File metadata

  • Download URL: emoji-2.14.1.tar.gz
  • Upload date:
  • Size: 597.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/5.1.1 CPython/3.12.8

File hashes

Hashes for emoji-2.14.1.tar.gz
Algorithm Hash digest
SHA256 f8c50043d79a2c1410ebfae833ae1868d5941a67a6cd4d18377e2eb0bd79346b
MD5 26029c98ab839799f2416ef9f807c9f7
BLAKE2b-256 cb7d01cddcbb6f5cc0ba72e00ddf9b1fa206c802d557fd0a20b18e130edf1336

See more details on using hashes here.

File details

Details for the file emoji-2.14.1-py3-none-any.whl.

File metadata

  • Download URL: emoji-2.14.1-py3-none-any.whl
  • Upload date:
  • Size: 590.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/5.1.1 CPython/3.12.8

File hashes

Hashes for emoji-2.14.1-py3-none-any.whl
Algorithm Hash digest
SHA256 35a8a486c1460addb1499e3bf7929d3889b2e2841a57401903699fef595e942b
MD5 320025088fb3ff76d76931bf9d49c449
BLAKE2b-256 91dba0335710caaa6d0aebdaa65ad4df789c15d89b7babd9a30277838a7d9aac

See more details on using hashes here.

Supported by

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