Format examples

Author: Dorukyum

examples/background_task.py

@@ -1,6 +1,5 @@
-from discord.ext import tasks
-
 import discord
+from discord.ext import tasks
 
 
 class MyClient(discord.Client):

examples/background_task_asyncio.py

@@ -1,6 +1,7 @@
-import discord
 import asyncio
 
+import discord
+
 
 class MyClient(discord.Client):
     def __init__(self, *args, **kwargs):

examples/basic_bot.py

@@ -1,8 +1,9 @@
 # This example requires the 'members' privileged intents
 
+import random
+
 import discord
 from discord.ext import commands
-import random
 
 description = """An example bot to showcase the discord.ext.commands extension
 module.

examples/basic_voice.py

@@ -1,8 +1,8 @@
 import asyncio
 
-import discord
 import youtube_dl
 
+import discord
 from discord.ext import commands
 
 # Suppress noise about console usage from errors

examples/custom_context.py

@@ -34,7 +34,7 @@ async def get_context(self, message, *, cls=MyContext):
 
 @bot.command()
 async def guess(ctx, number: int):
-    """ Guess a random number from 1 to 6. """
+    """Guess a random number from 1 to 6."""
     # explained in a previous example, this gives you
     # a random number from 1-6
     value = random.randint(1, 6)

examples/edits.py

@@ -1,6 +1,7 @@
-import discord
 import asyncio
 
+import discord
+
 
 class MyClient(discord.Client):
     async def on_ready(self):

examples/guessing_game.py

@@ -1,6 +1,7 @@
-import discord
-import random
 import asyncio
+import random
+
+import discord
 
 
 class MyClient(discord.Client):

examples/views/button_roles.py

@@ -20,8 +20,11 @@ def __init__(self, role: discord.Role):
         """
         A button for one role. `custom_id` is needed for persistent views.
         """
-        super().__init__(label=role.name,
-                         style=discord.enums.ButtonStyle.primary, custom_id=str(role.id))
+        super().__init__(
+            label=role.name,
+            style=discord.enums.ButtonStyle.primary,
+            custom_id=str(role.id),
+        )
 
     async def callback(self, interaction: discord.Interaction):
         """This function will be called any time a user clicks on this button
@@ -47,11 +50,15 @@ async def callback(self, interaction: discord.Interaction):
         if role not in user.roles:
             # give the user the role if they don't already have it
             await user.add_roles(role)
-            await interaction.response.send_message(f"🎉 You have been given the role {role.mention}", ephemeral=True)
+            await interaction.response.send_message(
+                f"🎉 You have been given the role {role.mention}", ephemeral=True
+            )
         else:
             # else, take the role from the user
             await user.remove_roles(role)
-            await interaction.response.send_message(f"❌ The {role.mention} role has been taken from you", ephemeral=True)
+            await interaction.response.send_message(
+                f"❌ The {role.mention} role has been taken from you", ephemeral=True
+            )
 
 
 class ButtonRoleCog(commands.Cog):
@@ -65,8 +72,7 @@ def __init__(self, bot):
     # make sure to set the guild ID here to whatever server you want the buttons in
     @slash_command(guild_ids=[...], description="Post the button role message")
     async def post(self, ctx: commands.Context):
-        """Slash command to post a new view with a button for each role
-        """
+        """A slash command to post a new view with a button for each role"""
 
         # timeout is None because we want this view to be persistent
         view = discord.ui.View(timeout=None)

examples/views/confirm.py

@@ -1,6 +1,5 @@
-from discord.ext import commands
-
 import discord
+from discord.ext import commands
 
 
 class Bot(commands.Bot):

examples/views/counter.py

@@ -1,6 +1,5 @@
-from discord.ext import commands
-
 import discord
+from discord.ext import commands
 
 
 class CounterBot(commands.Bot):