A sophisticated crate that provides the assets from Twemoji.
To use this crate, simply include it in your Cargo.toml file and enable the desired features:
toml
[dependencies]
twemoji-assets = { version = "1.0", features = ["svg", "png", "names"] }
This crate provides a convenient way to access the emoji assets from Twemoji in
your Rust programs.
You can use the provided from_emoji and from_name methods to select the
correct asset at runtime, or use macros to select the right emoji assets at
compile time.
Here's a simple example that shows how to use this crate to retrieve the SVG and PNG assets for the 🦆 (duck) emoji:
```rust use twemoji_assets::svg::SvgTwemojiAsset;
fn main() { let svgasset: &SvgTwemojiAsset = SvgTwemojiAsset::fromemoji("🦆").unwrap(); let svgdata: &str = &svgasset; println!("SVG data for 🦆: {:?}", svg_data);
#[cfg(feature = "png")]
{
use twemoji_assets::png::PngTwemojiAsset;
let png_asset: &PngTwemojiAsset = PngTwemojiAsset::from_emoji("🦆").unwrap();
let png_data: &[u8] = &png_asset;
println!("PNG data for 🦆: {:?}", png_data);
}
} ```
Note: To use the png module, you need to enable the png feature flag in
your Cargo.toml file.
This crate does not provide any direct methods for utilizing the Twemoji assets. The following additional crates may be necessary to take full advantage of these emoji graphics:
image - A crate that allows for image
manipulation of PNGs, which could be used in combination with the png
feature of twemoji-assets.
resvg - A crate that provides SVG rendering,
which could be used in combination with the svg feature of twemoji-assets.
unicode-segmentation - A crate that provides a way to split a word into its Unicode graphemes, making it useful to determine when to render an emoji.
emoji - A crate that provides a way to use emojis in Rust, including Twemoji assets. It allows for emoji lookup by name or codepoint, and includes a wide variety of emoji sources beyond just Twemoji. It can be used in conjunction with twemoji-assets to convert emojis to Twemoji assets.
The features that you include in your Cargo.toml will affect which assets are
available to your program.
The following features are available:
svg (enabled by default): includes the svg module, which provides
SVG-format emoji assets.
png: includes the png module, which provides PNG-format emoji assets.
names (enabled by default): includes the names module, which provides
mappings between human-readable names for emoji and their Unicode
representations.
As the documentation for this crate includes all features, it is recommended that you generate the docs for your project
yourself.
To generate the documentation, run the following command:
sh
cargo doc
This will generate documentation for only the features that you have enabled,
reducing clutter in the generated documentation.
This crate follows the semantic versioning scheme as required by the
Rust documentation.
The version number is represented as x.y.z+a.b.c, where x.y.z is the version
of the crate and a.b.c is the version of the integrated Twemoji assets.
The + symbol is used to separate the two version numbers.
The version of the crate may increase without a corresponding increase in the
version of the integrated Twemoji assets, however, whenever the Twemoji assets
are updated and new assets are added, the crate version will at least increase
in the minor value (y).
Twemoji Homepage - The official homepage for Twemoji, which includes detailed information on the project as well as instructions on how to include Twemoji assets in your project.
Emojibase Homepage - A comprehensive emoji
database that includes information on emoji character codes, names, and
descriptions.
This crate includes a subset of Emojibase as the names module, but the full
database may be useful for advanced emoji manipulation.
Twemoji, the project that this crate sources its assets from, has moved to a new home on GitHub, maintained by its original creators. The original version of Twemoji was maintained by two Twitter employees, @sofodesign and @jdecked. With the recent changes at Twitter, including the acquisition by Elon Musk, they no longer work there and do not have commit permissions to the original repository. There has been no indication from Twitter about whether they intend to keep maintaining the original Twemoji. Given that the original maintenance was done in the creators' free time, it seems highly unlikely that its maintenance is a priority for anyone currently at Twitter.
To prevent Twemoji from becoming abandoned, the original developers have forked the original repository and plan to continue working on it, releasing new Unicode-approved emoji, maintaining the code, etc., despite no longer being employed by Twitter. They have committed to keeping this essential project alive and accessible to the developer community (source).
Af of now this crate sources its assets from this new fork of Twemoji, as the future updates and maintenance of the original Twitter repository are uncertain.
The codebase and names provided by Emojibase for this crate are licensed under the MIT License and the included graphics are licensed by Twitter (Copyright 2020 Twitter, Inc and other contributors) under the Creative Commons Attribution 4.0 International (CC-BY 4.0) license. Proper attribution must be given to Twitter and other contributors if these graphics are used or modified.
Another crate with similar goals to this crate is twemoji-rs. Like twemoji-assets, it provides assets from Twemoji and makes them easily available in Rust. However, instead of directly including the assets, twemoji-rs finds the paths for the particular graphic on the machine where the code compiles.
Pros of twemoji-rs include:
Cons of twemoji-rs include:
Overall, the choice of whether to use twemoji-assets or twemoji-rs will depend on your specific use case and needs.