I like to put an emoji at the front of every commit that I 📌 on Github.

See any repo I run for proof.

I don't care what they are, I just like to do it, because the visual element is way better than any words can be. Descriptions are good to write, but not commit messages. They should just be emojis. 😤

Still, it's hard to actually :think: when I need them! 😞

This 💩 is 🙅 ❗

So I made a thing that will get you what you want, quick!

python -m moji

That will produce one random emoji from the entire list of emojis! ⛄, right?

But if you add a number after, baby, now we're cooking with 🔥

python -m moji 20

If you have moji.py saved in the user site-packages folder, this will work from anywhere.

Otherwise, you'll have to call it from the folder you've got it saved in. Open a terminal there, and just type

moji

NOTE: If you use the emoji.bat file included in this repo, and place it in a Shortcuts folder, or somewhere on the PATH, then you can even call this without python -m

But wait! There's more!

python -m moji 30 -d

The -d is a debug flag, and will help you see how many emojis were output, and from which categories. More on the categories below.

python -m moji -h

will produce some assitance for you , like so:

These are the categories I have the emojis grouped into:

NOTE: Only one of those arguments can be used at a time, or it won't give you anything at all!

You can use the optional argumen -m to supply the name of the emoji set you'd like as well:

python -m moji -m nature 30

which would give you 30 random emojis selected from the nature category!