discord.py - DragDev Flavour
A modern, easy to use, feature-rich, and async ready API wrapper for Discord written in Python.
The Future of discord.py
Please read the gist for the future of this project. It's been a good one.
Key Features
- Modern Pythonic API using
async
andawait
. - Proper rate limit handling.
- Optimised in both speed and memory.
Installing
Python 3.8 or higher is required
$ git clone https://github.com/dragdev-studios/discord.py
$ cd discord.py
$ python3 -m pip install -U .[voice]
or
$ pip install git+https://github.com/dragdev-studios/discord.py
Optional Packages
- PyNaCl (for voice support)
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.