emoji

README

About emoji

emoji provides standardized ways for translating unicode code points for Emoji to/from their emoji cheat sheet encoding, and is most useful when working with third-party APIs such as Slack, GitHub, etc.

emoji was written because other emoji packages for Go only provided cheat sheet names to unicode conversion and not the inverse. Additionally, there were no comprehensive emoticon packages available at the time.

Gemoji Data

Data for this package is generated from GitHub's gemoji project:

$ cd $GOPATH/src/github.com/brankas/emoji
$ go generate

Installing

Install in the usual Go fashion:

$ go get -u github.com/brankas/emoji

Using

emoji can be used similarly to the following:

// example/example.go
package main

import (
	"log"

	"github.com/brankas/emoji"
)

func main() {
	a := emoji.FromEmoticon(":-)")
	log.Printf(":-) %+v", a)

	b := emoji.FromAlias("slightly_smiling_face")
	log.Printf(":-) %+v", b)

	s := emoji.ReplaceEmoticonsWithAliases(":-) :D >:(")
	log.Printf("s: %s", s)

	n := emoji.ReplaceEmoticonsWithCodes(":-) :D >:(")
	log.Printf("n: %s", n)
}

Please see the GoDoc listing for the complete API listing.

TODO

• Convert UnicodeVersion and IOSVersion fields of Emoji type to something more easily comparable (ie, int)

Documentation

Overview

Package emoji provides standard tools for working with emoji unicode codes and aliases.

Index

• Variables
• func ReplaceAliases(s string) string
• func ReplaceAliasesWithEmoticons(s string) string
• func ReplaceCodes(s string) string
• func ReplaceEmoticonsWithAliases(s string) string
• func ReplaceEmoticonsWithCodes(s string) string
• type Emoji
  • func FromAlias(alias string) *Emoji
  • func FromCode(code string) *Emoji
  • func FromEmoticon(emoticon string) *Emoji
• type Gemoji

Variables

var GemojiData = Gemoji{}/* 1805 elements not displayed */

GemojiData is the original Gemoji data.

see: https://raw.githubusercontent.com/github/gemoji/master/db/emoji.json

Functions

func ReplaceAliases

func ReplaceAliases(s string) string

ReplaceAliases replaces all aliases of the form ":alias:" with its corresponding unicode value.

func ReplaceAliasesWithEmoticons

func ReplaceAliasesWithEmoticons(s string) string

ReplaceAliasesWithEmoticons replaces all emoji aliases (in the form of :alias:) with its corresponding emoticon (ie, :D, :p, etc) (ie, the alias ":monkey_face:" will be replaced with ":o)").

func ReplaceCodes

func ReplaceCodes(s string) string

ReplaceCodes replaces all emoji codes with the first corresponding emoji alias (in the form of ":alias:") (ie, "\u2618" will be converted to ":shamrock:").

func ReplaceEmoticonsWithAliases

func ReplaceEmoticonsWithAliases(s string) string

ReplaceEmoticonsWithAliases replaces all emoticons (ie, :D, :p, etc) with the first corresponding emoji alias (in the form of :alias:) (ie, the monkey face emoticon ":o)" will be replaced with ":monkey_face:").

func ReplaceEmoticonsWithCodes

func ReplaceEmoticonsWithCodes(s string) string

ReplaceEmoticonsWithCodes replaces all emoticons (ie, :D, :p, etc) with the corresponding emoji code (ie, the monkey face emoticon ":o)" will be replaced with "\U0001f435").

Types

type Emoji

type Emoji struct {
	Emoji          string   `json:"emoji"`
	Description    string   `json:"description"`
	Category       string   `json:"category"`
	Aliases        []string `json:"aliases"`
	Tags           []string `json:"tags"`
	UnicodeVersion string   `json:"unicode_version"`
	IOSVersion     string   `json:"ios_version"`
}

Emoji represents a single emoji and associated data.

func FromAlias

func FromAlias(alias string) *Emoji

FromAlias retrieves the emoji data based on the provided alias in the form "alias" or ":alias:" (ie, "shamrock" or ":shamrock:" will return the Gemoji data for "shamrock").

func FromCode

func FromCode(code string) *Emoji

FromCode retrieves the emoji data based on the provided unicode code (ie, "\u2618" will return the Gemoji data for "shamrock").

func FromEmoticon

func FromEmoticon(emoticon string) *Emoji

FromEmoticon retrieves the emoji data based on the provided emoticon (ie, ":o)" will return the Gemoji data for "monkey face").

type Gemoji

type Gemoji []Emoji

Gemoji is a set of emoji data.