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

Uploaded Source

Built Distribution

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

Uploaded Python 3

File details

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

File metadata

  • Download URL: discordbot-sync-1.1.0.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.0.tar.gz
Algorithm Hash digest
SHA256 d384b4b15235713fb127bce9ef023ebadd75b55de4a1599ac54525bfb4ba017e
MD5 4691643519cb373c141582cdcf972005
BLAKE2b-256 8a7fd1a6c81eec4cc32e50da28bc1b45ce95185b9f98d9c60abdfc580520b908

See more details on using hashes here.

File details

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

File metadata

  • Download URL: discordbot_sync-1.1.0-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.0-py3-none-any.whl
Algorithm Hash digest
SHA256 9ff95e3a1c56024f41071769587a775c16cf65f1b9f26daa719b98b95585325f
MD5 da3cb24bee14ccfec10bc9634014dd81
BLAKE2b-256 2db14d0be451f8858103b61e4082df98af5c166bb15f368d25310cc8b0d5161c

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