BetterDisco

BetterDisco is an up-to-date modernized fork of Disco, a library witten by b1nzy, the creator of Discord's API, iirc. Disco is a library, written in Python 3 to interface with Discord's API as efficiently and effectively as possible. Disco is expressive, and contains a functional interface. Disco is built for performance and efficiency. Disco is scalable and works well in large and small deployments. Disco is configurable and modular. Disco contains evented network and IO pipes, courtesy of gevent. Buzzwords 100. WYSIWYG.

Installation

Disco is designed to run both as a generic-use library, and as a standalone bot toolkit. Installing disco is as easy as running pip install betterdisco-py --upgrade --no-cache-dir, however, additional options are available for extended features, performance, and support:

Examples

Simple bot using the built-in bot authoring tools:

from disco.bot import 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.reply('Pong!')

    # Which includes command argument parsing
    @Plugin.command('echo', '<content:str...>')
    def on_echo_command(self, event, content):
        event.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):

For further information and configuration options, please refer to our documentation first and foremost.