Skip to main content

A Python wrapper for the Discord API

Project description

PyPI version info PyPI supported Python versions

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

Fork Changes

This has been moved to the website.

Credits:
- arandomnewaccount for Discord API help.
Note:
Automating user accounts is against the Discord ToS. This library is a proof of concept and I do not recommend using it. Do so at your own risk.

Key Features

  • Modern Pythonic API using async and await.

  • Proper rate limit handling.

  • Optimised in both speed and memory.

  • Mostly compatible with the official discord.py.

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 discord.py-self

# Windows
py -3 -m pip install -U discord.py-self

Otherwise to get voice support you should run the following command:

# Linux/macOS
python3 -m pip install -U "discord.py-self[voice]"

# Windows
py -3 -m pip install -U discord.py-self[voice]

To install the development version, do the following (not recommended):

$ git clone --single-branch --branch development https://github.com/dolfies/discord.py-self
$ cd discord.py-self
$ python3 -m pip install -U .[voice]

The master branch (version 2.0) is not ready for use in any way. Do not use.

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='>', self_bot=True)

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

bot.run('token')

You can find more examples in the examples directory.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

discord.py-self-1.9.2.tar.gz (733.0 kB view details)

Uploaded Source

Built Distribution

discord.py_self-1.9.2-py3-none-any.whl (788.3 kB view details)

Uploaded Python 3

File details

Details for the file discord.py-self-1.9.2.tar.gz.

File metadata

  • Download URL: discord.py-self-1.9.2.tar.gz
  • Upload date:
  • Size: 733.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.8.0 pkginfo/1.8.2 readme-renderer/32.0 requests/2.27.1 requests-toolbelt/0.9.1 urllib3/1.26.8 tqdm/4.63.0 importlib-metadata/4.11.2 keyring/23.5.0 rfc3986/2.0.0 colorama/0.4.4 CPython/3.10.2

File hashes

Hashes for discord.py-self-1.9.2.tar.gz
Algorithm Hash digest
SHA256 fce2e076825d58fed4ffecb2997593f4e558143340d5e7ebd0d199f11269d5b6
MD5 62e37ba16ce53b915f2bb6a7b5a50606
BLAKE2b-256 3704d512fc4b0ff729fc1da2d5cb43724fb71cd3535543233b6c81d18dd9cbb1

See more details on using hashes here.

Provenance

File details

Details for the file discord.py_self-1.9.2-py3-none-any.whl.

File metadata

  • Download URL: discord.py_self-1.9.2-py3-none-any.whl
  • Upload date:
  • Size: 788.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.8.0 pkginfo/1.8.2 readme-renderer/32.0 requests/2.27.1 requests-toolbelt/0.9.1 urllib3/1.26.8 tqdm/4.63.0 importlib-metadata/4.11.2 keyring/23.5.0 rfc3986/2.0.0 colorama/0.4.4 CPython/3.10.2

File hashes

Hashes for discord.py_self-1.9.2-py3-none-any.whl
Algorithm Hash digest
SHA256 94ac28d39f9c8f4e4af6bf2a2697cdfa09d8087a9f86e432b21a0c596042897a
MD5 76e053866d1b9ab6f1b0f86cc15336e3
BLAKE2b-256 78571adfa9e0e32a6dbcda39c93da841efa0de6596f3602cb0fb784921e8c4b1

See more details on using hashes here.

Provenance

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page