Metadata-Version: 2.4
Name: emoji-index
Version: 0.1.2
Summary: A lightweight extension to the emoji library providing indexed traversal of emoji characters for selection menus
Author-email: nQuest Corporation <support@nquest.io>
License-Expression: Apache-2.0
Project-URL: Homepage, https://github.com/nquest-corp/emoji-index
Project-URL: Repository, https://github.com/nquest-corp/emoji-index
Project-URL: Issues, https://github.com/nquest-corp/emoji-index/issues
Keywords: emoji,unicode,index,emoji-data,emoji-picker
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Text Processing
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
License-File: LICENSE_UNICODE.txt
Requires-Dist: emoji>=2.9.0
Dynamic: license-file

# emoji-index

This is a lightweight extension to the excellent [https://github.com/carpedm20/emoji/]emoji library that provides a simple index / traversal of emoji characters to assist with selection menus.

## Using the Project

```python
from emoji_index import emoji_index

emoji_index.set_version("13.0")

print(emoji_index.version)

for group in emoji_index.groups:
    print(group)
    for subgroup in emoji_index[group].subgroups:
        print(subgroup)
        for emoji in emoji_index[group][subgroup]:
            print(emoji)
```

## Known Limitations

Multi-person grouping emojis are not supported, as these require special handling that is at the moment out of scope. (https://www.unicode.org/reports/tr51/#MultiPersonGroupingsTable)

Additionally, hair component modifiers are not presently supported. (https://www.unicode.org/reports/tr51/#hair_components)

## Licensing

This project is released under the Apache 2.0 License. See the license file for the Apache 2.0 License.

Note that the project also contains data by the Unicode Consortium, which is licensed under the Unicode License Agreement. See the license file for the Unicode License Agreement Reference.
