Skip to main content

Simple Discord Slash Command extension for discord.py.

Project description

discord-py-slash-command

Simple Discord Slash Commands extension for discord.py.

Example

Normal usage:

import discord
from discord.ext import commands
from discord_slash import SlashCommand
from discord_slash import SlashContext

bot = commands.Bot(command_prefix="!", intents=discord.Intents.all())
slash = SlashCommand(bot)


@slash.slash(name="test")
async def _test(ctx: SlashContext):
    embed = discord.Embed(title="embed test")
    await ctx.send(content="test", embeds=[embed])


bot.run("discord_token")

Cog (Not Recommended):

import discord
from discord.ext import commands
from discord_slash import SlashCommand
from discord_slash import SlashContext


class Slash(commands.Cog):
    def __init__(self, bot):
        self.bot = bot
        self.slash = SlashCommand(bot, override_type=True)
        # Cog is only supported by commands ext, so just skip checking type.

        # Make sure all commands should be inside `__init__`
        # or some other functions that can put commands.
        @self.slash.slash(name="test")
        async def _test(ctx: SlashContext):
            await ctx.send(content="Hello, World!")

    def cog_unload(self):
        self.slash.remove()


def setup(bot):
    bot.add_cog(Slash(bot))

Installation

pip install -U discord-py-slash-command

Simple note before you use this

Since slash commands are currently not officially released (They're in public beta), there will be many breaking changes to this extension which may cause it to become unstable, so I'd recommend waiting until discord officially releases slash commands, and waiting until Release 1.1.0, which I'm planning to finish implementing most of the features.
Or you can wait until discord.py supports slash commands.

DOCS

https://discord-py-slash-command.readthedocs.io/en/latest/
See discord-api-docs for some more information about some formats.

Any Questions?

Discord Server
Or you can ask at Discussions.

TODO

  • Support subcommands
  • Try supporting most of the features supported by discord.py commands extension

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

discord-py-slash-command-1.0.5.tar.gz (10.4 kB view hashes)

Uploaded Source

Built Distribution

discord_py_slash_command-1.0.5-py3-none-any.whl (13.2 kB view hashes)

Uploaded Python 3

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