Skip to main content

A wrapper for the Discord API that doesn't require you to use asyncio

Project description

Discordbot

This package provides an interface to the RESTful and websocket Discord API so users don't have to worry about rate limits, asyncio, or error handling.

It's as simple as:

import discordbot as discord

bot = discord.Bot("my_api_token")

def on_message(raw_event, message):
	print(message.author, "sent a message in", message.channel, "which said", message.content)
	
	if message.content == "!ping":
		bot.send_message(message.channel, "Pong!")
bot.on_event(discord.event.guild_message_sent, on_message)

bot.run()

discordbot also provides a simple way to add commands to your bot

import discordbot as discord

bot = discord.Bot("my_api_token")

role_moderator = '00000000000000' # the id of the role which is required to use the kick command

def cmd_kick(message, member, reason):
    bot.kick(message.guild, member, reason)
    bot.send_message(message.channel, "Member %s kicked. They are allowed to re-join. Ban them if you do not want this behavior." % member, reply_to = message, reply_ping = False)
bot.register_command("kick", "Temporarily remove someone from the server", cmd_kick, required_role = role_moderator, args = [
    {
        "name": "member",
        "description": "The member to kick",
        "type": "user"
    },
    {
        "name": "reason",
        "description": "Reason for kick",
        "type": "string",
        "default": None
    }
])

bot.command_prefix = "!"

bot.register_default_commands() # (optional) adds !cmds and !ping

bot.run()

for more examples, please see this project on github

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

discordbot-sync-1.0.0.tar.gz (17.4 kB view details)

Uploaded Source

Built Distribution

discordbot_sync-1.0.0-py3-none-any.whl (17.4 kB view details)

Uploaded Python 3

File details

Details for the file discordbot-sync-1.0.0.tar.gz.

File metadata

  • Download URL: discordbot-sync-1.0.0.tar.gz
  • Upload date:
  • Size: 17.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.2 importlib_metadata/4.6.4 pkginfo/1.7.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.1 CPython/3.9.6

File hashes

Hashes for discordbot-sync-1.0.0.tar.gz
Algorithm Hash digest
SHA256 5906a93ebd2fd912641ed8e0945bc6c8d5d1cc767fa5b2971c7fa9385e85a3df
MD5 c79fcb4410aea7404684d220ed7e2413
BLAKE2b-256 55286421e7a69f59c74436c75384a02ea710575a150c6ccee02d8b3fa9287c88

See more details on using hashes here.

File details

Details for the file discordbot_sync-1.0.0-py3-none-any.whl.

File metadata

  • Download URL: discordbot_sync-1.0.0-py3-none-any.whl
  • Upload date:
  • Size: 17.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.2 importlib_metadata/4.6.4 pkginfo/1.7.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.1 CPython/3.9.6

File hashes

Hashes for discordbot_sync-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 aba9f313731259d14162f3434234f5d91952289a8a5d0a07adfb9a3e67b1ddb6
MD5 3e44e2f75f3d26a47e707220b362b064
BLAKE2b-256 fde8daf4c18a875edb5e4b6d04e8058117bc9e9d35cbc90085d53732fd700f5e

See more details on using hashes here.

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