A discord.py extension including useful tools for bot development and debugging.
a debugging and utility extension for discord.py bots
Read the documentation online.
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:
- Download jishaku on the command line using pip:pip install -U jishaku
- Load the extension in your bot code before it runs:bot.load_extension('jishaku')
You can also import the module to use the command development utilities.
||The Context that invoked the command.|
||The running Bot instance.|
Shortcuts for attributes on
The underscore prefix on the provided variables is intended to help prevent shadowing when writing large blocks of code within the command.
If you decide that you don't want the prefix, you can disable it by setting the
JISHAKU_NO_UNDERSCOREenvironment variable to
Each Python command is individually scoped. That means variables you create won't be retained in later invocations.
You can use
jishaku retain onto change this behavior and retain variables, and
jishaku retain offif you change your mind later.
This command compiles Python code in an asynchronous context, and then disassembles the resulting function into Python bytecode in the style of
jishaku [dis|disassemble] <argument>
This allows you to quickly and easily determine the bytecode that results from a given expression or piece of code. The code itself is not actually executed.
The shell command executes commands within your system shell.
This command reads a file from your file system, automatically detecting encoding and (if applicable) highlighting.
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.
Release history Release notifications | RSS feed
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
|Filename, size||File type||Python version||Upload date||Hashes|
|Filename, size jishaku-2.0.0-py3.8.egg (116.5 kB)||File type Egg||Python version 2.0.0||Upload date||Hashes View|
|Filename, size jishaku-2.0.0-py3.9.egg (115.8 kB)||File type Egg||Python version 2.0.0||Upload date||Hashes View|
|Filename, size jishaku-2.0.0-py3-none-any.whl (53.3 kB)||File type Wheel||Python version py3||Upload date||Hashes View|
|Filename, size jishaku-2.0.0.tar.gz (45.5 kB)||File type Source||Python version None||Upload date||Hashes View|