From acd4238fcb9c0135a548eb9bad43923fc41e983e Mon Sep 17 00:00:00 2001
From: Robin <74519799+Robin5605@users.noreply.github.com>
Date: Mon, 15 Aug 2022 17:40:24 -0500
Subject: Migrate on_command_error pin

As part of the migration of the #discord-bots pinned content from discord to the site, this PR migrates the pin regarding `on_command_error` of the discord.py library "eating" (silencing) unhandled errors.
---
 .../guides/python-guides/proper-error-handling.md  | 70 ++++++++++++++++++++++
 1 file changed, 70 insertions(+)
 create mode 100644 pydis_site/apps/content/resources/guides/python-guides/proper-error-handling.md

(limited to 'pydis_site')

diff --git a/pydis_site/apps/content/resources/guides/python-guides/proper-error-handling.md b/pydis_site/apps/content/resources/guides/python-guides/proper-error-handling.md
new file mode 100644
index 00000000..9307169d
--- /dev/null
+++ b/pydis_site/apps/content/resources/guides/python-guides/proper-error-handling.md
@@ -0,0 +1,70 @@
+---
+title: Proper error handling in discord.py
+description: Are you not getting any errors? This might be why!
+---
+If you're not recieving any errors in your console, even though you know you should be, try this:
+
+# With bot subclass:
+```py
+import discord
+from discord.ext import commands
+
+import traceback
+import sys
+
+class MyBot(commands.Bot):
+
+  def __init__(self, *args, **kwargs):
+    super().__init__(*args, **kwargs)
+    
+  async def on_command_error(self, ctx: commands.Context, error):
+    # Handle your errors here
+    if isinstance(error, commands.MemberNotFound):
+      await ctx.send("I could not find member '{error.argument}'. Please try again")
+
+    elif isinstance(error, commands.MissingRequiredArgument):
+      await ctx.send(f"'{error.param.name}' is a required argument.")
+    else:
+      # All unhandled errors will print their original traceback
+      print(f'Ignoring exception in command {ctx.command}:', file=sys.stderr)
+      traceback.print_exception(type(error), error, error.__traceback__, file=sys.stderr)
+      
+bot = MyBot(command_prefix="!", intents=discord.Intents.default())
+
+bot.run("token")
+```
+
+# Without bot subclass
+```py
+import discord
+from discord.ext import commands
+
+import traceback
+import sys
+
+async def on_command_error(self, ctx: commands.Context, error):
+  # Handle your errors here
+  if isinstance(error, commands.MemberNotFound):
+    await ctx.send("I could not find member '{error.argument}'. Please try again")
+
+  elif isinstance(error, commands.MissingRequiredArgument):
+    await ctx.send(f"'{error.param.name}' is a required argument.")
+  else:
+    # All unhandled errors will print their original traceback
+    print(f'Ignoring exception in command {ctx.command}:', file=sys.stderr)
+    traceback.print_exception(type(error), error, error.__traceback__, file=sys.stderr)
+
+bot = commands.Bot(command_prefix="!", intents=discord.Intents.default())
+bot.on_command_error = on_command_error
+
+bot.run("token")
+```
+
+
+Make sure to import `traceback` and `sys`!
+
+-------------------------------------------------------------------------------------------------------------
+
+Useful Links: 
+- [FAQ](https://discordpy.readthedocs.io/en/latest/faq.html)
+- [Simple Error Handling](https://gist.github.com/EvieePy/7822af90858ef65012ea500bcecf1612)
-- 
cgit v1.2.3