Metadata-Version: 2.1
Name: random-unicode-emoji
Version: 2.2
Summary: A Python package and function to retrieve a random Unicode emoji. ❤
Home-page: https://github.com/NicPWNs/random-unicode-emoji
Author: Nic Jones
Author-email: nic@nicpjones.com
License: MIT
Download-URL: https://github.com/NicPWNs/random-unicode-emoji/releases
Keywords: random unicode emoji function
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3
Description-Content-Type: text/markdown

# Random Unicode Emoji

[![Python](https://img.shields.io/pypi/pyversions/random-unicode-emoji)](https://pypi.org/project/random-unicode-emoji/)
[![PyPI Version](https://img.shields.io/pypi/v/random-unicode-emoji)](https://pypi.org/project/random-unicode-emoji/)
[![Downloads](https://pepy.tech/badge/random-unicode-emoji)](https://pepy.tech/project/random-unicode-emoji)
[![GitHub Repo stars](https://img.shields.io/github/stars/NicPWNs/random-unicode-emoji)](https://github.com/NicPWNs/random_unicode_emoji/stargazers)
[![Forks](https://img.shields.io/github/forks/NicPWNs/random-unicode-emoji.svg)](https://github.com/NicPWNs/random-unicode-emoji/forks)
[![GitHub Repo size](https://img.shields.io/github/repo-size/NicPWNs/random-unicode-emoji)](https://github.com/NicPWNs/random_unicode_emoji)
[![License](https://img.shields.io/badge/license-MIT-green.svg)](https://github.com/NicPWNs/random_unicode_emoji/blob/main/LICENSE.rst)
[![Open Issues](https://img.shields.io/github/issues/NicPWNs/random-unicode-emoji.svg)](https://github.com/NicPWNs/random-unicode-emoji/issues)
[![Project Status](http://www.repostatus.org/badges/latest/active.svg)](http://www.repostatus.org/#active)

A Python package and function to retrieve a random Unicode emoji. ️

> Like this repo? Give it a [star on GitHub!](https://github.com/NicPWNs/random_unicode_emoji)

## Install

```bash
pip install random-unicode-emoji
```

> No dependencies!

## Usage

```py
# Import the Library
from random_unicode_emoji import random_emoji
# Use the Function
print(random_emoji())
# Use Specific Version
print(random_emoji(version="14.0"))
```

## Upgrade

Upgrade to the latest version:

```bash
pip install random-unicode-emoji -U
```

## Unicode

Uses Unicode Standard Emoji from [unicode.org](https://www.unicode.org/Public/emoji/)

### Supported Versions

4.0, 5.0, 11.0, 12.0, 12.1, 13.0, 13.1, 14.0, 15.0, and latest=15.0

> _Uses latest version by default._

## Maintainer

[Nic Jones, (NicPWNs)](https://github.com/NicPWNs)

## References

Originally Inspired by [randomEmoji.py](https://gist.github.com/shello/efa2655e8a7bce52f273)


