Skip to content

a πŸ’© tool that replaces boring variable names with their fun emoji counterparts

License

Notifications You must be signed in to change notification settings

danthareja/emojify

Folders and files

NameName
Last commit message
Last commit date

Latest commit

7af9575 Β· Feb 15, 2019

History

4 Commits
Jul 12, 2015
Jul 12, 2015
Jul 12, 2015
Jul 12, 2015
Jul 12, 2015
Jul 12, 2015
Feb 15, 2019
Jul 12, 2015

Repository files navigation

Emojify

Emojify is a useless tool that replaces boring variable names with their fun emoji counterparts. πŸ’©πŸ”₯

Install

This package is no longer hosted on npm

Another developer requested the use of the package name emojify, which I happily granted because this is package is useless and will be better suited when attached to a real project. I've decided not to republish it under a new name.

If you still to want to install it for some reason, you can do so by installing directly from this repository.

For command line use:

npm install -g danthareja/emojify

For programmatic use:

npm install danthareja/emojify

Usage

Emojify is a drop-in replacement for UglifyJS2 with one major difference - it minifies your variables by default and replaces them with hilarious emojis.

From the command line, run:

emojify input1.js [input2.js ...] [options]

Anything you can do with UglifyJS2 you can do with Emojify, with a few notable exceptions:

  • --mangle and --beautify are turned on by default
  • You can minify your code a little with --compress (-c) or a lot with --uglify (-u)

Examples

Let's run @mathias's String.fromCodePoint polyfill through some emojification

Our source file: String-fromCodePoint.js

/*! https://mths.be/fromcodepoint v0.2.1 by @mathias */
if (!String.fromCodePoint) {
  (function() {
    var defineProperty = (function() {
      // IE 8 only supports `Object.defineProperty` on DOM elements
      try {
        var object = {};
        var $defineProperty = Object.defineProperty;
        var result = $defineProperty(object, object, object) && $defineProperty;
      } catch(error) {}
      return result;
    }());
    var stringFromCharCode = String.fromCharCode;
    var floor = Math.floor;
    var fromCodePoint = function(_) {
      var MAX_SIZE = 0x4000;
      var codeUnits = [];
      var highSurrogate;
      var lowSurrogate;
      var index = -1;
      var length = arguments.length;
      if (!length) {
        return '';
      }
      var result = '';
      while (++index < length) {
        var codePoint = Number(arguments[index]);
        if (
          !isFinite(codePoint) || // `NaN`, `+Infinity`, or `-Infinity`
          codePoint < 0 || // not a valid Unicode code point
          codePoint > 0x10FFFF || // not a valid Unicode code point
          floor(codePoint) != codePoint // not an integer
        ) {
          throw RangeError('Invalid code point: ' + codePoint);
        }
        if (codePoint <= 0xFFFF) { // BMP code point
          codeUnits.push(codePoint);
        } else { // Astral code point; split in surrogate halves
          // https://mathiasbynens.be/notes/javascript-encoding#surrogate-formulae
          codePoint -= 0x10000;
          highSurrogate = (codePoint >> 10) + 0xD800;
          lowSurrogate = (codePoint % 0x400) + 0xDC00;
          codeUnits.push(highSurrogate, lowSurrogate);
        }
        if (index + 1 == length || codeUnits.length > MAX_SIZE) {
          result += stringFromCharCode.apply(null, codeUnits);
          codeUnits.length = 0;
        }
      }
      return result;
    };
    if (defineProperty) {
      defineProperty(String, 'fromCodePoint', {
        'value': fromCodePoint,
        'configurable': true,
        'writable': true
      });
    } else {
      String.fromCodePoint = fromCodePoint;
    }
  }());
}

Default behavior

Running emojify /path/to/String-fromCodePoint.js outputs:

if (!String.fromCodePoint) {
    (function() {
        var πŸš€ = function() {
            try {
                var πŸš€ = {};
                var πŸ’© = Object.defineProperty;
                var πŸ”₯ = πŸ’©(πŸš€, πŸš€, πŸš€) && πŸ’©;
            } catch (πŸ•) {}
            return πŸ”₯;
        }();
        var πŸ’© = String.fromCharCode;
        var πŸ”₯ = Math.floor;
        var πŸ• = function(πŸš€) {
            var πŸ• = 16384;
            var πŸ” = [];
            var 🍟;
            var 🍺;
            var 🍻 = -1;
            var πŸ’ = arguments.length;
            if (!πŸ’) {
                return "";
            }
            var 🐢 = "";
            while (++🍻 < πŸ’) {
                var 🐱 = Number(arguments[🍻]);
                if (!isFinite(🐱) || 🐱 < 0 || 🐱 > 1114111 || πŸ”₯(🐱) != 🐱) {
                    throw RangeError("Invalid code point: " + 🐱);
                }
                if (🐱 <= 65535) {
                    πŸ”.push(🐱);
                } else {
                    🐱 -= 65536;
                    🍟 = (🐱 >> 10) + 55296;
                    🍺 = 🐱 % 1024 + 56320;
                    πŸ”.push(🍟, 🍺);
                }
                if (🍻 + 1 == πŸ’ || πŸ”.length > πŸ•) {
                    🐢 += πŸ’©.apply(null, πŸ”);
                    πŸ”.length = 0;
                }
            }
            return 🐢;
        };
        if (πŸš€) {
            πŸš€(String, "fromCodePoint", {
                value: πŸ•,
                configurable: true,
                writable: true
            });
        } else {
            String.fromCodePoint = πŸ•;
        }
    })();
}

