Onami
a debugging and utility extension for nextcord bots
Read the documentation online.
Fork
Onami is a actively maintained fork of Jishaku for nextcord
onami is an extension for bot developers that enables rapid prototyping, experimentation, and debugging of features for bots.
One of onami's core philosophies is to be dynamic and easy-to-use. Here's the two step install:
- Download onami on the command line using pip:
pip install -U onami
- Load the extension in your bot code before it runs:
bot.load_extension('onami')That's it!
You can also import the module to use the command development utilities.
Index
Command reference
 |
> |
_ctx |
The Context that invoked the command. |
_bot |
The running Bot instance. |
_author_channel_guild_message_msg |
Shortcuts for attributes on _ctx. |
_find_get |
Shortcuts for nextcord.utils functions. |
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
onami_NO_UNDERSCORE environment variable to true. Each Python command is individually scoped. That means variables you create won't be retained in later invocations.
You can use
onami retain on to change this behavior and retain variables, and onami retain off if you change your mind later. > onami [dis|disassemble]
This command compiles Python code in an asynchronous context, and then disassembles the resulting function into Python bytecode in the style of dis.dis. 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 onami, you can do so by downloading from the git hosts instead of from PyPI.
From GitHub:
pip install -U "onami @ git+https://github.com/VincentRPS/[email protected]"
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 onami 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 onami to be reinstalled like this:
From GitHub:
pip install -U --force-reinstall "onami @ git+https://github.com/VincentRPS/[email protected]"
You must have installed onami 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.
6 Nov 18, 2022
1 Feb 18, 2022
16 Nov 01, 2022
39 Oct 30, 2022
15 Jun 17, 2022
3 Jan 08, 2022
23 Dec 14, 2022
47 Dec 19, 2022
4 Feb 28, 2022
1 Oct 25, 2021
226 Jan 02, 2023
1 Dec 23, 2021
33 Nov 12, 2022
4 Sep 02, 2022
11 Nov 05, 2022
2.6k Dec 27, 2022
84 Nov 17, 2022
0 Sep 20, 2022
97 Dec 21, 2022
4 Aug 18, 2022