emoji-lexicon 0.1.2

A build-time generated emoji lexicon for Python

emoji-lexicon

🚀 emoji-lexicon is a fast, build-time generated emoji lexicon for Python, powered by Unicode emoji-test and CLDR annotations.

Features

• Fast emoji lookup by short name, alias, or tag
• Designed for CLI, IME, and dictionary tools
• Unicode / CLDR based canonical data
• Build-time normalization, runtime zero-cost lookup
• Optional gemoji-compatible export

Requirements

• Python 3.12+

Installation

pip install emoji-lexicon

Usage

from emoji_lexicon import get_catalog

catalog = get_catalog()

# lookup by short name or alias
catalog.get("smile")
# -> Emoji | None

# Slack / gemoji style
catalog.get(":smile:")

# lookup by emoji character
catalog.get_by_char("😁")
# -> Emoji | None

# get all emojis
catalog.get_all()

# total emoji count
len(catalog)

# iterator
for emoji in catalog:
	print(emoji.char, emoji.short_name)

.search() , .find()

# partial match (short_name / alias / tag)
catalog.search("happy")
# -> tuple[Emoji, ...]

# alias of .search()
catalog.find("happy")
# -> tuple[Emoji, ...]

.search() and .find() perform partial matching and return multiple emojis. .find() is a user-facing alias of .search().

.groups(), .subgroups()

from emoji_lexicon import get_catalog
catalog = get_catalog()

# available emoji groups
catalog.groups()

# available emoji subgroups
catalog.subgroups()

Application examples:

• Categories UI
• IME candidate narrowing down
• emoji picker

Design philosophy

• runtime zero-cost
• immutable catalog
• Pythonic & typed

License

MIT License © 2026 Kiminori Kato