refactor: remove dollar sign from usage instructions in various commands for consistency

chore: remove error handling blocks from dev.py to simplify code and rely on global error handling

refactor: remove dollar sign from usage instructions in command decorators for clarity and consistency across all command usage instructions

feat(error.py): add prefix to command usage in error messages for better clarity
refactor(error.py): change error messages to be more descriptive and accurate
feat(error.py): use embeds for error messages for better readability
refactor(error.py): comment out specific error handlers to allow global handler to catch all errors for consistency

refactor(help.py): remove static prefix and add dynamic prefix fetching to improve flexibility
feat(help.py): add command aliases to help command categories for better command visibility
refactor(help.py): change several methods to async to support dynamic prefix fetching
feat(embeds.py): add create_error_embed method to standardize error embed creation

Author: kzndotsh

.archive/notes.py

@@ -14,7 +14,7 @@ def __init__(self, bot: commands.Bot) -> None:
     @commands.hybrid_group(
         name="notes",
         aliases=["n"],
-        usage="$notes <subcommand>",
+        usage="notes <subcommand>",
     )
     @commands.guild_only()
     async def notes(self, ctx: commands.Context[commands.Bot]) -> None:
@@ -32,7 +32,7 @@ async def notes(self, ctx: commands.Context[commands.Bot]) -> None:
     @notes.command(
         name="create",
         aliases=["c", "add", "a"],
-        usage="$notes create [target] [content]",
+        usage="notes create [target] [content]",
     )
     @commands.guild_only()
     async def create_note(self, ctx: commands.Context[commands.Bot], target: discord.Member, content: str) -> None:
