disco
Disco is an extensive and extendable Python 2.x/3.x library for the Discord API. Disco boasts the following major features:
- Expressive, functional interface that gets out of the way
- Built for high-performance and efficiency
- Configurable and modular, take the bits you need
- Full support for Python 2.x/3.x
- Evented networking and IO using Gevent
Installation
Disco was built to run both as a generic-use library, and a standalone bot toolkit. Installing disco is as easy as running pip install disco-py, however some extra packages are recommended for power-users, namely:
| Name | Reason |
|---|---|
| requests[security] | adds packages for a proper SSL implementation |
| ujson | faster json parser, improves performance |
| erlpack (2.x), earl-etf (3.x) | ETF parser run with the --encoder=etf flag |
| gipc | Gevent IPC, required for autosharding |
Examples
Simple bot using the builtin bot authoring tools:
from disco.bot import Bot, Plugin
class SimplePlugin(Plugin):
# Plugins provide an easy interface for listening to Discord events
@Plugin.listen('ChannelCreate')
def on_channel_create(self, event):
event.channel.send_message('Woah, a new channel huh!')
# They also provide an easy-to-use command component
@Plugin.command('ping')
def on_ping_command(self, event):
event.msg.reply('Pong!')
# Which includes command argument parsing
@Plugin.command('echo', '
'
)
def on_echo_command(self, event, content):
event.msg.reply(content)
Using the default bot configuration, we can now run this script like so:
python -m disco.cli --token="MY_DISCORD_TOKEN" --run-bot --plugin simpleplugin
And commands can be triggered by mentioning the bot (configured by the BotConfig.command_require_mention flag):
1 Jan 16, 2022
7 Nov 3, 2022
5 Apr 19, 2022
2 Mar 8, 2022
2.9k Jan 2, 2023
4 Aug 30, 2022
28 Oct 10, 2022
1 Oct 31, 2021
8 Oct 2, 2022
594 Dec 29, 2022
6.2k Dec 30, 2022
1 Oct 23, 2021
4 Feb 19, 2022
41 Dec 12, 2022
1 Dec 02, 2021
8 Aug 04, 2022
1.1k Jan 02, 2023
2 Sep 14, 2021
106 Dec 13, 2022
1 May 22, 2022
1 Dec 03, 2021
1 Nov 11, 2021
2 Dec 08, 2022
2 Nov 01, 2021
57 Dec 12, 2022
1 Mar 01, 2022
3 Dec 20, 2022
0 Mar 30, 2022
27 Nov 01, 2022