# random-unicode-emoji
[![python](https://img.shields.io/pypi/pyversions/random-unicode-emoji)](https://pypi.org/project/random-unicode-emoji/)
[![pypi](https://img.shields.io/pypi/v/random-unicode-emoji)](https://pypi.org/project/random-unicode-emoji/)
[![Unicode](https://img.shields.io/badge/Unicode-15.0-success)](https://www.unicode.org/Public/emoji/15.0/)
[![downloads](https://pepy.tech/badge/random-unicode-emoji)](https://pepy.tech/project/random-unicode-emoji)
[![stars](https://img.shields.io/github/stars/NicPWNs/random-unicode-emoji-py)](https://github.com/NicPWNs/random-unicode-emoji-py/stargazers)
[![forks](https://img.shields.io/github/forks/NicPWNs/random-unicode-emoji-py.svg)](https://github.com/NicPWNs/random-unicode-emoji-py/forks)
[![repo size](https://img.shields.io/github/repo-size/NicPWNs/random-unicode-emoji-py)](https://github.com/NicPWNs/random-unicode-emoji-py)
[![license](https://img.shields.io/badge/license-MIT-green.svg)](https://github.com/NicPWNs/random-unicode-emoji-py/blob/main/LICENSE.rst)
[![issues](https://img.shields.io/github/issues/NicPWNs/random-unicode-emoji-py.svg)](https://github.com/NicPWNs/random-unicode-emoji-py/issues)
A simple Python package that returns random Unicode emojis. 🐍
> Like this repo? Give it a [star on GitHub!](https://github.com/NicPWNs/random-unicode-emoji-py)
## Install
Install the package:
```bash
pip install random-unicode-emoji
```
> No dependencies!
## Usage
Use the package:
```py
# Import the Library
from random_unicode_emoji import random_emoji
# Use the Function
print(random_emoji())
# Return Specific Count
print(random_emoji(count=3))
# Use Specific Version
print(random_emoji(version="15.0"))
# Append Custom Emoji
print(random_emoji(custom=['(° ͜ʖ ͡°)','(╯°□°)╯︵ ┻━┻']))
# All Together Now
print(random_emoji(3, 15, ['(° ͜ʖ ͡°)','(╯°□°)╯︵ ┻━┻']))
```
## Upgrade
Upgrade the package 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 Unicode Versions
4.0, 5.0, 11.0, 12.0, 12.1, 13.0, 13.1, 14.0, 15.0 (latest)
> _Uses latest version by default._
## Language
This is the Python 🐍 version. There is also a [JavaScript 📜](https://github.com/NicPWNs/random-unicode-emoji) and [Rust ⚙️](https://github.com/NicPWNs/random-unicode-emoji-rs) version.
## Maintainer
[Nic Jones, (NicPWNs)](https://github.com/NicPWNs)
## Credit
Originally Inspired by [randomEmoji.py](https://gist.github.com/shello/efa2655e8a7bce52f273)
Raw data
{
"_id": null,
"home_page": "https://github.com/NicPWNs/random-unicode-emoji-py",
"name": "random-unicode-emoji",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3",
"maintainer_email": "",
"keywords": "random unicode emoji function",
"author": "Nic Jones",
"author_email": "nic@nicpjones.com",
"download_url": "https://files.pythonhosted.org/packages/de/0f/5cb72fe185023f2af92fe922eb3fa260d37284cb8c65fb39e590851cf5b3/random_unicode_emoji-2.8.tar.gz",
"platform": null,
"description": "# random-unicode-emoji\r\n\r\n[![python](https://img.shields.io/pypi/pyversions/random-unicode-emoji)](https://pypi.org/project/random-unicode-emoji/)\r\n[![pypi](https://img.shields.io/pypi/v/random-unicode-emoji)](https://pypi.org/project/random-unicode-emoji/)\r\n[![Unicode](https://img.shields.io/badge/Unicode-15.0-success)](https://www.unicode.org/Public/emoji/15.0/)\r\n[![downloads](https://pepy.tech/badge/random-unicode-emoji)](https://pepy.tech/project/random-unicode-emoji)\r\n[![stars](https://img.shields.io/github/stars/NicPWNs/random-unicode-emoji-py)](https://github.com/NicPWNs/random-unicode-emoji-py/stargazers)\r\n[![forks](https://img.shields.io/github/forks/NicPWNs/random-unicode-emoji-py.svg)](https://github.com/NicPWNs/random-unicode-emoji-py/forks)\r\n[![repo size](https://img.shields.io/github/repo-size/NicPWNs/random-unicode-emoji-py)](https://github.com/NicPWNs/random-unicode-emoji-py)\r\n[![license](https://img.shields.io/badge/license-MIT-green.svg)](https://github.com/NicPWNs/random-unicode-emoji-py/blob/main/LICENSE.rst)\r\n[![issues](https://img.shields.io/github/issues/NicPWNs/random-unicode-emoji-py.svg)](https://github.com/NicPWNs/random-unicode-emoji-py/issues)\r\n\r\nA simple Python package that returns random Unicode emojis. \ud83d\udc0d\r\n\r\n> Like this repo? Give it a [star on GitHub!](https://github.com/NicPWNs/random-unicode-emoji-py)\r\n\r\n## Install\r\n\r\nInstall the package:\r\n\r\n```bash\r\npip install random-unicode-emoji\r\n```\r\n\r\n> No dependencies!\r\n\r\n## Usage\r\n\r\nUse the package:\r\n\r\n```py\r\n# Import the Library\r\nfrom random_unicode_emoji import random_emoji\r\n# Use the Function\r\nprint(random_emoji())\r\n# Return Specific Count\r\nprint(random_emoji(count=3))\r\n# Use Specific Version\r\nprint(random_emoji(version=\"15.0\"))\r\n# Append Custom Emoji\r\nprint(random_emoji(custom=['(\u00b0 \u035c\u0296 \u0361\u00b0)','(\u256f\u00b0\u25a1\u00b0)\u256f\ufe35 \u253b\u2501\u253b']))\r\n# All Together Now\r\nprint(random_emoji(3, 15, ['(\u00b0 \u035c\u0296 \u0361\u00b0)','(\u256f\u00b0\u25a1\u00b0)\u256f\ufe35 \u253b\u2501\u253b']))\r\n```\r\n\r\n## Upgrade\r\n\r\nUpgrade the package to the latest version:\r\n\r\n```bash\r\npip install random-unicode-emoji -U\r\n```\r\n\r\n## Unicode\r\n\r\nUses Unicode Standard Emoji from [Unicode.org](https://www.unicode.org/Public/emoji/)\r\n\r\n### Supported Unicode Versions\r\n\r\n4.0, 5.0, 11.0, 12.0, 12.1, 13.0, 13.1, 14.0, 15.0 (latest)\r\n\r\n> _Uses latest version by default._\r\n\r\n## Language\r\n\r\nThis is the Python \ud83d\udc0d version. There is also a [JavaScript \ud83d\udcdc](https://github.com/NicPWNs/random-unicode-emoji) and [Rust \u2699\ufe0f](https://github.com/NicPWNs/random-unicode-emoji-rs) version.\r\n\r\n## Maintainer\r\n\r\n[Nic Jones, (NicPWNs)](https://github.com/NicPWNs)\r\n\r\n## Credit\r\n\r\nOriginally Inspired by [randomEmoji.py](https://gist.github.com/shello/efa2655e8a7bce52f273)\r\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "A simple Python package that returns random Unicode emojis.",
"version": "2.8",
"split_keywords": [
"random",
"unicode",
"emoji",
"function"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "e95f3575346624af38c2e777dbbb98d170a95ea7399a55d3e614221dfdcb0fd6",
"md5": "f377f499836a668835b4e794fa044a42",
"sha256": "3b6d78a265eebfaa1171c0ef49a2c5a944d5f710618cae7bbddaea1cbb84bd98"
},
"downloads": -1,
"filename": "random_unicode_emoji-2.8-py3-none-any.whl",
"has_sig": false,
"md5_digest": "f377f499836a668835b4e794fa044a42",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3",
"size": 475342,
"upload_time": "2023-03-24T21:03:12",
"upload_time_iso_8601": "2023-03-24T21:03:12.294656Z",
"url": "https://files.pythonhosted.org/packages/e9/5f/3575346624af38c2e777dbbb98d170a95ea7399a55d3e614221dfdcb0fd6/random_unicode_emoji-2.8-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "de0f5cb72fe185023f2af92fe922eb3fa260d37284cb8c65fb39e590851cf5b3",
"md5": "4b0ae53f183bd22044344be321b0cba4",
"sha256": "49bb87fc0a367073c15913c45d457a04f2495662c377306ee6d93f33ee7620bd"
},
"downloads": -1,
"filename": "random_unicode_emoji-2.8.tar.gz",
"has_sig": false,
"md5_digest": "4b0ae53f183bd22044344be321b0cba4",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3",
"size": 462027,
"upload_time": "2023-03-24T21:03:14",
"upload_time_iso_8601": "2023-03-24T21:03:14.893256Z",
"url": "https://files.pythonhosted.org/packages/de/0f/5cb72fe185023f2af92fe922eb3fa260d37284cb8c65fb39e590851cf5b3/random_unicode_emoji-2.8.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-03-24 21:03:14",
"github": true,
"gitlab": false,
"bitbucket": false,
"github_user": "NicPWNs",
"github_project": "random-unicode-emoji-py",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "random-unicode-emoji"
}