Emojicode is an open source, high-level, multi-paradigm programming language consisting of emojis. It features Object-Orientation, Optionals, Generics and Closures.

The Emojicode source is undergoing some major changes. Expect things to be broken in master. Check out the 0.5 branch for stable code.

To learn more about the language and get started quickly visit Emojicode’s documentation.

You can easily install Emojicode from our stable prebuilt binaries. See Installing Emojicode for instructions.

We highly recommend to follow Emojicode’s Twitter account @Real_Emojicode to stay up with the latest.

Want to improve something? Great! First of all, please be nice and helpful.

If you want to actively help develop the next version of Emojicode, Emojicode 0.6, have a look at “The 🛣 to Emojicode 0.6”. We are looking for people like you to help us refine the syntax.

If you don’t want to use the prebuilt binaries or want to work on Emojicode, you can of course also build Emojicode from source.

Prerequisites (earlier versions might work but are not tested):

• clang and clang++ 3.9 or newer, or
• gcc and g++ 7.2 or newer (previous GCC versions are unsuitable due to a bug)
• CMake 3.5.1 or newer and (preferably) Ninja
• Python 3.5.2 or newer (for tests and packaging)
• Allegro 5 to compile the allegro package
  • sudo apt-get install liballegro5-dev on Debian/Ubuntu
  • brew install allegro on macOS

Steps:

1. Clone Emojicode (or download the source code and extract it) and navigate into it:

   git clone https://github.com/emojicode/emojicode
   cd emojicode

   If you want to build the latest stable version, check it out first. E.g. git checkout v0.5.

2. Create a build directory and run CMake in it:

   mkdir build
   cd build
   cmake .. -GNinja

   You can specify the heap size in bytes, which defaults to 512MB, with -DheapSize and the default package search path with -DdefaultPackagesDirectory.

   You can of course also run CMake in another directory or use another build system than Ninja. Refer to the CMake documentation for more information.

3. Build the Compiler and Real-Time Engine:

   ninja

4. You can now test Emojicode:

   ninja tests

5. The binaries are ready for use! You can the perform a magic installation right away

   ninja magicinstall

   or just package the binaries and headers properly

   ninja dist

   To create a distribution archive you must call the dist script yourself (e.g. python3 ../dist.py .. archive).

This repository comes with two Dockerfiles DockerfileClang and DockerfileGCC, which are used by our continuous integration service. However, you can also use them to build Emojicode.

Prerequisites:

• Docker

Steps:

1. Clone Emojicode (or download the source code and extract it) and navigate into it:

   git clone https://github.com/emojicode/emojicode
   cd emojicode

2. Build and create a container

   docker build -f DockerfileClang -t emojicode_clang .
   docker create --name emojicontainer -ti emojicode_clang bash

3. Start and enter the container:

   docker start -ai emojicontainer

4. You can now build Emojicode:

   mkdir build && cd build && cmake .. -GNinja && ninja && ninja tests

Emojicode is licensed under the Artistic License 2.0. If you don’t want to read the whole license, here’s a summary without legal force:

• You are allowed to download, use, copy, publish and distribute Emojicode.
• You are allowed to create modified versions of Emojicode but you may only distribute them on some conditions.
• The license contains a grant of patent rights and does not allow you to use any trademark, service mark, tradename, or logo.
• Emojicode comes with absolutely no warranty.