Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/nicpwns/random-unicode-emoji-rs

A simple Rust crate that returns random Unicode emojis. ⚙️
https://github.com/nicpwns/random-unicode-emoji-rs

cargo crate crates crates-io emoji random rust rust-lang rust-library unicode

Last synced: 6 days ago
JSON representation

A simple Rust crate that returns random Unicode emojis. ⚙️

Awesome Lists containing this project

README

        

# random-unicode-emoji

[![crates](https://img.shields.io/crates/v/random-unicode-emoji)](https://crates.io/crates/random-unicode-emoji)
[![Unicode](https://img.shields.io/badge/Unicode-15.0-success)](https://www.unicode.org/Public/emoji/15.0/)
[![downloads](https://img.shields.io/crates/d/random-unicode-emoji)](https://crates.io/crates/random-unicode-emoji)
[![stars](https://img.shields.io/github/stars/NicPWNs/random-unicode-emoji-rs)](https://github.com/NicPWNs/random-unicode-emoji-rs/stargazers)
[![forks](https://img.shields.io/github/forks/NicPWNs/random-unicode-emoji-rs)](https://github.com/NicPWNs/random-unicode-emoji-rs/forks)
[![repo size](https://img.shields.io/github/repo-size/NicPWNs/random-unicode-emoji-rs)](https://github.com/NicPWNs/random-unicode-emoji-rs)

A simple Rust crate that returns random Unicode emojis. ⚙️

> Like this repo? Give it a [⭐ on GitHub!](https://github.com/NicPWNs/random-unicode-emoji-rs)

## Install

Install the crate:

```bash
cargo add random-unicode-emoji
```

## Usage

Use the crate function:

```rust
// Use the Library
use random_unicode_emoji::random_emoji;

// Use the Function
println!("{}", random_emoji(1, "latest")[0]);
--> 🍭

// Change the Count
println!("{:?}", random_emoji(3, "latest"));
--> ["🏠", "🥑", "👠"]

// Change the Version
println!("{}", random_emoji(1, "15.0")[0]);
--> 🐒
```

### Parameters

- `count`: `usize` (Integer) - Count of emojis to return.
- `version`: `&str` (String) - Version of Unicode to use.

### Return Type

- `Vec` (Vector of Strings)

## Update

Update the crate to the latest version:

```bash
cargo update -p random-unicode-emoji
```

## 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 Rust ⚙️ version. There is also a [JavaScript 📜](https://github.com/NicPWNs/random-unicode-emoji) and [Python 🐍](https://github.com/NicPWNs/random-unicode-emoji-py) version.

## Maintainer

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