More minification

Running emojify /path/to/String-fromCodePoint.js -o /path/to/String-fromCodePoint.min.js -u outputs:

if(!String.fromCodePoint){(function(){varπŸš€=function(){try{varπŸš€={};varπŸ’©=Object.defineProperty;varπŸ”₯=πŸ’©(πŸš€,πŸš€,πŸš€)&&πŸ’©}catch(πŸ•){}returnπŸ”₯}();varπŸ’©=String.fromCharCode;varπŸ”₯=Math.floor;varπŸ•=function(πŸš€){varπŸ•=16384;varπŸ”=[];var🍟;var🍺;var🍻=-1;varπŸ’=arguments.length;if(!πŸ’){return""}var🐢="";while(++🍻<πŸ’){var🐱=Number(arguments[🍻]);if(!isFinite(🐱)||🐱<0||🐱>1114111||πŸ”₯(🐱)!=🐱){throw RangeError("Invalid code point: "+🐱)}if(🐱<=65535){πŸ”.push(🐱)}else{🐱-=65536;🍟=(🐱>>10)+55296;🍺=🐱%1024+56320;πŸ”.push(🍟,🍺)}if(🍻+1==πŸ’||πŸ”.length>πŸ•){🐢+=πŸ’©.apply(null,πŸ”);πŸ”.length=0}}return🐢};if(πŸš€){πŸš€(String,"fromCodePoint",{value:πŸ•,configurable:true,writable:true})}else{String.fromCodePoint=πŸ•}})()}

to a new file located at /path/to/String-fromCodePoint.min.js

Less minification but more emojis

You can go even harder by passing in --mangle-props. This not only replaces top-level variable names but also hunts down properties on objects.

Running emojify /path/to/String-fromCodePoint.js --compress --mangle-props outputs:

String.πŸš€ || !function() {
    var πŸš€ = function() {
        try {
            var πŸš€ = {}, πŸ’© = Object.defineProperty, πŸ”₯ = πŸ’©(πŸš€, πŸš€, πŸš€) && πŸ’©;
        } catch (πŸ•) {}
        return πŸ”₯;
    }(), πŸ’© = String.fromCharCode, πŸ”₯ = Math.floor, πŸ• = function(πŸš€) {
        var πŸ•, πŸ”, 🍟 = 16384, 🍺 = [], 🍻 = -1, πŸ’ = arguments.length;
        if (!πŸ’) return "";
        for (var 🐢 = ""; ++🍻 < πŸ’; ) {
            var 🐱 = Number(arguments[🍻]);
            if (!isFinite(🐱) || 0 > 🐱 || 🐱 > 1114111 || πŸ”₯(🐱) != 🐱) throw RangeError("Invalid code point: " + 🐱);
            65535 >= 🐱 ? 🍺.push(🐱) : (🐱 -= 65536, πŸ• = (🐱 >> 10) + 55296, πŸ” = 🐱 % 1024 + 56320, 
            🍺.push(πŸ•, πŸ”)), (🍻 + 1 == πŸ’ || 🍺.length > 🍟) && (🐢 += πŸ’©.apply(null, 🍺), 
            🍺.length = 0);
        }
        return 🐢;
    };
    πŸš€ ? πŸš€(String, "fromCodePoint", {
        "πŸ’©": πŸ•,
        "πŸ”₯": !0,
        "πŸ•": !0
    }) : String.πŸš€ = πŸ•;
}();

More usage

Read up on the rest of the commands here

API Reference

Assuming installation via NPM, you can load Emojify in your application like this:

var Emojify = require("emojify");

There's a single top-level function which combines all the steps. If you don't need additional customization, you might want to go with minify. Example:

var result = Emojify.minify("/path/to/file.js");
console.log(result.code); // minified output
// if you need to pass code instead of file name
var result = Emojify.minify("var b = function () {};", {fromString: true});

You can also compress multiple files:

var result = Emojify.minify([ "file1.js", "file2.js", "file3.js" ]);
console.log(result.code);

Read up on the rest of the programmatic API here

FAQs

Can I run Emojified code?

Nope 😒

While ES6 brings stronger Unicode support to our beloved language, not all symbols can be used as valid identifiers. We can use things like var ΰ² _ΰ²  = 42, but not var πŸ’© = 43.

@mathias has a great post explaining the details of valid identifiers in ES6

So what's the point?

Maybe one day ESXX will support emoji identifiers. Until then it's just for the lulz πŸ˜‚

I want my own emojis, the ones you picked suck

You can do that:+1:

I've exposed the array of characters that Emojify uses to replace your variable names. Simply edit the array in lib/manglers.js with your emojis of choice.

You can include any number of emojis in this array, but I recommend at least 40 different entires for enough combinations to cover a decent sized file. Here's a good site to copy emojis from.

You could grab some of the (more boring) supported characters and produce actualy working code!

Acknowledgements

This project would not exist without UglifyJS. Also, @mathiasbynens is a Unicode beast. I learned so much from his wonderful resources.

About

a πŸ’© tool that replaces boring variable names with their fun emoji counterparts

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published