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

Uploaded Source

Built Distribution

discordbot_sync-1.2.2-py3-none-any.whl (31.1 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: discordbot-sync-1.2.2.tar.gz
  • Upload date:
  • Size: 29.3 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.2.2.tar.gz
Algorithm Hash digest
SHA256 25430bdbc505df1b5b26bf9d502c2b47ea772568f1021970243d02c599c120e5
MD5 c444533ef61cbe79e7339cb1bc71ab99
BLAKE2b-256 ee2725e7381f53b91ed8b0ad9dcc771404e5ebb31a26ae601fa99b3838461ef9

See more details on using hashes here.

File details

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

File metadata

  • Download URL: discordbot_sync-1.2.2-py3-none-any.whl
  • Upload date:
  • Size: 31.1 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.2.2-py3-none-any.whl
Algorithm Hash digest
SHA256 d524d6b98cb6c3ac6853ef011964609127a5388998c3aa99f5b54aae9d86fdca
MD5 8986f592d6be22f7b99307621a8c4961
BLAKE2b-256 1d6782fe934230e1c68c522136d02567a4575c4f45b35fbbb70680bc021e91f3

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