/enhanced-discord.py

An enhanced discord.py, based off of the now-archived discord.py project

Primary LanguagePythonMIT LicenseMIT

enhanced-discord.py

Discord server invite PyPI version info PyPI supported Python versions

A modern, maintained, easy to use, feature-rich, and async ready API wrapper for Discord written in Python.

The Future of enhanced-discord.py

Enhanced discord.py is a fork of Rapptz's discord.py, that went unmaintained (gist) An overview of added features is available on the custom features page.

Key Features

  • Modern Pythonic API using async and await.
  • Proper rate limit handling.
  • Optimised in both speed and memory.

Installing

Python 3.8 or higher is required

To install the library without full voice support, you can just run the following command:

# Linux/macOS
python3 -m pip install -U enhanced-dpy

# Windows
py -3 -m pip install -U enhanced-dpy

To install the development version, do the following:

$ git clone https://github.com/iDevision/enhanced-discord.py
$ cd enhanced-discord.py
$ python3 -m pip install -U .[voice]

Optional Packages

Please note that on Linux installing voice you must install the following packages via your favourite package manager (e.g. apt, dnf, etc) before running the above commands:

  • libffi-dev (or libffi-devel on some systems)
  • python-dev (e.g. python3.6-dev for Python 3.6)

Quick Example

import discord

class MyClient(discord.Client):
    async def on_ready(self):
        print('Logged on as', self.user)

    async def on_message(self, message):
        # don't respond to ourselves
        if message.author == self.user:
            return

        if message.content == 'ping':
            await message.channel.send('pong')

client = MyClient()
client.run('token')

Bot Example

import discord
from discord.ext import commands

bot = commands.Bot(command_prefix='>')

@bot.command()
async def ping(ctx):
    await ctx.send('pong')

bot.run('token')

You can find more examples in the examples directory.

Links