Skip to content

AdrieanKhisbe/emojizer

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

49 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

emojizer

Npm version Tag Version Build Status codecov License: MIT

Turn your :emoji_codes: into thier emoji character πŸ˜‰

About

emojizer is a program filter that turn github emoji codes into associated character.

Wanna try before install? just npx emojizer "Try me :wave:", and if you want to install an standard global install will do it: npm install -g emojizer

CLI

As a pipe, just place it between your program, and your eventual pager. You can use either emojizer or its alias emojize.

echo "Something with emojies :upside_down_face:" | emojizer
# πŸ“Ί Something with emojies πŸ™ƒ

echo "Insert before your pager :pager:" | emojizer | less

You can also provide input as argument, either as text, either as file using the -f/--file flag

emojizer "Some string" "with or without" "emojies :slightly_smiling_face:"
# πŸ“Ί Some string
#    with or without
#    emojies πŸ™‚
emojizer -f README.md CHANGELOG.md
# πŸ“Ί ...README then CHANGELOG with emoji code replaces

Using zsh, you can for instance define a global alias that combine emojizer and less or any other pager you use.

alias -g eless="emojizer|less"
# then just
git log --oneline --color | eless

Note that used with git log you might have to force color output, with --color flag for instance.

Detailed help

Just provide the -h or --help flag and you'll have the help displayed:

Replace your emoji codes with "real" emojies πŸ˜‰

Usage:
    cat something | emojizer
    emojizer "text with :slightly_smiling_face:" ":wink:"
    emojizer -f README.md


Options:
      --version  Show version number                                   [boolean]
  -f, --file     Treat args as file to read from      [boolean] [default: false]
  -h, --help     Show help                                             [boolean]

API

Internal replacing logic is exposed and so functionality can be reuse.

Provided API is so far limited, but it expose:

  • a function to replace emoji code with corresponding emoji caracter: replaceEmojiCodes
  • a function to create a Transform stream: getEmojizerStream
  • the emojiIndex used internaly and provided by the gemoji library (emoji/name-to-emoji.json)
const {replaceEmojiCodes} = require('emojizer');

console.log(replaceEmojiCodes('some text with :symbols:'));

// for getEmojizerStream, see the source or the tests πŸ“ƒ

Miscaleanous

Original release was made under the name emojiless with catchphrase

Less is more with emojies πŸ˜‰

Named was changed as less was misleading, program not being a pager.