Initial commit

Author: Kenny2github

.gitignore

@@ -0,0 +1,5 @@
+dist/*
+*.pyc
+__pycache__/
+build/*
+*.egg*

LICENSE.txt

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2021 kenny2discord
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.rst

@@ -0,0 +1,52 @@
+
+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 are
+        # re-registered every time the bot starts.
+        debug_guild=7293012031203012
+    )
+
+    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
+        await ctx.respond(message, # respond to the interaction
+            # 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**.
+
+Not Yet Supported
+=================
+* Subcommands