mmemoji 0.1.0

Custom Emoji manager command-line for Mattermost 😎

mmemoji

Custom Emoji manager command-line for Mattermost 😎

Features:

• Create custom Emojis
• Delete custom Emojis

Coming soon:

• List custom Emojis
• Search custom Emojis
• Export custom Emojis

Installation

pip install mmemoji
mmemoji --help

(Requires Python >=3.4)

Usage example

Let's take the Party Parrot Emojis as an example.

• First, clone the Git repository or retrieve an archive of it:

git clone https://github.com/jmhobbs/cultofthepartyparrot.com.git
cd cultofthepartyparrot.com

• Then you'll need your Mattermost credentials. You can either pass them to mmemoji with the arguments --url/--login-id/--password or via environment variables, for example:

export MM_URL='http://127.0.0.1:8065/api/v4'
export MM_LOGIN_ID='[e-mail]'
export MM_PASSWORD='user-1'

• Finally, run mmemoji to import all the parrots:

mmemoji create --no-clobber {parrots,guests}/hd/*.gif {parrots,guests}/*.gif

Notes:

• Here we rely on shell globbing to select all Emoji from the directories.
• Specifying the hd directories first with --no-clobber ensures these Emojis are created first and not overwritten by their lower quality counterpart.

Development

• You can clone this repository and install the project in editable mode:

pip install -e .

• You'll find a script to create a local Docker test instance under tests/:

./tests/scripts/setup.sh

• You can run the test suite with:

python setup.py test

• And last thing, you can install the pre-commit hooks to help with the formatting of your code.

pre-commit install