@@ -67,7 +67,7 @@ async def create_note(self, ctx: commands.Context[commands.Bot], target: discord
     @notes.command(
         name="delete",
         aliases=["d"],
-        usage="$notes delete [note_id]",
+        usage="notes delete [note_id]",
     )
     @commands.guild_only()
     async def delete_note(self, ctx: commands.Context[commands.Bot], note_id: int) -> None:
@@ -108,7 +108,7 @@ async def delete_note(self, ctx: commands.Context[commands.Bot], note_id: int) -
     @notes.command(
         name="update",
         aliases=["u", "edit", "e", "modify", "m"],
-        usage="$notes update [note_id] [content]",
+        usage="notes update [note_id] [content]",
     )
     @commands.guild_only()
     async def update_note(self, ctx: commands.Context[commands.Bot], note_id: int, content: str) -> None:
@@ -152,7 +152,7 @@ async def update_note(self, ctx: commands.Context[commands.Bot], note_id: int, c
     @notes.command(
         name="view",
         aliases=["v", "get", "g"],
-        usage="$notes view [note_id]",
+        usage="notes view [note_id]",
     )
     @commands.guild_only()
     async def view_note(

tux/cogs/admin/dev.py

@@ -12,7 +12,7 @@ def __init__(self, bot: commands.Bot) -> None:
     @commands.hybrid_group(
         name="dev",
         aliases=["d"],
-        usage="$dev <subcommand>",
+        usage="dev <subcommand>",
     )
     @commands.guild_only()
     @checks.has_pl(8)
@@ -38,7 +38,7 @@ async def dev(self, ctx: commands.Context[commands.Bot]) -> None:
     @dev.command(
         name="sync_tree",
         aliases=["st", "sync", "s"],
-        usage="$dev sync_tree [guild]",
+        usage="dev sync_tree [guild]",
     )
     @commands.guild_only()
     @checks.has_pl(8)
@@ -69,21 +69,10 @@ async def sync_tree(self, ctx: commands.Context[commands.Bot], guild: discord.Gu
         await self.bot.tree.sync(guild=ctx.guild)
         await ctx.send("Application command tree synced.")
 
-    @sync_tree.error
-    async def sync_error(self, ctx: commands.Context[commands.Bot], error: Exception) -> None:
-        if isinstance(error, commands.MissingRequiredArgument):
-            await ctx.send(
-                f"Please specify a guild to sync application commands to. {error}",
-                ephemeral=True,
-                delete_after=30,
-            )
-        else:
-            logger.error(f"Error syncing application commands: {error}")
-
     @dev.command(
         name="clear_tree",
         aliases=["ct", "clear", "c"],
-        usage="$dev clear_tree",
+        usage="dev clear_tree",
     )
     @commands.guild_only()
     @checks.has_pl(8)
@@ -118,7 +107,7 @@ async def clear_tree(self, ctx: commands.Context[commands.Bot]) -> None:
     @dev.command(
         name="load_cog",
         aliases=["lc", "load", "l"],
-        usage="$dev load_cog [cog]",
+        usage="dev load_cog [cog]",
     )
     @commands.guild_only()
     @checks.has_pl(8)
@@ -156,30 +145,10 @@ async def load_cog(self, ctx: commands.Context[commands.Bot], *, cog: str) -> No
             await ctx.send(f"Cog {cog} loaded.")
             logger.info(f"Cog {cog} loaded.")
 
-    @load_cog.error
-    async def load_error(self, ctx: commands.Context[commands.Bot], error: Exception) -> None:
-        if isinstance(error, commands.MissingRequiredArgument):
-            await ctx.send(f"Please specify an cog to load. {error}", ephemeral=True, delete_after=30)
-        elif isinstance(error, commands.ExtensionAlreadyLoaded):
-            await ctx.send(f"The specified cog is already loaded. {error}", ephemeral=True, delete_after=30)
-        elif isinstance(error, commands.ExtensionNotFound):
-            await ctx.send(f"The specified cog is not found. {error}", ephemeral=True, delete_after=30)
-        elif isinstance(error, commands.ExtensionFailed):
-            await ctx.send(f"Failed to load cog: {error}", ephemeral=True, delete_after=30)
-        elif isinstance(error, commands.NoEntryPointError):
-            await ctx.send(
-                f"The specified cog does not have a setup function. {error}",
-                ephemeral=True,
-                delete_after=30,
-            )
-        else:
-            await ctx.send(f"Failed to load cog: {error}", ephemeral=True, delete_after=30)
-            logger.error(f"Failed to load cog: {error}")
-
     @dev.command(
         name="unload_cog",
         aliases=["uc", "unload", "u"],
-        usage="$dev unload_cog [cog]",
+        usage="dev unload_cog [cog]",
     )
     @commands.guild_only()
     @checks.has_pl(8)
@@ -211,19 +180,10 @@ async def unload_cog(self, ctx: commands.Context[commands.Bot], *, cog: str) ->
             logger.info(f"Cog {cog} unloaded.")
             await ctx.send(f"Cog {cog} unloaded.", ephemeral=True, delete_after=30)
 
-    @unload_cog.error
-    async def unload_error(self, ctx: commands.Context[commands.Bot], error: Exception) -> None:
-        if isinstance(error, commands.MissingRequiredArgument):
-            await ctx.send(f"Please specify an extension to unload. {error}", ephemeral=True, delete_after=30)
-        elif isinstance(error, commands.ExtensionNotLoaded):
-            await ctx.send(f"That cog is not loaded. {error}", ephemeral=True, delete_after=30)
-        else:
-            logger.error(f"Error unloading cog: {error}")
-
     @dev.command(
         name="reload_cog",
         aliases=["rc", "reload", "r"],
-        usage="$dev reload_cog [cog]",
+        usage="dev reload_cog [cog]",
     )
     @commands.guild_only()
     @checks.has_pl(8)
@@ -256,16 +216,6 @@ async def reload_cog(self, ctx: commands.Context[commands.Bot], *, cog: str) ->
             await ctx.send(f"Cog {cog} reloaded.", ephemeral=True, delete_after=30)
             logger.info(f"Cog {cog} reloaded.")
 
-    @reload_cog.error
-    async def reload_error(self, ctx: commands.Context[commands.Bot], error: Exception) -> None:
-        if isinstance(error, commands.MissingRequiredArgument):
-            await ctx.send(f"Please specify a cog to reload. {error}", ephemeral=True, delete_after=30)
-        elif isinstance(error, commands.ExtensionNotLoaded):
-            await ctx.send(f"That cog is not loaded. {error}", ephemeral=True, delete_after=30)
-        else:
-            await ctx.send(f"Error reloading cog: {error}", ephemeral=True, delete_after=30)
-            logger.error(f"Error reloading cog: {error}")
-
 
 async def setup(bot: commands.Bot) -> None:
     await bot.add_cog(Dev(bot))

tux/cogs/admin/eval.py

@@ -45,7 +45,7 @@ def __init__(self, bot: commands.Bot) -> None:
     @commands.command(
         name="eval",
         aliases=["e"],
-        usage="$eval [expression]",
+        usage="eval [expression]",
     )
     @commands.guild_only()
     @checks.has_pl(9)

tux/cogs/admin/git.py

@@ -403,7 +403,7 @@ def __init__(self, bot: commands.Bot) -> None:
     @commands.hybrid_group(
         name="git",
         aliases=["g"],
-        usage="$git <subcommand>",
+        usage="git <subcommand>",
     )
     @commands.guild_only()
     @checks.has_pl(8)
@@ -423,7 +423,7 @@ async def git(self, ctx: commands.Context[commands.Bot]) -> None:
     @git.command(
         name="get_repo",
         aliases=["r"],
-        usage="$git get_repo",
+        usage="git get_repo",
     )
     @commands.guild_only()
     @checks.has_pl(8)
@@ -461,7 +461,7 @@ async def get_repo(self, ctx: commands.Context[commands.Bot]) -> None:
     @git.command(
         name="create_issue",
         aliases=["ci"],
-        usage="$git create_issue [title] [body]",
+        usage="git create_issue [title] [body]",
     )
     @commands.guild_only()
     # @checks.has_pl(8)
@@ -503,7 +503,7 @@ async def create_issue(self, ctx: commands.Context[commands.Bot], title: str, bo
     @git.command(
         name="get_issue",
         aliases=["gi", "issue", "i"],
-        usage="$git get_issue [issue_number]",
+        usage="git get_issue [issue_number]",
     )
     @commands.guild_only()
     @checks.has_pl(8)

tux/cogs/fun/random.py

@@ -12,7 +12,7 @@ def __init__(self, bot: commands.Bot) -> None:
     @commands.hybrid_group(
         name="random",
         aliases=["rand"],
-        usage="$random <subcommand>",
+        usage="random <subcommand>",
     )
     @commands.guild_only()
     async def random(self, ctx: commands.Context[commands.Bot]) -> None:
@@ -30,7 +30,7 @@ async def random(self, ctx: commands.Context[commands.Bot]) -> None:
     @random.command(
         name="coinflip",
         aliases=["cf"],
-        usage="$random coinflip",
+        usage="random coinflip",
     )
     @commands.guild_only()
     async def coinflip(self, ctx: commands.Context[commands.Bot]) -> None:
@@ -50,7 +50,7 @@ async def coinflip(self, ctx: commands.Context[commands.Bot]) -> None:
     @random.command(
         name="8ball",
         aliases=["eightball", "8b"],
-        usage="$random 8ball [question]",
+        usage="random 8ball [question]",
     )
     @commands.guild_only()
     async def eight_ball(self, ctx: commands.Context[commands.Bot], *, question: str, cow: bool = False) -> None:
@@ -140,7 +140,7 @@ async def eight_ball(self, ctx: commands.Context[commands.Bot], *, question: str
     @random.command(
         name="dice",
         aliases=["d"],
-        usage="$random dice <sides>",
+        usage="random dice <sides>",
     )
     @commands.guild_only()
     async def dice(self, ctx: commands.Context[commands.Bot], sides: int = 6) -> None:
@@ -170,7 +170,7 @@ async def dice(self, ctx: commands.Context[commands.Bot], sides: int = 6) -> Non
     @random.command(
         name="number",
         aliases=["n"],
-        usage="$random number <min> <max>",
+        usage="random number <min> <max>",
     )
     @commands.guild_only()
     async def random_number(

tux/cogs/fun/xkcd.py

@@ -15,7 +15,7 @@ def __init__(self, bot: commands.Bot) -> None:
     @commands.hybrid_group(
         name="xkcd",
         aliases=["xk"],
-        usage="$xkcd <subcommand>",
+        usage="xkcd <subcommand>",
     )
     @commands.guild_only()
     async def xkcd(self, ctx: commands.Context[commands.Bot], comic_id: int | None = None) -> None:
@@ -38,7 +38,7 @@ async def xkcd(self, ctx: commands.Context[commands.Bot], comic_id: int | None =
     @xkcd.command(
         name="latest",
         aliases=["l", "new", "n"],
-        usage="$xkcd latest",
+        usage="xkcd latest",
     )
     @commands.guild_only()
     async def latest(self, ctx: commands.Context[commands.Bot]) -> None:
@@ -61,7 +61,7 @@ async def latest(self, ctx: commands.Context[commands.Bot]) -> None:
     @xkcd.command(
         name="random",
         aliases=["rand", "r"],
-        usage="$xkcd random",
+        usage="xkcd random",
     )
     @commands.guild_only()
     async def random(self, ctx: commands.Context[commands.Bot]) -> None:
@@ -84,7 +84,7 @@ async def random(self, ctx: commands.Context[commands.Bot]) -> None:
     @xkcd.command(
         name="specific",
         aliases=["s", "id", "num"],
-        usage="$xkcd specific [comic_id]",
+        usage="xkcd specific [comic_id]",
     )
     @commands.guild_only()
     async def specific(self, ctx: commands.Context[commands.Bot], comic_id: int) -> None:

tux/cogs/info/avatar.py

@@ -36,7 +36,7 @@ async def slash_avatar(
     @commands.command(
         name="avatar",
         aliases=["av"],
-        usage="$avatar <member>",
+        usage="avatar <member>",
     )
     @commands.guild_only()
     async def prefix_avatar(

tux/cogs/misc/run.py

@@ -232,7 +232,7 @@ async def send_embedded_reply(
     @commands.command(
         name="run",
         aliases=["compile", "exec"],
-        usage="$run [code]",
+        usage="run [code]",
     )
     async def run(
         self,
@@ -302,7 +302,7 @@ async def run_error(
     @commands.command(
         name="languages",
         aliases=["langs"],
-        usage="$languages",
+        usage="languages",
     )
     async def languages(self, ctx: commands.Context[commands.Bot]) -> None:
         """

tux/cogs/moderation/ban.py

@@ -18,7 +18,7 @@ def __init__(self, bot: commands.Bot) -> None:
     @commands.hybrid_command(
         name="ban",
         aliases=["b"],
-        usage="$ban [target] <flags>",
+        usage="ban [target] <flags>",
     )
     @commands.guild_only()
     @checks.has_pl(3)

tux/cogs/moderation/cases.py

@@ -33,7 +33,7 @@ def __init__(self, bot: commands.Bot) -> None:
     @commands.hybrid_group(
         name="cases",
         aliases=["c"],
-        usage="$cases <subcommand>",
+        usage="cases <subcommand>",
     )
     @commands.guild_only()
     @checks.has_pl(2)
@@ -47,7 +47,7 @@ async def cases(self, ctx: commands.Context[commands.Bot]) -> None:
     @cases.command(
         name="view",
         aliases=["v", "ls", "list"],
-        usage="$cases view <case_number> <flags>",
+        usage="cases view <case_number> <flags>",
     )
     @commands.guild_only()
     @checks.has_pl(2)
@@ -83,7 +83,7 @@ async def cases_view(
     @cases.command(
         name="modify",
         aliases=["m", "edit"],
-        usage="$cases modify [case_number] <flags>",
+        usage="cases modify [case_number] <flags>",
     )
     @commands.guild_only()
     @checks.has_pl(2)