ProductPromotion
Logo

Elixir

made by https://0x3d.site

GitHub - mroth/exmoji: :sunglasses: Emoji encoding swiss army knife for Elixir/Erlang
:sunglasses: Emoji encoding swiss army knife for Elixir/Erlang - mroth/exmoji
Visit Site

GitHub - mroth/exmoji: :sunglasses: Emoji encoding swiss army knife for Elixir/Erlang

GitHub - mroth/exmoji: :sunglasses: Emoji encoding swiss army knife for Elixir/Erlang

Exmoji

Build Status Module Version Hex Docs Total Download License Last Updated

An Elixir/Erlang library providing low level operations for dealing with Emoji glyphs in the Unicode standard. :cool:

Exmoji is like a swiss-army knife for dealing with Emoji encoding issues. If all you need to do is translate :poop: into :poop:, then there are plenty of other libs out there that will probably do what you want. But once you are dealing with Emoji as a fundamental part of your application, and you start to realize the nightmare of doublebyte encoding or variants, then this library may be your new best friend. :raised_hands:

Exmoji is written by the same author as the Ruby emoji_data.rb gem, which is used in production by Emojitracker.com to parse well over 100M+ emoji glyphs daily. This version was written to provide all the same functionality while being even higher performance. :dizzy:

Installation

Add it to your deps list in your mix.exs:

defp deps do
  [
    {:exmoji, "~> 0.3.0"}
  ]
end

To get the development version, you can pull directly from GitHub:

defp deps do
  [
    {:exmoji, github: "mroth/exmoji"}
  ]
end

Modules

Full API documentation is available via standard module docs or here: https://mroth.github.io/exmoji/

Exmoji

The main library, with detailed search and conversion functions.

Some examples:

iex> Exmoji.from_unified "0023-20E3"
%Exmoji.EmojiChar{name: "HASH KEY", short_name: "hash", short_names: ["hash"],
 text: nil, unified: "0023-20E3", variations: ["0023-FE0F-20E3"]}

iex> Exmoji.all |> Enum.count
845

iex> Exmoji.all_with_variants |> Enum.count
107

iex> Exmoji.find_by_short_name("moon") |> Enum.count
13

iex> for t <- Exmoji.find_by_name("tree"), do: t.name
["EVERGREEN TREE", "DECIDUOUS TREE", "PALM TREE", "CHRISTMAS TREE",
"TANABATA TREE"]

Exmoji.EmojiChar

A struct representation of a single Emoji character and all of its associated metadata.

This module also contains some convenience methods for acting upon these structs. For example, EmojiChar.render/1 will produce a bitstring representation of an Emoji character suitable for transmission. It understands which Emoji have variant encodings and will do the right thing to make sure they are likely to display correctly on the other end.

iex> alias Exmoji.EmojiChar
nil

iex> for e <- Exmoji.all, EmojiChar.doublebyte?(e), do: e.short_name
["hash", "zero", "one", "two", "three", "four", "five", "six", "seven", "eight",
 "nine", "cn", "de", "es", "fr", "gb", "it", "jp", "kr", "ru", "us"]

iex> for m <- Exmoji.find_by_short_name("moon"), do: EmojiChar.render(m)
["🌑", "🌒", "🌓", "🌔", "🌕", "🌖", "🌗", "🌘", "🌙", "🌚", "🌛", "🌜", "🌝"]

Exmoji.Scanner

Provides very fast searches against binary strings for the presence of UTF-8 encoded Emoji glyphs. Whereas the Ruby and NodeJS versions of this library accomplish this via regular expressions, the Elixir version relies on optimized binary pattern matching, making it faster.

An example:

iex> for ec <- Exmoji.Scanner.scan("I ♥ when marketers talk about the ☁.") do
...>   IO.puts "Found some #{ec.short_name}!"
...> end
Found some hearts!
Found some cloud!
[:ok, :ok]

Contributing

Please be sure to run mix test and help keep test coverage at :100:. (Note: excoveralls is currently lying, actual test coverage is 100%, but it doesn't seem to catch dynamically defined functions. Do mix coveralls.details and manually verify those for now.)

There is a full benchmark suite available via mix bench. Please run before and after your changes to ensure you have not caused a performance regression.

Copyright and License

Copyright (c) 2014 Matthew Rothenberg

This work is free. You can redistribute it and/or modify it under the terms of the MIT License. See the LICENSE.md file for more details.

Articles
to learn more about the elixir concepts.

Resources
which are currently available to browse on.

mail [email protected] to add your project or resources here 🔥.

FAQ's
to know more about the topic.

mail [email protected] to add your project or resources here 🔥.

Queries
or most google FAQ's about Elixir.

mail [email protected] to add more queries here 🔍.

More Sites
to check out once you're finished browsing here.

0x3d
https://www.0x3d.site/
0x3d is designed for aggregating information.
NodeJS
https://nodejs.0x3d.site/
NodeJS Online Directory
Cross Platform
https://cross-platform.0x3d.site/
Cross Platform Online Directory
Open Source
https://open-source.0x3d.site/
Open Source Online Directory
Analytics
https://analytics.0x3d.site/
Analytics Online Directory
JavaScript
https://javascript.0x3d.site/
JavaScript Online Directory
GoLang
https://golang.0x3d.site/
GoLang Online Directory
Python
https://python.0x3d.site/
Python Online Directory
Swift
https://swift.0x3d.site/
Swift Online Directory
Rust
https://rust.0x3d.site/
Rust Online Directory
Scala
https://scala.0x3d.site/
Scala Online Directory
Ruby
https://ruby.0x3d.site/
Ruby Online Directory
Clojure
https://clojure.0x3d.site/
Clojure Online Directory
Elixir
https://elixir.0x3d.site/
Elixir Online Directory
Elm
https://elm.0x3d.site/
Elm Online Directory
Lua
https://lua.0x3d.site/
Lua Online Directory
C Programming
https://c-programming.0x3d.site/
C Programming Online Directory
C++ Programming
https://cpp-programming.0x3d.site/
C++ Programming Online Directory
R Programming
https://r-programming.0x3d.site/
R Programming Online Directory
Perl
https://perl.0x3d.site/
Perl Online Directory
Java
https://java.0x3d.site/
Java Online Directory
Kotlin
https://kotlin.0x3d.site/
Kotlin Online Directory
PHP
https://php.0x3d.site/
PHP Online Directory
React JS
https://react.0x3d.site/
React JS Online Directory
Angular
https://angular.0x3d.site/
Angular JS Online Directory