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.1.1.tar.gz (28.0 kB view details)

Uploaded Source

Built Distribution

discordbot_sync-1.1.1-py3-none-any.whl (29.8 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: discordbot-sync-1.1.1.tar.gz
  • Upload date:
  • Size: 28.0 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.1.1.tar.gz
Algorithm Hash digest
SHA256 8a62130e0fe812e575faba128dd5bc26c7e9d318c1d4e834c41fa6e1fb501b63
MD5 b9c89ecbd33b70a6693a4cffd3923f5d
BLAKE2b-256 a24b5308520ea849747d0101a949c1269e581a6676003ccc7412f4385cb6e6d1

See more details on using hashes here.

File details

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

File metadata

  • Download URL: discordbot_sync-1.1.1-py3-none-any.whl
  • Upload date:
  • Size: 29.8 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.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 513b7dc77060afe88cef5df127491945b8bf44fffe7947afa11310a7424f8e72
MD5 d92e544ad40bf9f183ca09c67c4ba588
BLAKE2b-256 9749fba228c1a4c08cd6d0d2f50a2fb14be8dfc596df3365f48bec89cd9f0b97

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