Introduction

This is an introductory page to showcase the use and functionality of discord-ext-check, as well as how to use it

discord-ext-check:

discord-ext-check is a module which implements various decorator functions, to be used on discord command functions for your discord.py bot

Installation:

Installation is done using pip: https://pypi.org/project/discord-ext-check/

pip install discord-ext-check

Usage:

Starting off, import discord.ext.check and then you can use its various decorator functions.

Examples:

from discord.ext import check

#.. Creating your Discord Bot ...

"""Checking if the author is the Server Owner"""
@bot.command()
@check.is_guild_owner()
async def foo(ctx):
    await ctx.send(f"{ctx.author.mention} is the Server Owner!")

"""Checking if 3 arguments were passed into the function"""
@bot.command()
@check.has_args(3)
async def bar(ctx, x, y):
    await ctx.send(f"The result is {x + y}")

"""Error Handling"""
@bar.error
async def bar_error(ctx, error):
    if isinstance(error, check.NotEnoughArgs):
        await ctx.send("You have to Enter 3 Arguments (ctx, x, and y) for the command to work")
    else:
        raise error

"""Checking if the author's id is in the list of Authorized Members"""
authorized_members = [394320584089010179, 446670262440820746, 449864700306522112]

@bot.command()
@check.has_user_id_in(authorized_members)
async def baz(ctx):
    await ctx.send("You are an Authorized Member.")

"""Error Handling"""
@baz.error
async def baz_error(ctx, error):
    if isinstance(error, check.MissingID):
        await ctx.send("You are not Authorized.")
    else:
        raise error

bot.run(token)

Notes:

  • If you need any help related to this module, DM me @Multiii#7676

Last updated

Was this helpful?