Improve examples (#791)

Author: Ratery

examples/app_commands/slash_options.py

@@ -1,20 +1,33 @@
 import discord
 from discord.commands import Option
 
-bot = discord.Bot()
 
+bot = discord.Bot()
 # If you use commands.Bot, @bot.slash_command should be used for
 # slash commands. You can use @bot.slash_command with discord.Bot as well
 
 
 @bot.slash_command(guild_ids=[...])
 async def hello(
-    ctx,
+    ctx: discord.ApplicationContext,
     name: Option(str, "Enter your name"),
     gender: Option(str, "Choose your gender", choices=["Male", "Female", "Other"]),
-    age: Option(int, "Enter your age", required=False, default=18),
+    age: Option(int, "Enter your age", min_value=1, max_value=99, default=18)
+    # passing the default value makes an argument optional
+    # you also can create optional argument using:
+    # age: Option(int, "Enter your age") = 18
 ):
-    await ctx.respond(f"Hello {name}")
+    await ctx.respond(f"Hello {name}! Your gender is {gender} and you are {age} years old.")
+
+
+@bot.slash_command(guild_ids=[...])
+async def channel(
+    ctx: discord.ApplicationContext,
+    channel: Option([discord.TextChannel, discord.VoiceChannel], "Select a channel")
+    # you can specify allowed channel types by passing a list of them like: [discord.TextChannel, discord.VoiceChannel]
+):
+    await ctx.respond(f"Hi! You selected {channel.mention} channel.")
+
 
 
 bot.run("TOKEN")

examples/custom_context.py

@@ -4,7 +4,7 @@
 from discord.ext import commands
 
 
-class MyContext(commands.Context):
+class MyContext(commands.Context):  # custom context
     async def tick(self, value):
         # reacts to the message with an emoji
         # depending on whether value is True or False
@@ -21,13 +21,30 @@ async def tick(self, value):
             pass
 
 
+# you can subclass discord.ApplicationContext to create custom application context if needed
+class MyApplicationContext(discord.ApplicationContext):  # custom application context
+    async def success(self, message):
+        try:
+            await self.respond(embed=discord.Embed(  # respond with a green embed with "Success" title
+                title="Success",
+                description=message,
+                colour=discord.Colour.green()
+            ))
+        except discord.HTTPException:  # ignore exceptions
+            pass
+
+
 class MyBot(commands.Bot):
     async def get_context(self, message, *, cls=MyContext):
         # when you override this method, you pass your new Context
         # subclass to the super() method, which tells the bot to
         # use the new MyContext class
         return await super().get_context(message, cls=cls)
 
+    async def get_application_context(self, interaction, cls=MyApplicationContext):
+        # the same stuff for custom application context
+        return await super().get_application_context(interaction, cls=cls)
+
 
 bot = MyBot(command_prefix="!")
 
@@ -44,10 +61,19 @@ async def guess(ctx, number: int):
     await ctx.tick(number == value)
 
 
+@bot.slash_command(guild_ids=[...])
+async def slash_guess(ctx, number: int):
+    """Guess a random number from 1 to 6."""
+    value = random.randint(1, 6)
+    if number == value:
+        await ctx.success("Congratulations! You guessed the number.")  # use the new helper function
+    else:
+        await ctx.respond("You are wrong! Try again.")
+
+
 # IMPORTANT: You shouldn't hard code your token
 # these are very important, and leaking them can
 # let people do very malicious things with your
 # bot. Try to use a file or something to keep
 # them private, and don't commit it to GitHub
-token = "your token here"
-bot.run(token)
+bot.run("TOKEN")