Metadata-Version: 1.2
Name: discord-ext-slash
Version: 0.3.0rc4
Summary: Support slash commands with discord.py.
Home-page: https://github.com/Kenny2github/discord-ext-slash
Author: kenny2discord
Author-email: kenny2minecraft@gmail.com
License: MIT
Description: 
        Support slash commands.
        
        Example Usage
        =============
        
        .. code-block:: python
        
            from discord.ext import slash
            client = slash.SlashBot(
                # normal arguments to commands.Bot()
                command_prefix='.', description="whatever",
                # special option: modify all global commands to be
                # actually guild commands for this guild instead,
                # for the purposes of testing. Remove this argument
                # or set it to None to make global commands be
                # properly global - note that they take 1 hour to
                # propagate. Useful because commands have to be
                # re-registered if their API definitions are changed.
                debug_guild=staging_guild_id
            )
        
            msg_opt = slash.Option(
                # description of option, shown when filling in
                description='Message to send',
                # this means that the slash command will not be invoked
                # if this argument is not specified
                required=True)
        
            @client.slash_cmd() # global slash command
            async def repeat( # command name
                ctx: slash.Context, # there MUST be one argument annotated with Context
                message: msg_opt
            ):
                """Send a message in the bot's name""" # description of command
                # respond to the interaction, must be done within 3 seconds
                await ctx.respond(message, # string (or str()able) message
                    # sends a message without showing the command invocation
                    rtype=slash.InteractionResponseType.ChannelMessage)
        
            client.run(token)
        
        Notes
        =====
        * ``slash.Context`` emulates ``commands.Context``, but only to a certain extent.
          Notably, ``ctx.message`` does not exist, because slash commands can be run
          completely without the involvement of messages. However, channel and author
          information is still available.
        * All descriptions are **required**.
        
        See the wiki_.
        
        .. _wiki: https://github.com/Kenny2github/discord-ext-slash/wiki
        
Keywords: discord slash commands
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Topic :: Communications :: Chat
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.7
Requires-Python: >=3.7
