jishaku

jishaku is an extension for bot developers that enables rapid prototyping, experimentation, and debugging of features for bots.

One of jishaku's core philosophies is to be dynamic and easy-to-use. Here's the two step install:

1. Download jishaku on the command line using pip:

pip install -U jishaku

2. Load the extension in your bot code before it runs:

bot.load_extension('jishaku')
# or
await bot.load_extension('jishaku')

That's it!

You can also import the module to use the command development utilities.

Index

• Command reference
• Installing development versions
• Acknowledgements

Command reference

Installing development versions

If you'd like to test the latest versions of jishaku, you can do so by downloading from the git hosts instead of from PyPI.

From GitHub:

pip install -U "jishaku @ git+https://github.com/Gorialis/jishaku@master"

From GitLab:

pip install -U "jishaku @ git+https://gitlab.com/Gorialis/jishaku@master"

Please note that the new 2020 dependency resolver now no longer discounts git package sources from reinstall prevention, which means that if you are installing the jishaku development version multiple times within the same version target you may run into pip just discarding the update.

If you run into such a problem, you can force jishaku to be reinstalled like this:

From GitHub:

pip install -U --force-reinstall "jishaku @ git+https://github.com/Gorialis/jishaku@master"

From GitLab:

pip install -U --force-reinstall "jishaku @ git+https://gitlab.com/Gorialis/jishaku@master"

You must have installed jishaku with one of the commands above before doing this else you will probably end up with a broken installation.

Acknowledgements

The documentation and this README uses icons from the Material Design Icon library, which is licensed under the Apache License Version 2.0.