Update away.py

* per member toggleaway

* format and black

* remove black format as requested

.gitignore

@@ -0,0 +1,129 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+.hypothesis/
+.pytest_cache/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# celery beat schedule file
+celerybeat-schedule
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# Sublime project files
+*.sublime-project
+*.sublime-workspace
+
+# PyCharm project files
+.idea/
+
+# VS Code project files
+.vscode/

README.md

@@ -1,13 +1,13 @@
 # aikaterna-cogs
 v3 Cogs for Red-DiscordBot by Twentysix26.
 
-adventure - Originally by Locastan. My version is a collaboration between TrustyJAID and myself. The repo can be found at: https://github.com/aikaterna/gobcog
+adventure - Original concept & cog by locastan. My version is a collaboration between TrustyJAID, Draper, and myself and is now markedly different than locastan's version. The repo can be found on my repo page here on github.
 
-antiphoneclapper - Detects and removes bad GIFs posted in chat that have malformed frames. Thanks to Sitryk for all of the code that actually mattered for detection in this cog. Config stuff tacked on by me. Later iterations will include emoji recognizing and possibly link detection for these bad images.
+antiphoneclapper - Detects and removes bad GIFs posted in chat that have malformed frames. Thanks to Sitryk for all of the code that actually mattered for detection in this cog.
 
-away - Originally by Paddo, written for v3 by Axas, final tests by aikaterna, and large improvements by TrustyJAID. Set and unset a user as being "away".
+away - Originally by Paddo, written for v3 by Axas, final tests by aikaterna, and large improvements by TrustyJAID. Set and unset a user as being "away", or other statuses.
 
-blurplefy - Make an avatar or an image upload blurple for Discord's 3rd anniversary.
+blurplefy - Make an avatar or an image upload blurple for Discord's anniversaries.
 
 cah - Cards Against Humanity, played in DM's. This can rate limit large bots via the sheer number of messages sent. Install and use with caution on larger bots.
 
@@ -15,15 +15,23 @@ chatchart - Generates a pie chart to display chat activity over the last 5000 me
 
 dadjokes - Another UltimatePancake cog. Get some dad jokes on command.
 
-dictonary - I stole this from UltimatePancake's v2 cogs, defines words via a dictonary. Only the "define" command for now until the dependency owner updates their files with a pending PR.
+dictonary - Define words and look up antonyms and synonyms. Originally by UltimatePancake.
 
-dungeon - New users with new accounts will be shuffled off to a locked channel on-join to help mitigate raiders. Please see the dungeon_readme.md file on this repo for more information.
+dungeon - New users with new accounts will be shuffled off to a locked channel on-join to help mitigate raiders. Please see the [dungeon_readme.md](https://github.com/aikaterna/aikaterna-cogs/blob/v3/dungeon_readme.md) file on this repo for more information.
 
-imgwelcome - The repo can be found at: https://github.com/aikaterna/imgwelcome
+hunting - A long overdue port of Paddo's v2 hunting game to v3.
+
+icyparser - Show icecast/shoutcast stream information. An audio addon cog to show the current stream info, or provide a url yourself.
+
+imgwelcome - Welcome users to your server(s) with an image. The repo can be found on my repo page here on github.
 
 inspirobot - Fetch "inspirational" messages from inspirobot.me with [p]inspireme.
 
-leveler - A v3 port of Stevy's v2 leveler, originally by Fixator and modified by me. Add the repo at: https://github.com/aikaterna/Fixator10-Cogs
+invites - Display invites that are available on the server and the information those invites contain. The bot must have the administrator permission granted on the guild to be able to use this cog.
+
+latex - A simple cog originally by Stevy for v2 that displayes LaTeX expressions in an image.
+
+luigipoker - Play the Luigi Poker minigame from New Super Mario Brothers. Ported from the v2 version written by themario30.
 
 noflippedtables - A v3 port of irdumb's v2 cog with a little extra surprise included. Unflip all the tables.
 
@@ -39,12 +47,16 @@ pressf - A port/rewrite of NekoTony's v2 pressf cog. Pay your respects by pressi
 
 pupper - A cog for Ryan5374. A pet that comes around on an on_message listener and waits for someone to pet it (react with a standard wave emoji), and rewards with credits. Many attributes are configurable.
 
+quiz - A kahoot-like trivia game. Originally by Keane for Red v2.
+
 region - A command to change the voice region of a server. Requires the guild admin or mod role or guild administrator.
 
-retrosign - A v3 port of Anismash's retrosign cog: https://github.com/Anismash/Ani-Cogs/tree/master/retrosign
+retrosign - A v3 port of Anismash's retrosign cog.
 
 rndstatus - A v3 port of Twentysix's rndstatus cog with a couple extra settings.
 
+rss - Will's RSS cog ported for v3 with a lot of extra bells and whistles.
+
 snacktime - A v3 port of irdumb's snacktime cog. Now with friends!
 
 timezone - A v3 port of Fishyfing's timezone cog with a few improvements.
@@ -53,8 +65,10 @@ trickortreat - A trick or treat-based competitive candy eating game with a leade
 
 tools - A collection of mod and admin tools, ported from my v2 version. Sitryk is responsible for a lot of the code in tools... thanks for the help with this cog.
 
+warcraftlogs - Fetch player info/metrics from the WarcraftLogs API for World of Warcraft Classic. Does not provide stats for non-Classic characters.
+
 wolfram - A v3 port of Paddo's abandoned Wolfram Alpha cog.
 
 youtube - A v3 port of Paddo's youtube search cog for v2.
 
-Are you looking for the v3 lavalink music cog? It's been added to Red v3 as the audio module. Install from develop and ask in the Red support server for help if you need it, or join my server. https://discord.gg/th6eS3T
+Support for these cogs is via opened issues on the appropriate repo or in the Red - Cog Support server at https://discord.gg/KcAbsvD, in the support-aikaterna-cogs channel.

antiphoneclapper/__init__.py

@@ -1,5 +1,7 @@
 from .antiphoneclapper import AntiPhoneClapper
 
+__red_end_user_data_statement__ = "This cog does not persistently store data or metadata about users."
+
 
 async def setup(bot):
     bot.add_cog(AntiPhoneClapper(bot))

antiphoneclapper/antiphoneclapper.py

@@ -2,24 +2,24 @@ from PIL import Image
 from io import BytesIO
 import aiohttp
 import discord
+import logging
 
 from redbot.core import commands, checks, Config
 
-BaseCog = getattr(commands, "Cog", object)
 
-listener = getattr(commands.Cog, "listener", None)  # Trusty + Sinbad
-if listener is None:
-
-    def listener(name=None):
-        return lambda x: x
+log = logging.getLogger("red.aikaterna.antiphoneclapper")
 
 
-class AntiPhoneClapper(BaseCog):
+class AntiPhoneClapper(commands.Cog):
     """This cog deletes bad GIFs that will crash phone clients."""
 
+    async def red_delete_data_for_user(self, **kwargs):
+        """ Nothing to delete """
+        return
+
     def __init__(self, bot):
         self.bot = bot
-        self.session = aiohttp.ClientSession() 
+        self.session = aiohttp.ClientSession()
         self.config = Config.get_conf(self, 2719371001, force_registration=True)
 
         default_guild = {"watching": []}
@@ -35,7 +35,10 @@ class AntiPhoneClapper(BaseCog):
 
     @nogif.command()
     async def watch(self, ctx, channel: discord.TextChannel):
-        """Add a channel to watch. Gifs that break mobile clients will be removed in these channels."""
+        """
+        Add a channel to watch. 
+        Gif attachments that break mobile clients will be removed in these channels.
+        """
         channel_list = await self.config.guild(ctx.guild).watching()
         if channel.id not in channel_list:
             channel_list.append(channel.id)
@@ -61,9 +64,7 @@ class AntiPhoneClapper(BaseCog):
         else:
             return await ctx.send("Channel is not being watched.")
         await self.config.guild(ctx.guild).watching.set(channel_list)
-        await ctx.send(
-            f"{self.bot.get_channel(channel.id).mention} will not have bad gifs removed."
-        )
+        await ctx.send(f"{self.bot.get_channel(channel.id).mention} will not have bad gifs removed.")
 
     def is_phone_clapper(self, im):
         limit = im.size
@@ -73,7 +74,7 @@ class AntiPhoneClapper(BaseCog):
             tile_sizes.append(im.tile[0][1][2:])
         return any([x[0] > limit[0] or x[1] > limit[1] for x in tile_sizes])
 
-    @listener()
+    @commands.Cog.listener()
     async def on_message(self, m):
         if not m.attachments:
             return
@@ -102,13 +103,11 @@ class AntiPhoneClapper(BaseCog):
             if phone_clapper:
                 try:
                     await m.delete()
-                    await m.channel.send(
-                        f"{m.author.mention} just tried to send a phone-killing GIF and I removed it."
-                    )
+                    await m.channel.send(f"{m.author.mention} just tried to send a phone-killing GIF and I removed it.")
                     return
                 except discord.errors.Forbidden:
                     await m.channel.send(f"Don't send GIFs that do that, {m.author.mention}")
-                    print(f"Failed to delete message ({m.id}) that contained phone killing gif")
+                    log.debug(f"Failed to delete message ({m.id}) that contained phone killing gif")
                     return
             else:
                 return

antiphoneclapper/info.json

@@ -11,5 +11,6 @@
 		"pillow"
 	],
 	"short": "Deletes messages with malformed GIFs.",
-	"type": "COG"
+	"type": "COG",
+	"end_user_data_statement": "This cog does not persistently store data or metadata about users."
 }

away/__init__.py

@@ -1,5 +1,16 @@
 from .away import Away
 
+__red_end_user_data_statement__ = (
+    "This cog stores data provided by users "
+    "for the express purpose of redisplaying. "
+    "It does not store user data which was not "
+    "provided through a command. "
+    "Users may remove their own content "
+    "without making a data removal request. "
+    "This cog does not support data requests, "
+    "but will respect deletion requests."
+)
+
 
 def setup(bot):
     bot.add_cog(Away(bot))

away/away.py

@@ -1,24 +1,17 @@
 import discord
 from redbot.core import Config, commands, checks
-from typing import Optional
+from typing import Optional, Literal
 import datetime
 import re
 
 IMAGE_LINKS = re.compile(r"(http[s]?:\/\/[^\"\']*\.(?:png|jpg|jpeg|gif|png))")
 
-BaseCog = getattr(commands, "Cog", object)
 
-listener = getattr(commands.Cog, "listener", None)  # Trusty + Sinbad
-if listener is None:
-
-    def listener(name=None):
-        return lambda x: x
-
-
-class Away(BaseCog):
+class Away(commands.Cog):
     """Le away cog"""
 
     default_global_settings = {"ign_servers": []}
+    default_guild_settings = {"TEXT_ONLY": False, "BLACKLISTED_MEMBERS": []}
     default_user_settings = {
         "MESSAGE": False,
         "IDLE_MESSAGE": False,
@@ -26,13 +19,19 @@ class Away(BaseCog):
         "OFFLINE_MESSAGE": False,
         "GAME_MESSAGE": {},
         "STREAMING_MESSAGE": False,
-        "LISTENING_MESSAGE": False,
+        "LISTENING_MESSAGE": False
     }
 
+    async def red_delete_data_for_user(
+        self, *, requester: Literal["discord", "owner", "user", "user_strict"], user_id: int,
+    ):
+        await self._away.user_from_id(user_id).clear()
+
     def __init__(self, bot):
         self.bot = bot
         self._away = Config.get_conf(self, 8423491260, force_registration=True)
         self._away.register_global(**self.default_global_settings)
+        self._away.register_guild(**self.default_guild_settings)
         self._away.register_user(**self.default_user_settings)
 
     def _draw_play(self, song):
@@ -63,38 +62,45 @@ class Away(BaseCog):
         """
         avatar = author.avatar_url_as()  # This will return default avatar if no avatar is present
         color = author.color
+        link = None
         if message:
             link = IMAGE_LINKS.search(message)
             if link:
                 message = message.replace(link.group(0), " ")
         if state == "away":
             em = discord.Embed(description=message, color=color)
-            em.set_author(name="{} is currently away".format(author.display_name), icon_url=avatar)
+            em.set_author(name=f"{author.display_name} is currently away", icon_url=avatar)
         elif state == "idle":
             em = discord.Embed(description=message, color=color)
-            em.set_author(name="{} is currently idle".format(author.display_name), icon_url=avatar)
+            em.set_author(name=f"{author.display_name} is currently idle", icon_url=avatar)
         elif state == "dnd":
             em = discord.Embed(description=message, color=color)
-            em.set_author(
-                name="{} is currently do not disturb".format(author.display_name), icon_url=avatar
-            )
+            em.set_author(name=f"{author.display_name} is currently do not disturb", icon_url=avatar)
         elif state == "offline":
             em = discord.Embed(description=message, color=color)
-            em.set_author(
-                name="{} is currently offline".format(author.display_name), icon_url=avatar
-            )
+            em.set_author(name=f"{author.display_name} is currently offline", icon_url=avatar)
         elif state == "gaming":
             em = discord.Embed(description=message, color=color)
             em.set_author(
-                name=f"{author.display_name} is currently playing {author.activity.name}",
-                icon_url=avatar,
+                name=f"{author.display_name} is currently playing {author.activity.name}", icon_url=avatar,
             )
             em.title = getattr(author.activity, "details", None)
             thumbnail = getattr(author.activity, "large_image_url", None)
             if thumbnail:
                 em.set_thumbnail(url=thumbnail)
+        elif state == "gamingcustom":
+            status = [c for c in author.activities if c.type == discord.ActivityType.playing]
+            em = discord.Embed(description=message, color=color)
+            em.set_author(
+                name=f"{author.display_name} is currently playing {status[0].name}", icon_url=avatar,
+            )
+            em.title = getattr(status[0], "details", None)
+            thumbnail = getattr(status[0], "large_image_url", None)
+            if thumbnail:
+                em.set_thumbnail(url=thumbnail)
         elif state == "listening":
             em = discord.Embed(color=author.activity.color)
+            url = f"https://open.spotify.com/track/{author.activity.track_id}"
             artist_title = f"{author.activity.title} by " + ", ".join(
                 a for a in author.activity.artists
             )
@@ -102,25 +108,55 @@ class Away(BaseCog):
                 len(author.display_name) + 27
             )  # incase we go over the max allowable size
             em.set_author(
-                name=f"{author.display_name} is currently listening to {artist_title[:limit]}",
+                name=f"{author.display_name} is currently listening to",
                 icon_url=avatar,
+                url=url,
             )
-            em.description = message + "\n" + self._draw_play(author.activity)
-            # em.set_footer(text=author.activity.duration)
+            em.description = (
+                f"{message}\n "
+                f"[{artist_title}]({url})\n"
+                f"{self._draw_play(author.activity)}"
+            )
+
             em.set_thumbnail(url=author.activity.album_cover_url)
+        elif state == "listeningcustom":
+            activity = [c for c in author.activities if c.type == discord.ActivityType.listening]
+            em = discord.Embed(color=activity[0].color)
+            url = f"https://open.spotify.com/track/{activity[0].track_id}"
+            artist_title = f"{activity[0].title} by " + ", ".join(a for a in activity[0].artists)
+            limit = 256 - (len(author.display_name) + 27)
+            em.set_author(
+                name=f"{author.display_name} is currently listening to",
+                icon_url=avatar,
+                url=url
+            )
+            em.description = (
+                f"{message}\n "
+                f"[{artist_title}]({url})\n"
+                f"{self._draw_play(activity[0])}"
+            )
+            em.set_thumbnail(url=activity[0].album_cover_url)
         elif state == "streaming":
             color = int("6441A4", 16)
             em = discord.Embed(color=color)
             em.description = message + "\n" + author.activity.url
             em.title = getattr(author.activity, "details", None)
             em.set_author(
-                name=f"{author.display_name} is currently streaming {author.activity.name}",
-                icon_url=avatar,
+                name=f"{author.display_name} is currently streaming {author.activity.name}", icon_url=avatar,
+            )
+        elif state == "streamingcustom":
+            activity = [c for c in author.activities if c.type == discord.ActivityType.streaming]
+            color = int("6441A4", 16)
+            em = discord.Embed(color=color)
+            em.description = message + "\n" + activity[0].url
+            em.title = getattr(author.activity, "details", None)
+            em.set_author(
+                name=f"{author.display_name} is currently streaming {activity[0].name}", icon_url=avatar,
             )
         else:
             em = discord.Embed(color=color)
             em.set_author(name="{} is currently away".format(author.display_name), icon_url=avatar)
-        if link and state not in ["listening", "gaming"]:
+        if link and state not in ["listening", "listeningcustom", "gaming"]:
             em.set_image(url=link.group(0))
         return em
 
@@ -128,7 +164,6 @@ class Away(BaseCog):
         """
             Replaces user mentions with their username
         """
-        print(message)
         for word in message.split():
             match = re.search(r"<@!?([0-9]+)>", word)
             if match:
@@ -140,41 +175,52 @@ class Away(BaseCog):
         """
             Makes the message to display if embeds aren't available
         """
-        message = await self.find_user_mention(message)
+        url = None
+        if message:
+            message = await self.find_user_mention(message)
+            link = IMAGE_LINKS.search(message)
+            if link:
+                url_loc = message.index(link.group(0))
+                url = message[url_loc:]
+                message = message.replace(link.group(0), " ")
+
         if state == "away":
-            msg = "{} is currently away and has set the following message: `{}`".format(
-                author.display_name, message
-            )
+            msg = f"{author.display_name} is currently away"
         elif state == "idle":
-            msg = "{} is currently away and has set the following message: `{}`".format(
-                author.display_name, message
-            )
+            msg = f"{author.display_name} is currently idle"
         elif state == "dnd":
-            msg = "{} is currently away and has set the following message: `{}`".format(
-                author.display_name, message
-            )
+            msg = f"{author.display_name} is currently do not disturb"
         elif state == "offline":
-            msg = "{} is currently away and has set the following message: `{}`".format(
-                author.display_name, message
-            )
+            msg = f"{author.display_name} is currently offline"
         elif state == "gaming":
-            msg = "{} is currently playing {} and has set the following message: `{}`".format(
-                author.display_name, author.activity.name, message
-            )
+            msg = f"{author.display_name} is currently playing {author.activity.name}"
+        elif state == "gamingcustom":
+            status = [c for c in author.activities if c.type == discord.ActivityType.playing]
+            msg = f"{author.display_name} is currently playing {status[0].name}"
         elif state == "listening":
-            artist_title = f"{author.activity.title} by " + ", ".join(
-                a for a in author.activity.artists
-            )
+            artist_title = f"{author.activity.title} by " + ", ".join(a for a in author.activity.artists)
             currently_playing = self._draw_play(author.activity)
-            msg = "{} is currently listening to {} and has set the following message: `{}`\n{}".format(
-                author.display_name, artist_title, message, currently_playing
-            )
+            msg = f"{author.display_name} is currently listening to {artist_title}\n{currently_playing}"
+        elif state == "listeningcustom":
+            status = [c for c in author.activities if c.type == discord.ActivityType.listening]
+            artist_title = f"{status[0].title} by " + ", ".join(a for a in status[0].artists)
+            currently_playing = self._draw_play(status[0])
+            msg = f"{author.display_name} is currently listening to {artist_title}\n{currently_playing}"
         elif state == "streaming":
-            msg = "{} is currently streaming at {} and has set the following message: `{}`".format(
-                author.display_name, author.activity.url, message
-            )
+            msg = f"{author.display_name} is currently streaming at {author.activity.url}"
+        elif state == "streamingcustom":
+            status = [c for c in author.activities if c.type == discord.ActivityType.streaming]
+            msg = f"{author.display_name} is currently streaming at {status[0].url}"
         else:
-            msg = "{} is currently away".format(author.display_name)
+            msg = f"{author.display_name} is currently away"
+
+        if message and state != "listeningcustom":
+            msg += f" and has set the following message: `{message.rstrip()}`"
+        elif message and state == "listeningcustom":
+            msg += f"\n\nCustom message: `{message.rstrip()}`"
+
+        if url:
+            msg += f"\n{url}"
         return msg
 
     async def is_mod_or_admin(self, member: discord.Member):
@@ -189,7 +235,7 @@ class Away(BaseCog):
             return True
         return False
 
-    @listener()
+    @commands.Cog.listener()
     async def on_message(self, message):
         tmp = {}
         guild = message.guild
@@ -203,95 +249,139 @@ class Away(BaseCog):
         if message.author.bot:
             return
 
+        bl_members = await self._away.guild(guild).BLACKLISTED_MEMBERS()
         for author in message.mentions:
-            if guild.id in list_of_guilds_ign and not await self.is_mod_or_admin(author):
+            if (guild.id in list_of_guilds_ign and not await self.is_mod_or_admin(author)) or author.id in bl_members:
                 continue
-            away_msg = await self._away.user(author).MESSAGE()
+            user_data = await self._away.user(author).all()
+            text_only = await self._away.guild(guild).TEXT_ONLY()
+            embed_links = message.channel.permissions_for(guild.me).embed_links
+
+            away_msg = user_data["MESSAGE"]
             if away_msg:
                 if type(away_msg) in [tuple, list]:
                     # This is just to keep backwards compatibility
                     away_msg, delete_after = away_msg
                 else:
                     delete_after = None
-                if message.channel.permissions_for(guild.me).embed_links:
+                if embed_links and not text_only:
                     em = await self.make_embed_message(author, away_msg, "away")
                     await message.channel.send(embed=em, delete_after=delete_after)
-                else:
+                elif (embed_links and text_only) or not embed_links:
                     msg = await self.make_text_message(author, away_msg, "away")
                     await message.channel.send(msg, delete_after=delete_after)
                 continue
-            idle_msg = await self._away.user(author).IDLE_MESSAGE()
+            idle_msg = user_data["IDLE_MESSAGE"]
             if idle_msg and author.status == discord.Status.idle:
                 if type(idle_msg) in [tuple, list]:
                     idle_msg, delete_after = idle_msg
                 else:
                     delete_after = None
-                if message.channel.permissions_for(guild.me).embed_links:
+                if embed_links and not text_only:
                     em = await self.make_embed_message(author, idle_msg, "idle")
                     await message.channel.send(embed=em, delete_after=delete_after)
-                else:
+                elif (embed_links and text_only) or not embed_links:
                     msg = await self.make_text_message(author, idle_msg, "idle")
                     await message.channel.send(msg, delete_after=delete_after)
                 continue
-            dnd_msg = await self._away.user(author).DND_MESSAGE()
+            dnd_msg = user_data["DND_MESSAGE"]
             if dnd_msg and author.status == discord.Status.dnd:
                 if type(dnd_msg) in [tuple, list]:
                     dnd_msg, delete_after = dnd_msg
                 else:
                     delete_after = None
-                if message.channel.permissions_for(guild.me).embed_links:
+                if embed_links and not text_only:
                     em = await self.make_embed_message(author, dnd_msg, "dnd")
                     await message.channel.send(embed=em, delete_after=delete_after)
-                else:
+                elif (embed_links and text_only) or not embed_links:
                     msg = await self.make_text_message(author, dnd_msg, "dnd")
                     await message.channel.send(msg, delete_after=delete_after)
                 continue
-            offline_msg = await self._away.user(author).OFFLINE_MESSAGE()
+            offline_msg = user_data["OFFLINE_MESSAGE"]
             if offline_msg and author.status == discord.Status.offline:
                 if type(offline_msg) in [tuple, list]:
                     offline_msg, delete_after = offline_msg
                 else:
                     delete_after = None
-                if message.channel.permissions_for(guild.me).embed_links:
+                if embed_links and not text_only:
                     em = await self.make_embed_message(author, offline_msg, "offline")
                     await message.channel.send(embed=em, delete_after=delete_after)
-                else:
+                elif (embed_links and text_only) or not embed_links:
                     msg = await self.make_text_message(author, offline_msg, "offline")
                     await message.channel.send(msg, delete_after=delete_after)
                 continue
-            streaming_msg = await self._away.user(author).STREAMING_MESSAGE()
+            streaming_msg = user_data["STREAMING_MESSAGE"]
             if streaming_msg and type(author.activity) is discord.Streaming:
                 streaming_msg, delete_after = streaming_msg
-                if message.channel.permissions_for(guild.me).embed_links:
+                if embed_links and not text_only:
                     em = await self.make_embed_message(author, streaming_msg, "streaming")
                     await message.channel.send(embed=em, delete_after=delete_after)
-                else:
+                elif (embed_links and text_only) or not embed_links:
                     msg = await self.make_text_message(author, streaming_msg, "streaming")
                     await message.channel.send(msg, delete_after=delete_after)
                 continue
-            listening_msg = await self._away.user(author).LISTENING_MESSAGE()
+            if streaming_msg and type(author.activity) is discord.CustomActivity:
+                stream_status = [c for c in author.activities if c.type == discord.ActivityType.streaming]
+                if not stream_status:
+                    continue
+                streaming_msg, delete_after = streaming_msg
+                if embed_links and not text_only:
+                    em = await self.make_embed_message(author, streaming_msg, "streamingcustom")
+                    await message.channel.send(embed=em, delete_after=delete_after)
+                elif (embed_links and text_only) or not embed_links:
+                    msg = await self.make_text_message(author, streaming_msg, "streamingcustom")
+                    await message.channel.send(msg, delete_after=delete_after)
+                continue
+            listening_msg = user_data["LISTENING_MESSAGE"]
             if listening_msg and type(author.activity) is discord.Spotify:
                 listening_msg, delete_after = listening_msg
-                if message.channel.permissions_for(guild.me).embed_links:
+                if embed_links and not text_only:
                     em = await self.make_embed_message(author, listening_msg, "listening")
                     await message.channel.send(embed=em, delete_after=delete_after)
-                else:
+                elif (embed_links and text_only) or not embed_links:
                     msg = await self.make_text_message(author, listening_msg, "listening")
                     await message.channel.send(msg, delete_after=delete_after)
                 continue
-            gaming_msgs = await self._away.user(author).GAME_MESSAGE()
+            if listening_msg and type(author.activity) is discord.CustomActivity:
+                listening_status = [c for c in author.activities if c.type == discord.ActivityType.listening]
+                if not listening_status:
+                    continue
+                listening_msg, delete_after = listening_msg
+                if embed_links and not text_only:
+                    em = await self.make_embed_message(author, listening_msg, "listeningcustom")
+                    await message.channel.send(embed=em, delete_after=delete_after)
+                elif (embed_links and text_only) or not embed_links:
+                    msg = await self.make_text_message(author, listening_msg, "listeningcustom")
+                    await message.channel.send(msg, delete_after=delete_after)
+                continue
+            gaming_msgs = user_data["GAME_MESSAGE"]
             if gaming_msgs and type(author.activity) in [discord.Game, discord.Activity]:
                 for game in gaming_msgs:
                     if game in author.activity.name.lower():
                         game_msg, delete_after = gaming_msgs[game]
-                        if message.channel.permissions_for(guild.me).embed_links:
+                        if embed_links and not text_only:
                             em = await self.make_embed_message(author, game_msg, "gaming")
                             await message.channel.send(embed=em, delete_after=delete_after)
                             break  # Let's not accidentally post more than one
-                        else:
+                        elif (embed_links and text_only) or not embed_links:
                             msg = await self.make_text_message(author, game_msg, "gaming")
                             await message.channel.send(msg, delete_after=delete_after)
                             break
+            if gaming_msgs and type(author.activity) is discord.CustomActivity:
+                game_status = [c for c in author.activities if c.type == discord.ActivityType.playing]
+                if not game_status:
+                    continue
+                for game in gaming_msgs:
+                    if game in game_status[0].name.lower():
+                        game_msg, delete_after = gaming_msgs[game]
+                        if embed_links and not text_only:
+                            em = await self.make_embed_message(author, game_msg, "gamingcustom")
+                            await message.channel.send(embed=em, delete_after=delete_after)
+                            break  # Let's not accidentally post more than one
+                        elif (embed_links and text_only) or not embed_links:
+                            msg = await self.make_text_message(author, game_msg, "gamingcustom")
+                            await message.channel.send(msg, delete_after=delete_after)
+                            break
 
     @commands.command(name="away")
     async def away_(self, ctx, delete_after: Optional[int] = None, *, message: str = None):
@@ -307,9 +397,17 @@ class Away(BaseCog):
             await self._away.user(author).MESSAGE.set(False)
             msg = "You're now back."
         else:
-            if message is None:
+            if message is None and len(ctx.message.attachments) == 0:
                 await self._away.user(author).MESSAGE.set((" ", delete_after))
             else:
+                if len(ctx.message.attachments) > 0:
+                    link = IMAGE_LINKS.search(ctx.message.attachments[0].url)
+                    url = link.group(0)
+                    if link:
+                        if message:
+                            message = f"{message} {url}"
+                        else:
+                            message = url
                 await self._away.user(author).MESSAGE.set((message, delete_after))
             msg = "You're now set as away."
         await ctx.send(msg)
@@ -318,7 +416,7 @@ class Away(BaseCog):
     async def idle_(self, ctx, delete_after: Optional[int] = None, *, message: str = None):
         """
         Set an automatic reply when you're idle.
-        
+
         `delete_after` Optional seconds to delete the automatic reply
         `message` The custom message to display when you're mentioned
         """
@@ -339,7 +437,7 @@ class Away(BaseCog):
     async def offline_(self, ctx, delete_after: Optional[int] = None, *, message: str = None):
         """
         Set an automatic reply when you're offline.
-        
+
         `delete_after` Optional seconds to delete the automatic reply
         `message` The custom message to display when you're mentioned
         """
@@ -413,46 +511,57 @@ class Away(BaseCog):
             msg = "The bot will no longer reply for you when you're mentioned while listening to Spotify."
         else:
             await self._away.user(author).LISTENING_MESSAGE.set((message, delete_after))
-            msg = (
-                "The bot will now reply for you when you're mentioned while listening to Spotify."
-            )
+            msg = "The bot will now reply for you when you're mentioned while listening to Spotify."
         await ctx.send(msg)
 
     @commands.command(name="gaming")
-    async def gaming_(
-        self, ctx, game: str, delete_after: Optional[int] = None, *, message: str = None
-    ):
+    async def gaming_(self, ctx, game: str, delete_after: Optional[int] = None, *, message: str = None):
         """
         Set an automatic reply when you're playing a specified game.
-        
+
         `game` The game you would like automatic responses for
         `delete_after` Optional seconds to delete the automatic reply
         `message` The custom message to display when you're mentioned
+
+        Use "double quotes" around a game's name if it is more than one word.
         """
         author = ctx.message.author
         mess = await self._away.user(author).GAME_MESSAGE()
         if game.lower() in mess:
             del mess[game.lower()]
             await self._away.user(author).GAME_MESSAGE.set(mess)
-            msg = "The bot will no longer reply for you when you're playing {}.".format(game)
+            msg = f"The bot will no longer reply for you when you're playing {game}."
         else:
             if message is None:
                 mess[game.lower()] = (" ", delete_after)
             else:
                 mess[game.lower()] = (message, delete_after)
             await self._away.user(author).GAME_MESSAGE.set(mess)
-            msg = "The bot will now reply for you when you're playing {}.".format(game)
+            msg = f"The bot will now reply for you when you're playing {game}."
         await ctx.send(msg)
 
     @commands.command(name="toggleaway")
     @checks.admin_or_permissions(administrator=True)
-    async def _ignore(self, ctx):
+    async def _ignore(self, ctx, member: discord.Member=None):
         """
-        Toggle away messages on the whole server.
-        
+        Toggle away messages on the whole server or a specific guild member.
+
         Mods, Admins and Bot Owner are immune to this.
         """
         guild = ctx.message.guild
+        if member:
+            bl_mems = await self._away.guild(guild).BLACKLISTED_MEMBERS()
+            if member.id not in bl_mems:
+                bl_mems.append(member.id)
+                await self._away.guild(guild).BLACKLISTED_MEMBERS.set(bl_mems)
+                msg = f"Away messages will not appear when {member.display_name} is mentioned in this guild."
+                await ctx.send(msg)
+            elif member.id in bl_mems:
+                bl_mems.remove(member.id)
+                await self._away.guild(guild).BLACKLISTED_MEMBERS.set(bl_mems)
+                msg = f"Away messages will appear when {member.display_name} is mentioned in this guild."
+                await ctx.send(msg)
+            return
         if guild.id in (await self._away.ign_servers()):
             guilds = await self._away.ign_servers()
             guilds.remove(guild.id)
@@ -465,6 +574,24 @@ class Away(BaseCog):
             message = "Ignoring this guild."
         await ctx.send(message)
 
+    @commands.command()
+    @checks.admin_or_permissions(administrator=True)
+    async def awaytextonly(self, ctx):
+        """
+        Toggle forcing the guild's away messages to be text only.
+
+        This overrides the embed_links check this cog uses for message sending.
+        """
+        text_only = await self._away.guild(ctx.guild).TEXT_ONLY()
+        if text_only:
+            message = "Away messages will now be embedded or text only based on the bot's permissions for embed links."
+        else:
+            message = (
+                "Away messages are now forced to be text only, regardless of the bot's permissions for embed links."
+            )
+        await self._away.guild(ctx.guild).TEXT_ONLY.set(not text_only)
+        await ctx.send(message)
+
     @commands.command(name="awaysettings", aliases=["awayset"])
     async def away_settings(self, ctx):
         """View your current away settings"""
@@ -513,9 +640,7 @@ class Away(BaseCog):
 
         if ctx.channel.permissions_for(ctx.me).embed_links:
             em = discord.Embed(description=msg[:2048], color=author.color)
-            em.set_author(
-                name=f"{author.display_name}'s away settings", icon_url=author.avatar_url
-            )
+            em.set_author(name=f"{author.display_name}'s away settings", icon_url=author.avatar_url)
             await ctx.send(embed=em)
         else:
             await ctx.send(f"{author.display_name} away settings\n" + msg)

away/info.json

@@ -8,5 +8,6 @@
 	"tags": [
 		"away"
 	],
-	"type": "COG"
+	"type": "COG",
+	"end_user_data_statement": "This cog stores data provided by users for the express purpose of redisplaying. It does not store user data which was not provided through a command. Users may remove their own content without making a data removal request. This cog does not support data requests, but will respect deletion requests."
 }

blurplefy/__init__.py

@@ -1,5 +1,7 @@
 from .blurplefy import Blurplefy
 
+__red_end_user_data_statement__ = "This cog does not persistently store data or metadata about users."
+
 
 def setup(bot):
     bot.add_cog(Blurplefy(bot))

blurplefy/blurplefy.py

@@ -7,7 +7,6 @@ from PIL import Image, ImageEnhance, ImageSequence
 from io import BytesIO
 import aiohttp
 import asyncio
-import copy
 import datetime
 import io
 import math
@@ -15,14 +14,20 @@ from resizeimage import resizeimage
 from redbot.core import Config, commands, checks
 
 blurple = (114, 137, 218)
-blurplehex = 0x7289da
+blurplehex = 0x7289DA
 darkblurple = (78, 93, 148)
 white = (255, 255, 255)
 
 
 class Blurplefy(commands.Cog):
+    """Blurplefy images and check blurple content of images."""
+
+    async def red_delete_data_for_user(self, **kwargs):
+        """ Nothing to delete """
+        return
+
     def __init__(self, bot):
-        """Blurplefy images and check content of images."""
+        """Blurplefy images and check blurple content of images."""
         self.bot = bot
         self.config = Config.get_conf(self, 2778931480, force_registration=True)
 
@@ -38,9 +43,7 @@ class Blurplefy(commands.Cog):
         """Toggle a role award for having a blurple profile picture."""
         blurple_role_id = await self.config.guild(ctx.guild).blurple_role()
         if blurple_role_id is None:
-            await ctx.send(
-                "Enter the role name to award: it needs to be a valid, already existing role."
-            )
+            await ctx.send("Enter the role name to award: it needs to be a valid, already existing role.")
 
             def check(m):
                 return m.author == ctx.author
@@ -140,11 +143,7 @@ class Blurplefy(commands.Cog):
             im = resizeimage.resize_width(im, (imsize[0] * downsizefraction))
             imsize = list(im.size)
             impixels = imsize[0] * imsize[1]
-            await ctx.send(
-                "{}, image resized smaller for easier processing.".format(
-                    ctx.message.author.display_name
-                )
-            )
+            await ctx.send("{}, image resized smaller for easier processing.".format(ctx.message.author.display_name))
 
         image = self.blurple_imager(im, imsize)
         image = discord.File(fp=image, filename="image.png")
@@ -155,19 +154,11 @@ class Blurplefy(commands.Cog):
         percentwhite = round(((noofwhitepixels / noofpixels) * 100), 2)
 
         embed = discord.Embed(title="", colour=0x7289DA)
+        embed.add_field(name="Total amount of Blurple", value="{}%".format(blurplenesspercentage), inline=False)
+        embed.add_field(name="Blurple (rgb(114, 137, 218))", value="{}%".format(percentblurple), inline=True)
+        embed.add_field(name="White (rgb(255, 255, 255))", value="{}\%".format(percentwhite), inline=True)
         embed.add_field(
-            name="Total amount of Blurple", value="{}%".format(blurplenesspercentage), inline=False
-        )
-        embed.add_field(
-            name="Blurple (rgb(114, 137, 218))", value="{}%".format(percentblurple), inline=True
-        )
-        embed.add_field(
-            name="White (rgb(255, 255, 255))", value="{}\%".format(percentwhite), inline=True
-        )
-        embed.add_field(
-            name="Dark Blurple (rgb(78, 93, 148))",
-            value="{}\%".format(percentdblurple),
-            inline=True,
+            name="Dark Blurple (rgb(78, 93, 148))", value="{}\%".format(percentdblurple), inline=True,
         )
         embed.add_field(
             name="Guide",
@@ -247,20 +238,14 @@ class Blurplefy(commands.Cog):
         except Exception:
             isgif = False
 
-        await ctx.send(
-            "{}, image fetched, analyzing image...".format(ctx.message.author.display_name)
-        )
+        await ctx.send("{}, image fetched, analyzing image...".format(ctx.message.author.display_name))
 
         if impixels > maxpixelcount:
             downsizefraction = math.sqrt(maxpixelcount / impixels)
             im = resizeimage.resize_width(im, (imsize[0] * downsizefraction))
             imsize = list(im.size)
             impixels = imsize[0] * imsize[1]
-            await ctx.send(
-                "{}, image resized smaller for easier processing".format(
-                    ctx.message.author.display_name
-                )
-            )
+            await ctx.send("{}, image resized smaller for easier processing".format(ctx.message.author.display_name))
 
         if isgif is False:
             image = self.imager(im, imsize)
@@ -323,9 +308,7 @@ class Blurplefy(commands.Cog):
                 for i in range(3):
                     if not (blurple[i] + colourbuffer > pixel[i] > blurple[i] - colourbuffer):
                         checkblurple = 0
-                    if not (
-                        darkblurple[i] + colourbuffer > pixel[i] > darkblurple[i] - colourbuffer
-                    ):
+                    if not (darkblurple[i] + colourbuffer > pixel[i] > darkblurple[i] - colourbuffer):
                         checkdarkblurple = 0
                     if not (white[i] + colourbuffer > pixel[i] > white[i] - colourbuffer):
                         checkwhite = 0
@@ -396,21 +379,13 @@ class Blurplefy(commands.Cog):
 
     @commands.command()
     async def countdown(self, ctx):
-        """Countdown to Discord's 5th Anniversary."""
-        embed = discord.Embed(name="", colour=0x7289da)
-        timeleft = (
-            datetime.datetime(2019, 5, 13)
-            + datetime.timedelta(hours=7)
-            - datetime.datetime.utcnow()
-        )
-        embed.set_author(name="Time left until Discord's 5th Anniversary")
+        """Countdown to Discord's 6th Anniversary."""
+        embed = discord.Embed(name="", colour=0x7289DA)
+        timeleft = datetime.datetime(2020, 5, 13) + datetime.timedelta(hours=7) - datetime.datetime.utcnow()
+        embed.set_author(name="Time left until Discord's 6th Anniversary")
         if int(timeleft.total_seconds()) < 0:
-            timeleft = (
-                datetime.datetime(2020, 5, 13)
-                + datetime.timedelta(hours=7)
-                - datetime.datetime.utcnow()
-            )
-            embed.set_author(name="Time left until Discord's 5th Anniversary")
+            timeleft = datetime.datetime(2021, 5, 13) + datetime.timedelta(hours=7) - datetime.datetime.utcnow()
+            embed.set_author(name="Time left until Discord's 6th Anniversary")
         embed.add_field(
             name="Countdown to midnight, May 13, California time (UTC-7):",
             value=("{}".format(self._dynamic_time(int(timeleft.total_seconds())))),

blurplefy/info.json

@@ -9,7 +9,7 @@
 		"manage_roles"
 	],
 	"requirements": [
-		"pillow==5.2.0",
+		"pillow",
 		"python-resize-image"
 	],
 	"short": "Blurplefy a user profile picture or image.",
@@ -18,5 +18,6 @@
         "image",
         "profile"
 	],
-	"type": "COG"
-}
+	"type": "COG",
+	"end_user_data_statement": "This cog does not persistently store data or metadata about users."
+}

cah/__init__.py

@@ -1,5 +1,7 @@
 from .cah import CardsAgainstHumanity
 
+__red_end_user_data_statement__ = "This cog does not persistently store data or metadata about users."
+
 
 def setup(bot):
     bot.add_cog(CardsAgainstHumanity(bot))

cah/info.json

@@ -14,5 +14,6 @@
         "cards",
         "games"
 	],
-	"type": "COG"
+	"type": "COG",
+	"end_user_data_statement": "This cog does not persistently store data or metadata about users."
 }

chatchart/__init__.py

@@ -1,5 +1,7 @@
 from .chatchart import Chatchart
 
+__red_end_user_data_statement__ = "This cog does not persistently store data or metadata about users."
+
 
 def setup(bot):
     bot.add_cog(Chatchart(bot))

chatchart/chatchart.py

@@ -1,30 +1,42 @@
-#  Lines 72 through 90 are influenced heavily by cacobot's stats module:
+#  This cog is influenced heavily by cacobot's stats module:
 #  https://github.com/Orangestar12/cacobot/blob/master/cacobot/stats.py
 #  Big thanks to Redjumpman for changing the beta version from
 #  Imagemagick/cairosvg to matplotlib.
 #  Thanks to violetnyte for suggesting this cog.
+
+import asyncio
 import discord
 import heapq
-import os
 from io import BytesIO
+from typing import Optional
+
 import matplotlib
 
 matplotlib.use("agg")
 import matplotlib.pyplot as plt
 
 plt.switch_backend("agg")
-from redbot.core import commands
+
+from redbot.core import commands, Config
 
 
-BaseCog = getattr(commands, "Cog", object)
-
-class Chatchart(BaseCog):
+class Chatchart(commands.Cog):
     """Show activity."""
 
+    async def red_delete_data_for_user(self, **kwargs):
+        """ Nothing to delete """
+        return
+
     def __init__(self, bot):
         self.bot = bot
+        self.config = Config.get_conf(self, 2766691001, force_registration=True)
 
-    def create_chart(self, top, others, channel):
+        default_guild = {"channel_deny": []}
+
+        self.config.register_guild(**default_guild)
+
+    @staticmethod
+    async def create_chart(top, others, channel):
         plt.clf()
         sizes = [x[1] for x in top]
         labels = ["{} {:g}%".format(x[0], x[1]) for x in top]
@@ -81,33 +93,55 @@ class Chatchart(BaseCog):
     @commands.guild_only()
     @commands.command()
     @commands.cooldown(1, 10, commands.BucketType.channel)
-    async def chatchart(self, ctx, channel: discord.TextChannel = None, messages=5000):
+    @commands.max_concurrency(1, commands.BucketType.channel)
+    @commands.bot_has_permissions(attach_files=True)
+    async def chatchart(self, ctx, channel: Optional[discord.TextChannel] = None, messages=5000):
         """
         Generates a pie chart, representing the last 5000 messages in the specified channel.
         """
-        e = discord.Embed(description="Loading...", colour=0x00ccff)
-        e.set_thumbnail(url="https://i.imgur.com/vSp4xRk.gif")
+        if channel is None:
+            channel = ctx.channel
+        deny = await self.config.guild(ctx.guild).channel_deny()
+        if channel.id in deny:
+            return await ctx.send(f"I am not allowed to create a chatchart of {channel.mention}.")
+        e = discord.Embed(
+            description="This might take a while...", colour=await self.bot.get_embed_colour(location=channel)
+        )
         em = await ctx.send(embed=e)
 
-        if channel is None:
-            channel = ctx.message.channel
         history = []
+        history_counter = 0
+
         if not channel.permissions_for(ctx.message.author).read_messages == True:
-            await em.delete()
+            try:
+                await em.delete()
+            except discord.NotFound:
+                pass
             return await ctx.send("You're not allowed to access that channel.")
         try:
             async for msg in channel.history(limit=messages):
                 history.append(msg)
+                history_counter += 1
+                await asyncio.sleep(0.005)
+                if history_counter % 250 == 0:
+                    new_embed = discord.Embed(
+                        description=f"This might take a while...\n{history_counter} messages gathered",
+                        colour=await self.bot.get_embed_colour(location=channel),
+                    )
+                    await em.edit(embed=new_embed)
         except discord.errors.Forbidden:
-            await em.delete()
+            try:
+                await em.delete()
+            except discord.NotFound:
+                pass
             return await ctx.send("No permissions to read that channel.")
-        msg_data = {"total count": 0, "users": {}}
 
+        msg_data = {"total count": 0, "users": {}}
         for msg in history:
-            if len(msg.author.name) >= 20:
-                short_name = "{}...".format(msg.author.name[:20]).replace("$", "\$")
+            if len(msg.author.display_name) >= 20:
+                short_name = "{}...".format(msg.author.display_name[:20]).replace("$", "\\$")
             else:
-                short_name = msg.author.name.replace("$", "\$")
+                short_name = msg.author.display_name.replace("$", "\\$")
             whole_name = "{}#{}".format(short_name, msg.author.discriminator)
             if msg.author.bot:
                 pass
@@ -119,9 +153,12 @@ class Chatchart(BaseCog):
                 msg_data["users"][whole_name]["msgcount"] = 1
                 msg_data["total count"] += 1
 
-        if msg_data['users'] == {}:
-            await em.delete()
-            return await ctx.message.channel.send(f'Only bots have sent messages in {channel.mention}')
+        if msg_data["users"] == {}:
+            try:
+                await em.delete()
+            except discord.NotFound:
+                pass
+            return await ctx.send(f"Only bots have sent messages in {channel.mention} or I can't read message history.")
 
         for usr in msg_data["users"]:
             pd = float(msg_data["users"][usr]["msgcount"]) / float(msg_data["total count"])
@@ -133,11 +170,58 @@ class Chatchart(BaseCog):
                 (x, msg_data["users"][x][y])
                 for x in msg_data["users"]
                 for y in msg_data["users"][x]
-                if y == "percent"
+                if (y == "percent" and msg_data["users"][x][y] > 0)
             ],
             key=lambda x: x[1],
         )
         others = 100 - sum(x[1] for x in top_ten)
-        img = self.create_chart(top_ten, others, channel)
-        await em.delete()
-        await ctx.message.channel.send(file=discord.File(img, "chart.png"))
+        chart = await self.create_chart(top_ten, others, channel)
+
+        try:
+            await em.delete()
+        except discord.NotFound:
+            pass
+        await ctx.send(file=discord.File(chart, "chart.png"))
+
+    @commands.command()
+    async def ccdeny(self, ctx, channel: discord.TextChannel):
+        """Add a channel to deny chatchart use."""
+        channel_list = await self.config.guild(ctx.guild).channel_deny()
+        if channel.id not in channel_list:
+            channel_list.append(channel.id)
+        await self.config.guild(ctx.guild).channel_deny.set(channel_list)
+        await ctx.send(f"{channel.mention} was added to the deny list for chatchart.")
+
+    @commands.command()
+    async def ccdenylist(self, ctx):
+        """List the channels that are denied."""
+        no_channels_msg = "Chatchart is currently allowed everywhere in this server."
+        channel_list = await self.config.guild(ctx.guild).channel_deny()
+        if not channel_list:
+            msg = no_channels_msg
+        else:
+            msg = "Chatchart is not allowed in:\n"
+            remove_list = []
+            for channel in channel_list:
+                channel_obj = self.bot.get_channel(channel)
+                if not channel_obj:
+                    remove_list.append(channel)
+                else:
+                    msg += f"{channel_obj.mention}\n"
+            if remove_list:
+                new_list = [x for x in channel_list if x not in remove_list]
+                await self.config.guild(ctx.guild).channel_deny.set(new_list)
+                if len(remove_list) == len(channel_list):
+                    msg = no_channels_msg
+        await ctx.send(msg)
+
+    @commands.command()
+    async def ccallow(self, ctx, channel: discord.TextChannel):
+        """Remove a channel from the deny list to allow chatchart use."""
+        channel_list = await self.config.guild(ctx.guild).channel_deny()
+        if channel.id in channel_list:
+            channel_list.remove(channel.id)
+        else:
+            return await ctx.send("Channel is not on the deny list.")
+        await self.config.guild(ctx.guild).channel_deny.set(channel_list)
+        await ctx.send(f"{channel.mention} will be allowed for chatchart use.")

chatchart/info.json

@@ -14,5 +14,6 @@
 	"requirements": [
 		"matplotlib"
 	],
-	"type": "COG"
+	"type": "COG",
+	"end_user_data_statement": "This cog does not persistently store data or metadata about users."
 }

dadjokes/__init__.py

@@ -1,5 +1,7 @@
 from .dadjokes import DadJokes
 
+__red_end_user_data_statement__ = "This cog does not persistently store data or metadata about users."
+
 
 def setup(bot):
     bot.add_cog(DadJokes(bot))

dadjokes/dadjokes.py

@@ -1,16 +1,21 @@
 from redbot.core import commands
 import aiohttp
 
+
 class DadJokes(commands.Cog):
     """Random dad jokes from icanhazdadjoke.com"""
 
+    async def red_delete_data_for_user(self, **kwargs):
+        """ Nothing to delete """
+        return
+
     def __init__(self, bot):
         self.bot = bot
 
     @commands.command()
     async def dadjoke(self, ctx):
         """Gets a random dad joke."""
-        api = 'https://icanhazdadjoke.com/'
-        async with aiohttp.request('GET', api, headers={'Accept': 'text/plain'}) as r:
+        api = "https://icanhazdadjoke.com/"
+        async with aiohttp.request("GET", api, headers={"Accept": "text/plain"}) as r:
             result = await r.text()
             await ctx.send(f"`{result}`")

dadjokes/info.json

@@ -6,5 +6,6 @@
     "install_msg": "Gets a random dad joke from icanhazdadjoke.com. Thanks for installing.",
 	"short": "Random dad jokes",
 	"tags": ["jokes", "dad", "dadjokes"],
-	"type": "COG"
+	"type": "COG",
+	"end_user_data_statement": "This cog does not persistently store data or metadata about users."
 }

dictionary/__init__.py

@@ -1,5 +1,7 @@
 from .dictionary import Dictionary
 
+__red_end_user_data_statement__ = "This cog does not persistently store data or metadata about users."
+
 
 def setup(bot):
     bot.add_cog(Dictionary(bot))

dictionary/dictionary.py

@@ -1,13 +1,22 @@
 import aiohttp
 from bs4 import BeautifulSoup
+import logging
 import re
 from redbot.core import commands
+from redbot.core.utils.chat_formatting import pagify
+
+
+log = logging.getLogger("red.aikaterna.dictionary")
 
 
 class Dictionary(commands.Cog):
     """Word, yo
     Parts of this cog are adapted from the PyDictionary library."""
 
+    async def red_delete_data_for_user(self, **kwargs):
+        """ Nothing to delete """
+        return
+
     def __init__(self, bot):
         self.bot = bot
         self.session = aiohttp.ClientSession()
@@ -19,25 +28,29 @@ class Dictionary(commands.Cog):
         try:
             async with self.session.request("GET", url) as response:
                 return BeautifulSoup(await response.text(), "html.parser")
-        except Exception as e:
-            print(e)
-            return
+        except Exception:
+            log.error("Error fetching dictionary.py related webpage", exc_info=True)
+            return None
 
     @commands.command()
     async def antonym(self, ctx, *, word: str):
         """Displays antonyms for a given word."""
-        search_msg = await ctx.send("Searching...")
         search_term = word.split(" ", 1)[0]
         result = await self._antonym(ctx, search_term)
         if not result:
-            return await search_msg.edit(content="This word is not in the dictionary.")
+            await ctx.send("This word is not in the dictionary.")
+            return 
 
         result_text = "*, *".join(result)
-        await search_msg.edit(content=f"Antonyms for **{search_term}**: *{result_text}*")
+        msg = f"Antonyms for **{search_term}**: *{result_text}*"
+        for page in pagify(msg, delims=["\n"]):
+            await ctx.send(page)
 
     async def _antonym(self, ctx, word):
         data = await self._get_soup_object(f"http://www.thesaurus.com/browse/{word}")
-        section = data.find_all("ul", {"class": "css-1lc0dpe et6tpn80"})
+        if not data:
+            return await ctx.send("Error fetching data.")
+        section = data.find_all("ul", {"class": "css-1ytlws2 et6tpn80"})
         try:
             section[1]
         except IndexError:
@@ -54,7 +67,9 @@ class Dictionary(commands.Cog):
         result = await self._definition(ctx, search_term)
         str_buffer = ""
         if not result:
-            return await search_msg.edit(content="This word is not in the dictionary.")
+            await search_msg.delete()
+            await ctx.send("This word is not in the dictionary.")
+            return
         for key in result:
             str_buffer += f"\n**{key}**: \n"
             counter = 1
@@ -71,13 +86,17 @@ class Dictionary(commands.Cog):
                     else:
                         str_buffer += f"{str(counter)}. {val}\n"
                         counter += 1
-        await search_msg.edit(content=str_buffer)
+        await search_msg.delete()
+        for page in pagify(str_buffer, delims=["\n"]):
+            await ctx.send(page)
 
     async def _definition(self, ctx, word):
-        html = await self._get_soup_object(f"http://wordnetweb.princeton.edu/perl/webwn?s={word}")
-        types = html.findAll("h3")
+        data = await self._get_soup_object(f"http://wordnetweb.princeton.edu/perl/webwn?s={word}")
+        if not data:
+            return await ctx.send("Error fetching data.")
+        types = data.findAll("h3")
         length = len(types)
-        lists = html.findAll("ul")
+        lists = data.findAll("ul")
         out = {}
         if not lists:
             return
@@ -95,7 +114,9 @@ class Dictionary(commands.Cog):
 
     async def _synonym(self, ctx, word):
         data = await self._get_soup_object(f"http://www.thesaurus.com/browse/{word}")
-        section = data.find_all("ul", {"class": "css-1lc0dpe et6tpn80"})
+        if not data:
+            return await ctx.send("Error fetching data.")
+        section = data.find_all("ul", {"class": "css-1ytlws2 et6tpn80"})
         try:
             section[1]
         except IndexError:
@@ -107,11 +128,13 @@ class Dictionary(commands.Cog):
     @commands.command()
     async def synonym(self, ctx, *, word: str):
         """Displays synonyms for a given word."""
-        search_msg = await ctx.send("Searching...")
         search_term = word.split(" ", 1)[0]
         result = await self._synonym(ctx, search_term)
         if not result:
-            return await search_msg.edit(content="This word is not in the dictionary.")
+            await ctx.send("This word is not in the dictionary.")
+            return
 
         result_text = "*, *".join(result)
-        await search_msg.edit(content=f"Synonyms for **{search_term}**: *{result_text}*")
+        msg = f"Synonyms for **{search_term}**: *{result_text}*"
+        for page in pagify(msg, delims=["\n"]):
+            await ctx.send(page)

dictionary/info.json

@@ -11,5 +11,6 @@
 	"requirements": [
 		"beautifulsoup4"
 	],
-	"type": "COG"
+	"type": "COG",
+	"end_user_data_statement": "This cog does not persistently store data or metadata about users."
 }

dungeon/__init__.py

@@ -1,5 +1,9 @@
 from .dungeon import Dungeon
 
+__red_end_user_data_statement__ = (
+    "This cog does not persistently store end user data. " "This cog does store discord IDs as needed for operation. "
+)
+
 
 def setup(bot):
     bot.add_cog(Dungeon(bot))

dungeon/dungeon.py

@@ -1,12 +1,32 @@
-import asyncio
 import datetime
+from typing import Literal
+
 import discord
+import logging
 from redbot.core import Config, commands, checks, modlog
+from redbot.core.utils.chat_formatting import box, pagify
+
+
+log = logging.getLogger("red.aikaterna.dungeon")
 
 
 class Dungeon(commands.Cog):
     """Auto-quarantine suspicious users."""
 
+    async def red_delete_data_for_user(
+        self, *, requester: Literal["discord", "owner", "user", "user_strict"], user_id: int,
+    ):
+        if requester == "discord":
+            # user is deleted, just comply
+
+            data = await self.config.all_guilds()
+            for guild_id, guild_data in data.items():
+                if user_id in guild_data.get("bypass", []):
+                    bypass = guild_data.get("bypass", [])
+                    bypass = set(bypass)
+                    bypass.discard(user_id)
+                    await self.config.guild_from_id(guild_id).bypass.set(list(bypass))
+
     def __init__(self, bot):
         self.bot = bot
         self.config = Config.get_conf(self, 2700081001, force_registration=True)
@@ -16,6 +36,7 @@ class Dungeon(commands.Cog):
             "auto_ban": False,
             "auto_ban_message": None,
             "auto_blacklist": False,
+            "bypass": [],
             "dm_message": None,
             "dm_toggle": False,
             "dungeon_channel": None,
@@ -41,33 +62,32 @@ class Dungeon(commands.Cog):
         dungeon_role_obj = discord.utils.get(ctx.guild.roles, id=dungeon_role_id)
 
         if blacklist:
-            async with self.bot.db.blacklist() as blacklist_list:
+            # if you are reading this to learn, DON'T do this, there will be a real way
+            # to interact with bot-owned data without touching config directly at some
+            # point in the future after Red 3.2
+            async with self.bot._config.blacklist() as blacklist_list:
                 if user.id not in blacklist_list:
                     blacklist_list.append(user.id)
 
         if not dungeon_role_obj:
             return await ctx.send("No dungeon role set.")
 
+        #Managed roles CANNOT be removed by the bot.
+        remaining_roles = [r for r in user.roles if r.managed]
         try:
-            await user.edit(
-                roles=[], reason=f"Removing all roles, {ctx.message.author} is banishing user"
-            )
+            await user.edit(roles=remaining_roles, reason=f"Removing all roles, {ctx.message.author} is banishing user")
         except discord.Forbidden:
             return await ctx.send(
                 "I need permission to manage roles or the role hierarchy might not allow me to do this. I need a role higher than the person you're trying to banish."
             )
 
-        await user.add_roles(
-            dungeon_role_obj, reason=f"Adding dungeon role, {ctx.message.author} is banishing user"
-        )
+        await user.add_roles(dungeon_role_obj, reason=f"Adding dungeon role, {ctx.message.author} is banishing user")
 
         if blacklist:
             blacklist_msg = ", blacklisted from the bot,"
         else:
             blacklist_msg = ""
-        msg = (
-            f"{user} has been sent to the dungeon{blacklist_msg} and has had all previous roles stripped."
-        )
+        msg = f"{user} has been sent to the dungeon{blacklist_msg} and has had all previous roles stripped."
         await ctx.send(msg)
 
     @commands.group(autohelp=True)
@@ -82,9 +102,7 @@ class Dungeon(commands.Cog):
         """Sets the announcement channel for users moved to the dungeon."""
         await self.config.guild(ctx.guild).announce_channel.set(channel.id)
         announce_channel_id = await self.config.guild(ctx.guild).announce_channel()
-        await ctx.send(
-            f"User announcement channel set to: {self.bot.get_channel(announce_channel_id).mention}."
-        )
+        await ctx.send(f"User announcement channel set to: {self.bot.get_channel(announce_channel_id).mention}.")
 
     @dungeon.command()
     async def autoban(self, ctx):
@@ -99,9 +117,7 @@ class Dungeon(commands.Cog):
         auto_ban = await self.config.guild(ctx.guild).auto_ban()
         if not ban_message:
             await self.config.guild(ctx.guild).auto_ban_message.set(None)
-            return await ctx.send(
-                "Auto-ban message removed. No message will be sent on an auto-ban."
-            )
+            return await ctx.send("Auto-ban message removed. No message will be sent on an auto-ban.")
         await self.config.guild(ctx.guild).auto_ban_message.set(str(ban_message))
         await self.config.guild(ctx.guild).auto_ban.set(True)
         await ctx.send(f"Auto-ban has been turned on.\nMessage to send on ban:\n{ban_message}")
@@ -113,6 +129,35 @@ class Dungeon(commands.Cog):
         await self.config.guild(ctx.guild).auto_blacklist.set(not auto_blacklist)
         await ctx.send(f"Auto-blacklisting dungeon users from the bot: {not auto_blacklist}.")
 
+    @dungeon.command()
+    @commands.cooldown(1, 5, discord.ext.commands.BucketType.guild)
+    async def bypass(self, ctx, user_id: int):
+        """Add a user ID to the bypass list - user will be able to join without restrictions."""
+        if not 17 <= len(str(user_id)) >= 18:
+            return await ctx.send("This doesn't look like a Discord user id.")
+        bypass_ids = await self.config.guild(ctx.guild).bypass()
+        if user_id in bypass_ids:
+            return await ctx.send(f"**{user_id}** is already in the list of bypassed users.")
+        bypass_ids.append(user_id)
+        await self.config.guild(ctx.guild).bypass.set(bypass_ids)
+        bypassed_user = await self.bot.fetch_user(user_id)
+        await ctx.send(
+            f"**{bypassed_user}** ({user_id}) has been added to the bypass list. The next time they attempt to join this server, they will bypass any Dungeon restrictions."
+        )
+
+    @dungeon.command()
+    @commands.cooldown(1, 5, discord.ext.commands.BucketType.guild)
+    async def bypasslist(self, ctx):
+        """Show the current bypass list."""
+        bypass_ids = await self.config.guild(ctx.guild).bypass()
+        msg = "[Bypassed IDs]\n"
+        if not bypass_ids:
+            msg += "None."
+        for id in bypass_ids:
+            msg += f"{id}\n"
+        for page in pagify(msg, delims=["\n"], page_length=1000):
+            await ctx.send(box(msg, lang="ini"))
+
     @dungeon.command()
     async def channel(self, ctx, channel: discord.TextChannel):
         """Sets the text channel to use for the dungeon."""
@@ -172,7 +217,7 @@ class Dungeon(commands.Cog):
         await ctx.send(f"Default profile pic flagging: {not profile_toggle}.")
 
     @dungeon.command()
-    async def userrole(self, ctx, role_name: discord.Role = None):
+    async def userrole(self, ctx, *, role_name: discord.Role = None):
         """Sets the role to give to new users that are not sent to the dungeon."""
         if not role_name:
             await self.config.guild(ctx.guild).user_role.set(None)
@@ -203,7 +248,10 @@ class Dungeon(commands.Cog):
         dm_message = data["dm_message"]
 
         if blacklist:
-            async with self.bot.db.blacklist() as blacklist_list:
+            # if you are reading this to learn, DON'T do this, there will be a real way
+            # to interact with bot-owned data without touching config directly at some
+            # point in the future after Red 3.2
+            async with self.bot._config.blacklist() as blacklist_list:
                 if user.id in blacklist_list:
                     blacklist_list.remove(user.id)
 
@@ -215,13 +263,10 @@ class Dungeon(commands.Cog):
                 role_check = True
                 try:
                     await user.remove_roles(
-                        dungeon_role_obj,
-                        reason=f"Removing dungeon role, verified by {ctx.message.author}.",
+                        dungeon_role_obj, reason=f"Removing dungeon role, verified by {ctx.message.author}.",
                     )
                     if not user_role_obj:
-                        return await ctx.send(
-                            "Dungeon role removed, but no member role is set so I can't award one."
-                        )
+                        return await ctx.send("Dungeon role removed, but no member role is set so I can't award one.")
                     await user.add_roles(user_role_obj, reason="Adding member role.")
                 except discord.Forbidden:
                     return await ctx.send(
@@ -235,18 +280,14 @@ class Dungeon(commands.Cog):
             blacklist_msg = " and the bot blacklist"
         else:
             blacklist_msg = ""
-        msg = (
-            f"{user} has been removed from the dungeon{blacklist_msg} and now has the initial user role."
-        )
+        msg = f"{user} has been removed from the dungeon{blacklist_msg} and now has the initial user role."
         await ctx.send(msg)
 
         if dm_toggle:
             try:
                 await user.send(dm_message)
             except discord.Forbidden:
-                await ctx.send(
-                    f"I couldn't DM {user} to let them know they've been verified, they've blocked me."
-                )
+                await ctx.send(f"I couldn't DM {user} to let them know they've been verified, they've blocked me.")
 
     @dungeon.command()
     async def autosetup(self, ctx):
@@ -254,11 +295,7 @@ class Dungeon(commands.Cog):
         You must deny the default role (@ everyone) from viewing or typing in other channels in your server manually.
         """
         try:
-            overwrites = {
-                ctx.guild.default_role: discord.PermissionOverwrite(
-                    send_messages=False, read_messages=False
-                )
-            }
+            overwrites = {ctx.guild.default_role: discord.PermissionOverwrite(send_messages=False, read_messages=False)}
 
             dungeon_role = await ctx.guild.create_role(name="Dungeon")
 
@@ -267,9 +304,7 @@ class Dungeon(commands.Cog):
                 dungeon_role, read_messages=True, send_messages=False, read_message_history=True
             )
 
-            dungeon_channel = await ctx.guild.create_text_channel(
-                "Silenced", category=dungeon_category
-            )
+            dungeon_channel = await ctx.guild.create_text_channel("Silenced", category=dungeon_category)
             await dungeon_channel.set_permissions(
                 dungeon_role, read_messages=True, send_messages=False, read_message_history=True
             )
@@ -285,7 +320,7 @@ class Dungeon(commands.Cog):
             if not toggle:
                 await ctx.invoke(self.usertoggle)
             await ctx.send(
-                f"Done.\nDungeon channel created: {dungeon_channel.mention}\nDungeon role created: {dungeon_role.name}\n\nPlease set these items manually:\n- The announce channel for reporting new users that are moved to the dungeon ([p]dungeon announce)\n- The role you wish to award regular members when they join the server ([p]dungeon userrole)\n- The toggle for enabling the regular user role awarding ([p]dungeon usertoggle)"
+                f"Done.\nDungeon channel created: {dungeon_channel.mention}\nDungeon role created: {dungeon_role.name}\n\nPlease set these items manually:\n- The announce channel for reporting new users that are moved to the dungeon ({ctx.prefix}dungeon announce)\n- The role you wish to award regular members when they join the server ({ctx.prefix}dungeon userrole)\n- The toggle for enabling the regular user role awarding ({ctx.prefix}dungeon usertoggle)"
             )
 
         except discord.Forbidden:
@@ -363,16 +398,37 @@ class Dungeon(commands.Cog):
         auto_ban = await self.config.guild(member.guild).auto_ban()
         auto_ban_msg = await self.config.guild(member.guild).auto_ban_message()
         mod_log = await self.config.guild(member.guild).mod_log()
+        bypassed_ids = await self.config.guild(member.guild).bypass()
+
+        if member.id in bypassed_ids:
+            bypassed_ids.remove(member.id)
+            await self.config.guild(member.guild).bypass.set(bypassed_ids)
+            user_role_id = await self.config.guild(member.guild).user_role()
+            user_role_obj = discord.utils.get(member.guild.roles, id=user_role_id)
+            try:
+                await member.add_roles(
+                    user_role_obj, reason="User has bypassed Dungeon checks. Assigning member role.",
+                )
+            except discord.Forbidden:
+                pass
+            except AttributeError:
+                pass
+            bypass_msg = f"**{member}** ({member.id}) was in the bypass list for **{member.guild.name}** ({member.guild.id}). They were allowed to join without Dungeon checks and I have assigned them the Member role specified in the settings, if any."
+            if announce_channel:
+                await channel_object.send(bypass_msg)
+            else:
+                log.debug(f"dungeon.py: {bypass_msg}")
+            return
 
         if (since_join.days < join_days) or (profile_toggle and default_avatar):
+            banned = False
             blacklist = await self.config.guild(member.guild).auto_blacklist()
             dungeon_role_id = await self.config.guild(member.guild).dungeon_role()
             dungeon_role_obj = discord.utils.get(member.guild.roles, id=dungeon_role_id)
-            perm_msg = (
-                f"dungeon.py: Unable to auto-ban user, permissions needed and no announce channel set. Guild: {member.guild.id}"
-            )
+            perm_msg = f"dungeon.py: Unable to auto-ban user, permissions needed and no announce channel set. Guild: {member.guild.id}"
 
             if auto_ban:
+                banned = True
                 if auto_ban_msg:
                     try:
                         await member.send(auto_ban_msg)
@@ -382,51 +438,46 @@ class Dungeon(commands.Cog):
                                 f"I couldn't DM {member} ({member.id}) to let them know they've been banned, they've blocked me."
                             )
                         else:
-                            print(perm_msg)
+                            log.debug(perm_msg)
                             return
                 try:
-                    await member.guild.ban(
-                        member, reason="Dungeon auto-ban", delete_message_days=0
-                    )
+                    await member.guild.ban(member, reason="Dungeon auto-ban", delete_message_days=0)
                 except discord.Forbidden:
                     if announce_channel:
                         return await channel_object.send(
                             f"I tried to auto-ban someone ({member}, {member.id}) but I don't have ban permissions."
                         )
                     else:
-                        print(perm_msg)
+                        log.debug(perm_msg)
                         return
 
                 if not mod_log:
                     if announce_channel:
-                        msg = (
-                            f"Auto-banned new user: \n**{member}** ({member.id})\n{self._dynamic_time(int(since_join.total_seconds()))} old account"
-                        )
+                        msg = f"Auto-banned new user: \n**{member}** ({member.id})\n{self._dynamic_time(int(since_join.total_seconds()))} old account"
                         return await channel_object.send(msg)
                     else:
-                        print(perm_msg)
+                        log.debug(perm_msg)
                         return
                 else:
                     try:
                         await modlog.create_case(
-                            self.bot,
-                            member.guild,
-                            now,
-                            "ban",
-                            member,
-                            member.guild.me,
-                            until=None,
-                            channel=None,
+                            self.bot, member.guild, now, "ban", member, member.guild.me, until=None, channel=None,
                         )
-                    except RuntimeError as e:
-                        print(
-                            f"dungeon.py error while autobanning user and attempting to create modlog entry: {e}\nIn guild: {member.guild.id}"
+                    except RuntimeError:
+                        log.error(
+                            f"dungeon.py error while autobanning user and attempting to create modlog entry in guild: {member.guild.id}",
+                            exc_info=True,
                         )
 
             if blacklist:
-                async with self.bot.db.blacklist() as blacklist_list:
+                # if you are reading this to learn, DON'T do this, there will be a real way
+                # to interact with bot-owned data without touching config directly at some
+                # point in the future after Red 3.2
+                async with self.bot._config.blacklist() as blacklist_list:
                     if member.id not in blacklist_list:
                         blacklist_list.append(member.id)
+            if banned:
+                return
             try:
                 if since_join.days < join_days:
                     reason = "Adding dungeon role, new account."
@@ -439,12 +490,12 @@ class Dungeon(commands.Cog):
                         "Someone suspicious joined but something went wrong. I need permissions to manage channels and manage roles."
                     )
                 else:
-                    print("dungeon.py: I need permissions to manage channels and manage roles.")
+                    log.info(
+                        f"dungeon.py: I need permissions to manage channels and manage roles in {member.guild.name} ({member.guild.id})."
+                    )
                     return
 
-            msg = (
-                f"Auto-banished new user: \n**{member}** ({member.id})\n{self._dynamic_time(int(since_join.total_seconds()))} old account"
-            )
+            msg = f"Auto-banished new user: \n**{member}** ({member.id})\n{self._dynamic_time(int(since_join.total_seconds()))} old account"
             if default_avatar:
                 msg += ", no profile picture set"
             await channel_object.send(msg)

dungeon/info.json

@@ -15,5 +15,6 @@
 		"dungeon",
         "autoban"
 	],
-	"type": "COG"
+	"type": "COG",
+	"end_user_data_statement": "This cog does not persistently store end user data. This cog does store discord IDs as needed for operation. "
 }

hunting/__init__.py

@@ -0,0 +1,14 @@
+from .hunting import Hunting
+
+__red_end_user_data_statement__ = (
+    "This cog does not persistently store end user data. "
+    "This cog does store discord IDs as needed for operation. "
+    "This cog does store user stats for the cog such as their score. "
+    "Users may remove their own content without making a data removal request."
+    "This cog does not support data requests, "
+    "but will respect deletion requests."
+)
+
+
+async def setup(bot):
+    bot.add_cog(Hunting(bot))

hunting/hunting.py

@@ -0,0 +1,394 @@
+from typing import Literal
+
+import asyncio
+import discord
+import datetime
+import math
+import random
+import time
+
+from redbot.core import checks, commands, Config
+from redbot.core.utils.chat_formatting import bold, box, humanize_list, humanize_number, pagify
+from redbot.core.utils.menus import menu, DEFAULT_CONTROLS
+
+
+__version__ = "3.1.4"
+
+
+class Hunting(commands.Cog):
+    """Hunting, it hunts birds and things that fly."""
+
+    async def red_delete_data_for_user(
+        self, *, requester: Literal["discord", "owner", "user", "user_strict"], user_id: int,
+    ):
+        await self.config.user_from_id(user_id).clear()
+
+    def __init__(self, bot):
+        self.bot = bot
+        self.config = Config.get_conf(self, 2784481002, force_registration=True)
+
+        self.animals = {
+            "dove": ":dove: **_Coo!_**",
+            "penguin": ":penguin: **_Noot!_**",
+            "chicken": ":chicken: **_Bah-gawk!_**",
+            "duck": ":duck: **_Quack!_**",
+        }
+        self.in_game = []
+        self.paused_games = []
+        self.next_bang = {}
+        self.game_tasks = []
+
+        default_guild = {
+            "hunt_interval_minimum": 900,
+            "hunt_interval_maximum": 3600,
+            "wait_for_bang_timeout": 20,
+            "channels": [],
+            "bang_time": False,
+            "bang_words": True,
+        }
+        default_user = {"score": {}, "total": 0}
+        self.config.register_user(**default_user)
+        self.config.register_guild(**default_guild)
+
+    @commands.guild_only()
+    @commands.group()
+    async def hunting(self, ctx):
+        """Hunting, it hunts birds and things that fly."""
+        if ctx.invoked_subcommand is None:
+            guild_data = await self.config.guild(ctx.guild).all()
+            if not guild_data["channels"]:
+                channel_names = ["No channels set."]
+            else:
+                channel_names = []
+                for channel_id in guild_data["channels"]:
+                    channel_obj = self.bot.get_channel(channel_id)
+                    channel_names.append(channel_obj.name)
+
+            hunting_mode = "Words" if guild_data["bang_words"] else "Reactions"
+            reaction_time = "On" if guild_data["bang_time"] else "Off"
+
+            msg = f"[Hunting in]:                 {humanize_list(channel_names)}\n"
+            msg += f"[Bang timeout]:               {guild_data['wait_for_bang_timeout']} seconds\n"
+            msg += f"[Hunt interval minimum]:      {guild_data['hunt_interval_minimum']} seconds\n"
+            msg += f"[Hunt interval maximum]:      {guild_data['hunt_interval_maximum']} seconds\n"
+            msg += f"[Hunting mode]:               {hunting_mode}\n"
+            msg += f"[Bang response time message]: {reaction_time}\n"
+
+            for page in pagify(msg, delims=["\n"]):
+                await ctx.send(box(page, lang="ini"))
+
+    @hunting.command()
+    async def leaderboard(self, ctx, global_leaderboard=False):
+        """
+        This will show the top 50 hunters for the server.
+        Use True for the global_leaderboard variable to show the global leaderboard.
+        """
+        userinfo = await self.config._all_from_scope(scope="USER")
+        if not userinfo:
+            return await ctx.send(bold("Please shoot something before you can brag about it."))
+
+        async with ctx.typing():
+            sorted_acc = sorted(userinfo.items(), key=lambda x: (x[1]["total"]), reverse=True)[:50]
+
+        if not hasattr(ctx.guild, "members"):
+            global_leaderboard = True
+
+        pound_len = len(str(len(sorted_acc)))
+        score_len = 10
+        header = "{score:{score_len}}{name:2}\n".format(
+            score="# Birds Shot",
+            score_len=score_len + 5,
+            name="Name" if not str(ctx.author.mobile_status) in ["online", "idle", "dnd"] else "Name",
+        )
+        temp_msg = header
+        for account in sorted_acc:
+            if account[1]["total"] == 0:
+                continue
+            if global_leaderboard or (account[0] in [member.id for member in ctx.guild.members]):
+                user_obj = self.bot.get_user(account[0]) or account[0]
+            else:
+                continue
+            if isinstance(user_obj, discord.User) and len(str(user_obj)) > 28:
+                user_name = f"{user_obj.name[:19]}...#{user_obj.discriminator}"
+            else:
+                user_name = str(user_obj)
+            if user_obj == ctx.author:
+                temp_msg += f"{humanize_number(account[1]['total']) + '   ': <{score_len + 4}} <<{user_name}>>\n"
+            else:
+                temp_msg += f"{humanize_number(account[1]['total']) + '   ': <{score_len + 4}} {user_name}\n"
+
+        page_list = []
+        pages = 1
+        for page in pagify(temp_msg, delims=["\n"], page_length=800):
+            if global_leaderboard:
+                title = "Global Hunting Leaderboard"
+            else:
+                title = f"Hunting Leaderboard For {ctx.guild.name}"
+            embed = discord.Embed(
+                colour=await ctx.bot.get_embed_color(location=ctx.channel),
+                description=box(title, lang="prolog") + (box(page, lang="md")),
+            )
+            embed.set_footer(text=f"Page {humanize_number(pages)}/{humanize_number(math.ceil(len(temp_msg) / 800))}")
+            pages += 1
+            page_list.append(embed)
+        if len(page_list) == 1:
+            await ctx.send(embed=page_list[0])
+        else:
+            await menu(ctx, page_list, DEFAULT_CONTROLS)
+
+    @checks.mod_or_permissions(manage_guild=True)
+    @hunting.command()
+    async def bangtime(self, ctx):
+        """Toggle displaying the bang response time from users."""
+        toggle = await self.config.guild(ctx.guild).bang_time()
+        await self.config.guild(ctx.guild).bang_time.set(not toggle)
+        toggle_text = "will not" if toggle else "will"
+        await ctx.send(f"Bang reaction time {toggle_text} be shown.\n")
+
+    @checks.mod_or_permissions(manage_guild=True)
+    @hunting.command()
+    async def mode(self, ctx):
+        """Toggle whether the bot listens for 'bang' or a reaction."""
+        toggle = await self.config.guild(ctx.guild).bang_words()
+        await self.config.guild(ctx.guild).bang_words.set(not toggle)
+        toggle_text = "Use the reaction" if toggle else "Type 'bang'"
+        await ctx.send(f"{toggle_text} to react to the bang message when it appears.\n")
+
+    @checks.mod_or_permissions(manage_guild=True)
+    @hunting.command()
+    async def next(self, ctx):
+        """When will the next occurrence happen?"""
+        try:
+            self.next_bang[ctx.guild.id]
+            time = abs(datetime.datetime.utcnow() - self.next_bang[ctx.guild.id])
+            total_seconds = int(time.total_seconds())
+            hours, remainder = divmod(total_seconds, 60 * 60)
+            minutes, seconds = divmod(remainder, 60)
+            message = f"The next occurrence will be in {hours} hours and {minutes} minutes."
+        except KeyError:
+            message = "There is currently no hunt."
+        await ctx.send(bold(message))
+
+    @hunting.command(name="score")
+    async def score(self, ctx, member: discord.Member = None):
+        """This will show the score of a hunter."""
+        if not member:
+            member = ctx.author
+        score = await self.config.user(member).score()
+        total = 0
+        kill_list = []
+        if not score:
+            message = "Please shoot something before you can brag about it."
+
+        for animal in score.items():
+            total = total + animal[1]
+            if animal[1] == 1 or animal[0][-1] == "s":
+                kill_list.append(f"{animal[1]} {animal[0].capitalize()}")
+            else:
+                kill_list.append(f"{animal[1]} {animal[0].capitalize()}s")
+            message = f"{member.name} shot a total of {total} animals ({humanize_list(kill_list)})"
+        await ctx.send(bold(message))
+
+    @checks.mod_or_permissions(manage_guild=True)
+    @hunting.command()
+    async def start(self, ctx, channel: discord.TextChannel = None):
+        """Start the hunt."""
+        if not channel:
+            channel = ctx.channel
+
+        if not channel.permissions_for(ctx.guild.me).send_messages:
+            return await ctx.send(bold("I can't send messages in that channel!"))
+
+        channel_list = await self.config.guild(ctx.guild).channels()
+        if channel.id in channel_list:
+            message = f"We're already hunting in {channel.mention}!"
+        else:
+            channel_list.append(channel.id)
+            message = f"The hunt has started in {channel.mention}. Good luck to all."
+            await self.config.guild(ctx.guild).channels.set(channel_list)
+
+        await ctx.send(bold(message))
+
+    @checks.mod_or_permissions(manage_guild=True)
+    @hunting.command()
+    async def stop(self, ctx, channel: discord.TextChannel = None):
+        """Stop the hunt."""
+        if not channel:
+            channel = ctx.channel
+        channel_list = await self.config.guild(ctx.guild).channels()
+
+        if channel.id not in channel_list:
+            message = f"We're not hunting in {channel.mention}!"
+        else:
+            channel_list.remove(channel.id)
+            message = f"The hunt has stopped in {channel.mention}."
+            await self.config.guild(ctx.guild).channels.set(channel_list)
+
+        await ctx.send(bold(message))
+
+    @checks.mod_or_permissions(manage_guild=True)
+    @hunting.command()
+    async def timing(self, ctx, interval_min: int, interval_max: int, bang_timeout: int):
+        """
+        Change the hunting timing.
+        
+        `interval_min` = Minimum time in seconds for a new bird. (120s min)
+        `interval_max` = Maximum time in seconds for a new bird. (240s min)
+        `bang_timeout` = Time in seconds for users to shoot a bird before it flies away. (10s min)
+        """
+        message = ""
+        if interval_min > interval_max:
+            return await ctx.send("`interval_min` needs to be lower than `interval_max`.")
+        if interval_min < 0 and interval_max < 0 and bang_timeout < 0:
+            return await ctx.send("Please no negative numbers!")
+        if interval_min < 120:
+            interval_min = 120
+            message += "Minimum interval set to minimum of 120s.\n"
+        if interval_max < 240:
+            interval_max = 240
+            message += "Maximum interval set to minimum of 240s.\n"
+        if bang_timeout < 10:
+            bang_timeout = 10
+            message += "Bang timeout set to minimum of 10s.\n"
+
+        await self.config.guild(ctx.guild).hunt_interval_minimum.set(interval_min)
+        await self.config.guild(ctx.guild).hunt_interval_maximum.set(interval_max)
+        await self.config.guild(ctx.guild).wait_for_bang_timeout.set(bang_timeout)
+        message += (
+            f"Timing has been set:\nMin time {interval_min}s\nMax time {interval_max}s\nBang timeout {bang_timeout}s"
+        )
+        await ctx.send(bold(message))
+
+    @hunting.command()
+    async def version(self, ctx):
+        """Show the cog version."""
+        await ctx.send(f"Hunting version {__version__}.")
+
+    async def _add_score(self, guild, author, avian):
+        user_data = await self.config.user(author).all()
+        try:
+            user_data["score"][avian] += 1
+        except KeyError:
+            user_data["score"][avian] = 1
+        user_data["total"] += 1
+        await self.config.user(author).set_raw(value=user_data)
+
+    async def _latest_message_check(self, channel):
+        hunt_int_max = await self.config.guild(channel.guild).hunt_interval_maximum()
+        async for message in channel.history(limit=5):
+            delta = datetime.datetime.utcnow() - message.created_at
+            if delta.total_seconds() < hunt_int_max * 2 and message.author.id != self.bot.user.id:
+                if channel.id in self.paused_games:
+                    self.paused_games.remove(channel.id)
+                return True
+        if channel.id not in self.paused_games:
+            self.paused_games.append(channel.id)
+            await channel.send(
+                bold("It seems there are no hunters here. The hunt will be resumed when someone treads here again.")
+            )
+        return False
+
+    def _next_sorter(self, guild_id, value):
+        try:
+            self.next_bang[guild_id]
+        except KeyError:
+            self.next_bang[guild_id] = value
+
+    async def _wait_for_bang(self, guild, channel):
+        animal = random.choice(list(self.animals.keys()))
+        animal_message = await channel.send(self.animals[animal])
+        now = time.time()
+        timeout = await self.config.guild(guild).wait_for_bang_timeout()
+
+        shooting_type = await self.config.guild(guild).bang_words()
+        if shooting_type:
+
+            def check(message):
+                if guild != message.guild:
+                    return False
+                if channel != message.channel:
+                    return False
+                return message.content.lower().split(" ")[0] == "bang" if message.content else False
+
+            try:
+                bang_msg = await self.bot.wait_for("message", check=check, timeout=timeout)
+            except asyncio.TimeoutError:
+                self.in_game.remove(channel.id)
+                return await channel.send(f"The {animal} got away!")
+            author = bang_msg.author
+
+        else:
+            emoji = "\N{COLLISION SYMBOL}"
+            await animal_message.add_reaction(emoji)
+
+            def check(reaction, user):
+                if user.bot:
+                    return False
+                if guild != reaction.message.guild:
+                    return False
+                if channel != reaction.message.channel:
+                    return False
+                return user and str(reaction.emoji) == "💥"
+
+            try:
+                await self.bot.wait_for("reaction_add", check=check, timeout=timeout)
+            except asyncio.TimeoutError:
+                self.in_game.remove(channel.id)
+                return await channel.send(f"The {animal} got away!")
+
+            message_with_reacts = await animal_message.channel.fetch_message(animal_message.id)
+            reacts = message_with_reacts.reactions[0]
+            async for user in reacts.users():
+                if user.bot:
+                    continue
+                author = user
+                break
+
+        bang_now = time.time()
+        time_for_bang = "{:.3f}".format(bang_now - now)
+        bangtime = "" if not await self.config.guild(guild).bang_time() else f" in {time_for_bang}s"
+
+        if random.randrange(0, 17) > 1:
+            await self._add_score(guild, author, animal)
+            msg = f"{author.display_name} shot a {animal}{bangtime}!"
+        else:
+            msg = f"{author.display_name} missed the shot and the {animal} got away!"
+
+        self.in_game.remove(channel.id)
+        await channel.send(bold(msg))
+
+    @commands.Cog.listener()
+    async def on_message(self, message):
+        if not message.guild:
+            return
+        if message.author.bot:
+            return
+        if not message.channel.permissions_for(message.guild.me).send_messages:
+            return
+        if message.channel.id in self.in_game:
+            return
+        channel_list = await self.config.guild(message.guild).channels()
+        if not channel_list:
+            return
+        if message.channel.id not in channel_list:
+            return
+
+        if await self._latest_message_check(message.channel):
+            self.in_game.append(message.channel.id)
+
+        guild_data = await self.config.guild(message.guild).all()
+        wait_time = random.randrange(guild_data["hunt_interval_minimum"], guild_data["hunt_interval_maximum"])
+        self.next_bang[message.guild.id] = datetime.datetime.fromtimestamp(
+            int(time.mktime(datetime.datetime.utcnow().timetuple())) + wait_time
+        )
+        await asyncio.sleep(wait_time)
+        task = self.bot.loop.create_task(self._wait_for_bang(message.guild, message.channel))
+        self.game_tasks.append(task)
+        try:
+            del self.next_bang[message.guild.id]
+        except KeyError:
+            pass
+
+    def cog_unload(self):
+        for task in self.game_tasks:
+            task.cancel()

hunting/info.json

@@ -0,0 +1,9 @@
+{
+	"author": ["aikaterna", "Paddo"],
+	"description": "Hunting, it hunts birds and things that fly.",
+	"install_msg": "Check out [p]hunting to get started.",
+	"short": "A bird hunting game.",
+	"tags": ["hunting", "hunt", "game"],
+	"type": "COG",
+	"end_user_data_statement": "This cog does not persistently store end user data. This cog does store discord IDs as needed for operation. This cog does store user stats for the cog such as their score. Users may remove their own content without making a data removal request. This cog does not support data requests, but will respect deletion requests."
+}

icyparser/__init__.py

@@ -0,0 +1,7 @@
+from .icyparser import IcyParser
+
+__red_end_user_data_statement__ = "This cog does not persistently store data or metadata about users."
+
+
+def setup(bot):
+    bot.add_cog(IcyParser(bot))

icyparser/icyparser.py

@@ -0,0 +1,82 @@
+import aiohttp
+import discord
+import lavalink
+import struct
+import re
+from redbot.core import commands
+
+
+class IcyParser(commands.Cog):
+    """Icyparser/Shoutcast stream reader."""
+
+    async def red_delete_data_for_user(self, **kwargs):
+        """ Nothing to delete """
+        return
+
+    def __init__(self, bot):
+        self.bot = bot
+        self.session = aiohttp.ClientSession()
+
+    async def _icyparser(self, url: str):
+        try:
+            async with self.session.get(url, headers={"Icy-MetaData": "1"}) as resp:
+                metaint = int(resp.headers["icy-metaint"])
+                for _ in range(5):
+                    await resp.content.readexactly(metaint)
+                    metadata_length = struct.unpack("B", await resp.content.readexactly(1))[0] * 16
+                    metadata = await resp.content.readexactly(metadata_length)
+                    m = re.search(br"StreamTitle='([^']*)';", metadata.rstrip(b"\0"))
+                    if m:
+                        title = m.group(1)
+                        if title:
+                            title = title.decode("utf-8", errors="replace")
+                    else:
+                        title = None
+                    image = False
+                    t = re.search(br"StreamUrl='([^']*)';", metadata.rstrip(b"\0"))
+                    if t:
+                        streamurl = t.group(1)
+                        if streamurl:
+                            streamurl = streamurl.decode("utf-8", errors="replace")
+                            image_ext = ["webp", "png", "jpg", "gif"]
+                            if streamurl.split(".")[-1] in image_ext:
+                                image = True
+                    else:
+                        streamurl = None
+
+                    return title, streamurl, image
+
+        except (KeyError, aiohttp.client_exceptions.ClientConnectionError):
+            return None, None, None
+
+    def cog_unload(self):
+        self.bot.loop.create_task(self.session.close())
+
+    @commands.guild_only()
+    @commands.command(aliases=["icynp"])
+    async def icyparser(self, ctx, url=None):
+        """Show Icecast or Shoutcast stream information, if any."""
+        if not url:
+            audiocog = self.bot.get_cog("Audio")
+            if not audiocog:
+                return await ctx.send("Audio is not loaded.")
+            try:
+                player = lavalink.get_player(ctx.guild.id)
+            except KeyError:
+                return await ctx.send("The bot is not playing any music.")
+            if not player.current:
+                return await ctx.send("The bot is not playing any music.")
+            if not player.current.is_stream:
+                return await ctx.send("The bot is not playing a stream.")
+            icy = await self._icyparser(player.current.uri)
+        else:
+            icy = await self._icyparser(url)
+        if not icy[0]:
+            return await ctx.send(
+                f"Can't read the stream information for <{player.current.uri if not url else url}>, it may not be an Icecast or Shoutcast radio station or there may be no stream information available."
+            )
+        song = f"**[{icy[0]}]({player.current.uri if not url else url})**\n"
+        embed = discord.Embed(colour=await ctx.embed_colour(), title="Now Playing", description=song)
+        if icy[2]:
+            embed.set_thumbnail(url=icy[1])
+        await ctx.send(embed=embed)

icyparser/info.json

@@ -0,0 +1,15 @@
+{
+	"author": [
+		"aikaterna"
+	],
+	"description": "Audio addon cog for dislaying icecast/shoutcast info.",
+    "install_msg": "Thanks for installing, have fun.",
+	"short": "Audio addon cog for dislaying icecast/shoutcast info",
+	"tags": [
+		"audio",
+		"icecast",
+		"shoutcast"
+	],
+	"type": "COG",
+	"end_user_data_statement": "This cog does not persistently store data or metadata about users."
+}

info.json

@@ -1,7 +1,7 @@
 {
-    "author" : "aikaterna (aikaterna#1393)",
+    "author" : ["aikaterna (aikaterna#1393)"],
     "install_msg" : "Thanks for installing. Please submit issue reports on my repo if something's broken. You can find me in the Red servers or at the invite on my repo.",
     "name" : "aikaterna-cogs",
     "short" : "Utility and fun cogs",
     "description" : "Cogs requested by others, personal cogs, or orphaned cogs."
-}
+}

inspirobot/__init__.py

@@ -1,5 +1,7 @@
 from .inspirobot import Inspirobot
 
+__red_end_user_data_statement__ = "This cog does not persistently store data or metadata about users."
+
 
 def setup(bot):
     bot.add_cog(Inspirobot(bot))

inspirobot/info.json

@@ -12,5 +12,6 @@
 		"inspire",
         "inspirobot"
 	],
-	"type": "COG"
+	"type": "COG",
+	"end_user_data_statement": "This cog does not persistently store data or metadata about users."
 }

inspirobot/inspirobot.py

@@ -5,6 +5,11 @@ from redbot.core import commands
 
 class Inspirobot(commands.Cog):
     """Posts images generated by https://inspirobot.me"""
+
+    async def red_delete_data_for_user(self, **kwargs):
+        """ Nothing to delete """
+        return
+
     def __init__(self, bot):
         self.bot = bot
         self.session = aiohttp.ClientSession()
@@ -13,9 +18,7 @@ class Inspirobot(commands.Cog):
     async def inspireme(self, ctx):
         """Fetch a random "inspirational message" from the bot."""
         try:
-            async with self.session.request(
-                "GET", "http://inspirobot.me/api?generate=true"
-            ) as page:
+            async with self.session.request("GET", "http://inspirobot.me/api?generate=true") as page:
                 pic = await page.text(encoding="utf-8")
                 em = discord.Embed()
                 em.set_image(url=pic)

invites/__init__.py

@@ -0,0 +1,5 @@
+from .invites import Invites
+
+
+def setup(bot):
+    bot.add_cog(Invites(bot))

invites/info.json

@@ -0,0 +1,11 @@
+{
+	"author": ["aikaterna"],
+	"description": "Invite count display and leaderboard.",
+    "install_msg": "Thanks for installing. Use `[p]invites` to get started.",
+	"short": "Invite count display and leaderboard.",
+	"tags": ["invites"],
+	"min_bot_version": "3.3.10",
+	"permissions": ["administrator", "embed_links"],
+	"type": "COG"
+}
+

invites/invites.py

@@ -0,0 +1,284 @@
+from __future__ import annotations
+import discord
+from datetime import datetime
+import re
+from typing import List, Callable
+from redbot.core import commands, checks, Config
+from redbot.core.utils import chat_formatting as cf
+from redbot.vendored.discord.ext import menus
+
+OLD_CODE_RE = re.compile("^[0-9a-zA-Z]{16}$")
+CODE_RE = re.compile("^[0-9a-zA-Z]{6,7}$")
+
+FAILURE_MSG = "That invite doesn't seem to be valid."
+PERM_MSG = "I need the Administrator permission on this guild to view invite information."
+
+__version__ = "0.0.2"
+
+
+class Invites(commands.Cog):
+    def __init__(self, bot):
+        self.bot = bot
+        self.config = Config.get_conf(self, 2713371001, force_registration=True)
+
+        default_guild = {"pinned_invites": []}
+
+        self.config.register_guild(**default_guild)
+
+    @commands.guild_only()
+    @commands.group()
+    async def invites(self, ctx: commands.Context):
+        """Invite information."""
+        pass
+
+    @commands.max_concurrency(1, commands.BucketType.user)
+    @invites.command()
+    async def show(self, ctx: commands.Context, invite_code_or_url: str = None):
+        """Show the stats for an invite, or show all invites."""
+        if not ctx.me.permissions_in(ctx.channel).administrator:
+            return await self._send_embed(ctx, PERM_MSG)
+
+        if not invite_code_or_url:
+            pages = MenuPages(await ctx.guild.invites())
+            await self._menu(ctx, pages)
+        else:
+            invite_code = await self._find_invite_code(invite_code_or_url)
+            if not invite_code:
+                return await self._send_embed(ctx, FAILURE_MSG)
+
+    @invites.command()
+    async def leaderboard(self, ctx: commands.Context, list_all_invites: bool = False):
+        """List pinned invites or all invites in a leaderboard style."""
+        if not ctx.me.permissions_in(ctx.channel).administrator:
+            return await self._send_embed(ctx, PERM_MSG)
+
+        if not list_all_invites:
+            pinned_invites = await self.config.guild(ctx.guild).pinned_invites()
+            if not pinned_invites:
+                return await self._send_embed(ctx, "No invites are pinned, or there are no invites to display.")
+        else:
+            pinned_invites = await ctx.guild.invites()
+        invite_info = ""
+        for i, invite_code_or_object in enumerate(pinned_invites):
+            if not list_all_invites:
+                inv_object = await self._get_invite_from_code(ctx, invite_code_or_object)
+            else:
+                inv_object = invite_code_or_object
+            max_uses = await self.get_invite_max_uses(ctx, inv_object)
+            inv_details = f"{i+1}. {inv_object.url} [ {inv_object.uses} uses / {max_uses} max ]\n"
+            invite_info += inv_details
+        embed = discord.Embed(title=f"Invite Usage for {ctx.guild.name}", description=invite_info)
+        if not list_all_invites:
+            embed.set_footer(text="Only displaying pinned invites.")
+        else:
+            embed.set_footer(text="Displaying all invites.")
+        await ctx.send(embed=embed)
+
+    @invites.command(aliases=["listpinned"])
+    async def listpin(self, ctx: commands.Context):
+        """List pinned invites."""
+        pinned_invites = await self.config.guild(ctx.guild).pinned_invites()
+        invite_list = "None." if len(pinned_invites) == 0 else "\n".join(pinned_invites)
+        await self._send_embed(ctx, "Pinned Invites", invite_list)
+
+    @invites.command()
+    async def pin(self, ctx: commands.Context, invite_code_or_url: str):
+        """Pin an invite to the leaderboard."""
+        if not ctx.me.permissions_in(ctx.channel).administrator:
+            return await self._send_embed(ctx, PERM_MSG)
+
+        invite_code = await self._find_invite_code(invite_code_or_url)
+        invite_code = await self._check_invite_code(ctx, invite_code)
+        if not invite_code:
+            return await self._send_embed(ctx, FAILURE_MSG)
+
+        existing_pins = await self.config.guild(ctx.guild).pinned_invites()
+        if invite_code not in existing_pins:
+            existing_pins.append(invite_code)
+            await self.config.guild(ctx.guild).pinned_invites.set(existing_pins)
+            await self._send_embed(ctx, f"{invite_code} was added to the pinned list.")
+        else:
+            await self._send_embed(ctx, f"{invite_code} is already in the pinned list.")
+
+    @invites.command()
+    async def unpin(self, ctx: commands.Context, invite_code_or_url: str):
+        """Unpin an invite from the leaderboard."""
+        invite_code = await self._find_invite_code(invite_code_or_url)
+        if not invite_code:
+            return await self._send_embed(ctx, FAILURE_MSG)
+
+        pinned_invites = await self.config.guild(ctx.guild).pinned_invites()
+        if invite_code in pinned_invites:
+            pinned_invites.remove(invite_code)
+        else:
+            return await self._send_embed(ctx, f"{invite_code} isn't in the pinned list.")
+        await self.config.guild(ctx.guild).pinned_invites.set(pinned_invites)
+        await self._send_embed(ctx, f"{invite_code} was removed from the pinned list.")
+
+    @invites.command(hidden=True)
+    async def version(self, ctx):
+        """Invites version."""
+        await self._send_embed(ctx, self.__version__)
+
+    @staticmethod
+    async def _check_invite_code(ctx: commands.Context, invite_code: str):
+        for invite in await ctx.guild.invites():
+            if invite.code == invite_code:
+                return invite_code
+            else:
+                continue
+
+            return None
+
+    @staticmethod
+    async def _find_invite_code(invite_code_or_url: str):
+        invite_match = re.fullmatch(OLD_CODE_RE, invite_code_or_url) or re.fullmatch(CODE_RE, invite_code_or_url)
+        if invite_match:
+            return invite_code_or_url
+        else:
+            sep = invite_code_or_url.rfind("/")
+            if sep:
+                try:
+                    invite_code = invite_code_or_url.rsplit("/", 1)[1]
+                    return invite_code
+                except IndexError:
+                    return None
+
+            return None
+
+    @staticmethod
+    async def _get_invite_from_code(ctx: commands.Context, invite_code: str):
+        for invite in await ctx.guild.invites():
+            if invite.code == invite_code:
+                return invite
+            else:
+                continue
+
+            return None
+
+    @classmethod
+    async def get_invite_max_uses(self, ctx: commands.Context, invite_object: discord.Invite):
+        if invite_object.max_uses == 0:
+            return "\N{INFINITY}"
+        else:
+            return invite_object.max_uses
+
+    async def _menu(self, ctx: commands.Context, pages: List[discord.Embed]):
+        # `wait` in this function is whether the menus wait for completion.
+        # An example of this is with concurrency:
+        # If max_concurrency's wait arg is False (the default):
+        # This function's wait being False will not follow the expected max_concurrency behaviour
+        # This function's wait being True will follow the expected max_concurrency behaviour
+        await MenuActions(source=pages, delete_message_after=False, clear_reactions_after=True, timeout=180).start(
+            ctx, wait=True
+        )
+
+    @staticmethod
+    async def _send_embed(ctx: commands.Context, title: str = None, description: str = None):
+        title = "\N{ZERO WIDTH SPACE}" if title is None else title
+        embed = discord.Embed()
+        embed.title = title
+        if description:
+            embed.description = description
+        embed.colour = await ctx.embed_colour()
+        await ctx.send(embed=embed)
+
+
+class MenuPages(menus.ListPageSource):
+    def __init__(self, methods: List[discord.Invite]):
+        super().__init__(methods, per_page=1)
+
+    async def format_page(self, menu: MenuActions, invite: discord.Invite) -> discord.Embed:
+        # Use the menu to generate pages as they are needed instead of giving it a list of
+        # already-generated embeds.
+        embed = discord.Embed(title=f"Invites for {menu.ctx.guild.name}")
+        max_uses = await Invites.get_invite_max_uses(menu.ctx, invite)
+        msg = f"{cf.bold(invite.url)}\n\n"
+        msg += f"Uses: {invite.uses}/{max_uses}\n"
+        msg += f"Target Channel: {invite.channel.mention}\n"
+        msg += f"Created by: {invite.inviter.mention}\n"
+        msg += f"Created at: {invite.created_at.strftime('%m-%d-%Y @ %H:%M:%S UTC')}\n"
+        if invite.temporary:
+            msg += "Temporary invite\n"
+        if invite.max_age == 0:
+            max_age = f""
+        else:
+            max_age = f"Max age: {self._dynamic_time(int(invite.max_age))}"
+        msg += f"{max_age}"
+        embed.description = msg
+
+        return embed
+
+    @staticmethod
+    def _dynamic_time(time: int):
+        m, s = divmod(time, 60)
+        h, m = divmod(m, 60)
+        d, h = divmod(h, 24)
+
+        if d > 0:
+            msg = "{0}d {1}h"
+        elif d == 0 and h > 0:
+            msg = "{1}h {2}m"
+        elif d == 0 and h == 0 and m > 0:
+            msg = "{2}m {3}s"
+        elif d == 0 and h == 0 and m == 0 and s > 0:
+            msg = "{3}s"
+        else:
+            msg = ""
+        return msg.format(d, h, m, s)
+
+
+class MenuActions(menus.MenuPages, inherit_buttons=False):
+    def reaction_check(self, payload):
+        """The function that is used to check whether the payload should be processed.
+        This is passed to :meth:`discord.ext.commands.Bot.wait_for <Bot.wait_for>`.
+
+        There should be no reason to override this function for most users.
+        This is done this way in this cog to let a bot owner operate the menu
+        along with the original command invoker.
+
+        Parameters
+        ------------
+        payload: :class:`discord.RawReactionActionEvent`
+            The payload to check.
+
+        Returns
+        ---------
+        :class:`bool`
+            Whether the payload should be processed.
+        """
+        if payload.message_id != self.message.id:
+            return False
+        if payload.user_id not in (*self.bot.owner_ids, self._author_id):
+            return False
+
+        return payload.emoji in self.buttons
+
+    async def show_checked_page(self, page_number: int) -> None:
+        # This is a custom impl of show_checked_page that allows looping around back to the
+        # beginning of the page stack when at the end and using next, or looping to the end
+        # when at the beginning page and using prev.
+        max_pages = self._source.get_max_pages()
+        try:
+            if max_pages is None:
+                await self.show_page(page_number)
+            elif page_number >= max_pages:
+                await self.show_page(0)
+            elif page_number < 0:
+                await self.show_page(max_pages - 1)
+            elif max_pages > page_number >= 0:
+                await self.show_page(page_number)
+        except IndexError:
+            pass
+
+    @menus.button("\N{UP-POINTING RED TRIANGLE}", position=menus.First(1))
+    async def prev(self, payload: discord.RawReactionActionEvent):
+        await self.show_checked_page(self.current_page - 1)
+
+    @menus.button("\N{DOWN-POINTING RED TRIANGLE}", position=menus.First(2))
+    async def next(self, payload: discord.RawReactionActionEvent):
+        await self.show_checked_page(self.current_page + 1)
+
+    @menus.button("\N{CROSS MARK}", position=menus.Last(0))
+    async def close_menu(self, payload: discord.RawReactionActionEvent) -> None:
+        self.stop()

latex/__init__.py

@@ -0,0 +1,4 @@
+from .latex import Latex
+
+def setup(bot):
+  bot.add_cog(Latex(bot))

latex/info.json

@@ -0,0 +1,10 @@
+{
+    "author": ["aikaterna", "Stevy"],
+    "description": "Generates an image for a LaTeX expression.",
+    "install_msg": "Thanks for installing, have fun.",
+    "short": "Generates an image for a LaTeX expression.",
+    "tags": ["latex"],
+    "requirements": ["pillow"],
+    "type": "COG",
+    "end_user_data_statement": "This cog does not persistently store data or metadata about users."
+}

latex/latex.py

@@ -0,0 +1,64 @@
+import aiohttp
+import discord
+import io
+import logging
+import re
+from PIL import Image, ImageOps
+import urllib.parse as parse
+from redbot.core import commands
+
+
+log = logging.getLogger("red.aikaterna.latex")
+
+START_CODE_BLOCK_RE = re.compile(r"^((```(la)?tex)(?=\s)|(```))")
+
+
+class Latex(commands.Cog):
+    """LaTeX expressions via an image."""
+
+    async def red_delete_data_for_user(self, **kwargs):
+        """Nothing to delete."""
+        return
+
+    def __init__(self, bot):
+        self.bot = bot
+        self.session = aiohttp.ClientSession()
+
+    @staticmethod
+    def cleanup_code_block(content):
+        # remove ```latex\n```/```tex\n```/``````
+        if content.startswith("```") and content.endswith("```"):
+            return START_CODE_BLOCK_RE.sub("", content)[:-3]
+        
+        # remove `foo`
+        return content.strip("` \n")
+
+    @commands.guild_only()
+    @commands.command()
+    async def latex(self, ctx, *, equation):
+        """Takes a LaTeX expression and makes it pretty."""
+        base_url = "https://latex.codecogs.com/gif.latex?%5Cbg_white%20%5CLARGE%20"
+        equation = self.cleanup_code_block(equation)
+        equation = parse.quote(equation)
+        url = f"{base_url}{equation}"
+
+        try:
+            async with self.session.get(url) as r:
+                image = await r.read()
+            image = Image.open(io.BytesIO(image)).convert("RGBA")
+        except Exception as exc:
+            log.exception("Something went wrong while trying to read the image:\n ", exc_info=exc)
+            image = None
+
+        if not image:
+            return await ctx.send("I can't get the image from the website, check your console for more information.")
+
+        image = ImageOps.expand(image, border=10, fill="white")
+        image_file_object = io.BytesIO()
+        image.save(image_file_object, format="png")
+        image_file_object.seek(0)
+        image_final = discord.File(fp=image_file_object, filename="latex.png")
+        await ctx.send(file=image_final)
+
+    def cog_unload(self):
+        self.bot.loop.create_task(self.session.close())

luigipoker/__init__.py

@@ -0,0 +1,7 @@
+from .luigipoker import LuigiPoker
+
+__red_end_user_data_statement__ = "This cog does not persistently store data or metadata about users."
+
+
+def setup(bot):
+    bot.add_cog(LuigiPoker(bot))

luigipoker/info.json

@@ -0,0 +1,9 @@
+{
+	"author": ["aikaterna", "themario30"],
+	"description": "Play the Luigi Poker minigame from New Super Mario Brothers.",
+	"install_msg": "Thanks for installing.",
+	"short": "A Luigi poker minigame.",
+	"tags": ["poker", "game"],
+	"type": "COG",
+	"end_user_data_statement": "This cog does not persistently store data or metadata about users."
+}

luigipoker/luigipoker.py

@@ -0,0 +1,428 @@
+import asyncio
+import logging
+from random import randint
+from redbot.core import commands
+from redbot.core.utils.chat_formatting import box
+from redbot.core.utils.predicates import MessagePredicate
+
+
+log = logging.getLogger("red.aikaterna.luigipoker")
+
+
+class Card:
+    def __init__(self, card_number=None):
+        self._number = card_number if card_number else randint(1, 6)
+        self._suit = self._suit()
+
+    def _suit(self):
+        if self._number == 1:
+            suit = "\N{CLOUD}\N{VARIATION SELECTOR-16}"
+        elif self._number == 2:
+            suit = "\N{MUSHROOM}"
+        elif self._number == 3:
+            suit = "\N{SUNFLOWER}"
+        elif self._number == 4:
+            suit = "\N{LARGE GREEN SQUARE}"
+        elif self._number == 5:
+            suit = "\N{LARGE RED SQUARE}"
+        elif self._number == 6:
+            suit = "\N{WHITE MEDIUM STAR}"
+        else:
+            suit = "Error!"
+
+        return suit
+
+    def __repr__(self):
+        return f"{self._suit}"
+
+    def num(self):
+        return self._number
+
+    def suit(self):
+        return self._suit
+
+
+class Deck:
+    def __init__(self):
+        self._length = 5
+        self._deck = self._create_deck()
+        self.first_pair = 0
+        self.second_pair = 0
+        self.new_deck()
+
+    def _create_deck(self):
+        temp = [Card() for x in range(0, self._length)]
+        return temp
+
+    def _new_card(self, i):
+        self._deck[i] = Card()
+
+    def _sort_deck(self):
+        self._deck.sort(key=lambda x: x.num(), reverse=True)
+
+    def new_deck(self):
+        self._deck = self._create_deck()
+        self._sort_deck()
+
+    def deck(self):
+        return self._deck
+
+    def num(self, i):
+        return self._deck[i].num()
+
+    def swap(self, i):
+        for x in i:
+            self._new_card(int(x) - 1)
+        self._sort_deck()
+
+    def suit(self, i):
+        return self._deck[i].suit()
+
+    def len(self):
+        return self._length
+
+
+class LuigiPoker(commands.Cog):
+    """The Luigi Poker minigame from New Super Mario Brothers."""
+
+    async def red_delete_data_for_user(self, **kwargs):
+        """ Nothing to delete """
+        return
+
+    __version__ = "0.1.2"
+
+    def __init__(self, bot):
+        self.bot = bot
+        self._in_game = {}
+        self._hit = {}
+        self.player_deck = Deck()
+        self.dealer_deck = Deck()
+
+    @commands.group()
+    async def poker(self, ctx):
+        """The Luigi Poker minigame from New Super Mario Brothers."""
+        if ctx.invoked_subcommand is None:
+            space = "\N{EN SPACE}"
+            msg = (
+                f"I'm Luigi, Number 1!\n"
+                f"This game plays the same as Luigi's "
+                f"Poker in Super Mario 64 DS Minigames.\n"
+                f"The card's worth is based on the suit.\n"
+                f"Starman > Mario > Luigi > Fire Flower > Mushroom > Cloud.\n"
+                f"{space*3}{Card(6)}{space*4}>{space*3}{Card(5)}{space*3}>{space*3}{Card(4)}{space*3}"
+                f">{space*6}{Card(3)}{space*6}>{space*4}{Card(2)}{space*5}>{space*4}{Card(1)}\n"
+                f"---------------------------------------------------------\n"
+                f"The following table represents the winning matches.\n"
+                f"For example, a Full House is greater than Three of a Kind, but "
+                f"less than a Four of a Kind.\n"
+                f"---------------------------------------------------------\n"
+                f"Flush:           {Card(6)}{Card(6)}{Card(6)}{Card(6)}{Card(6)}\n"
+                f"Four of a Kind:  {Card(6)}{Card(6)}{Card(6)}{Card(6)}\n"
+                f"Full House:      {Card(6)}{Card(6)}{Card(6)}{Card(3)}{Card(3)}\n"
+                f"Three of a Kind: {Card(6)}{Card(6)}{Card(6)}\n"
+                f"Two Pairs:       {Card(6)}{Card(6)}{Card(2)}{Card(2)}\n"
+                f"Pair:            {Card(6)}{Card(6)}\n"
+            )
+            await ctx.send(box(msg))
+            return await ctx.send(
+                f"Are you ready to play my game?! What are you waiting for? Start the game using `{ctx.prefix}poker play`!"
+            )
+
+    @poker.command()
+    async def play(self, ctx):
+        """Starts the Game!"""
+        if not self._in_game.get(ctx.guild.id, False):
+            self._in_game[ctx.guild.id] = True
+            self.player_deck.new_deck()
+            self.dealer_deck.new_deck()
+        else:
+            return await ctx.send("You're already in a game...")
+
+        square = "\N{WHITE MEDIUM SMALL SQUARE}"
+        msg = (
+            f"Dealer's Deck: {square*5}\n"
+            f"Your Deck:     {self.player_deck.suit(0)}{self.player_deck.suit(1)}"
+            f"{self.player_deck.suit(2)}{self.player_deck.suit(3)}{self.player_deck.suit(4)}"
+        )
+
+        await ctx.send(box(msg))
+
+        if self._hit.get(ctx.guild.id, False):
+            await ctx.send("`Stay` or `fold`?")
+            answers = ["stay", "fold"]
+        else:
+            await ctx.send("`Stay`, `hit`, or `fold`?")
+            answers = ["stay", "hit", "fold"]
+        await self._play_response(ctx, answers)
+
+    async def _play_response(self, ctx, answers):
+        pred = MessagePredicate.lower_contained_in(answers, ctx=ctx)
+        try:
+            user_resp = await ctx.bot.wait_for("message", timeout=120, check=pred)
+        except asyncio.TimeoutError:
+            await ctx.send("No response.")
+            return await self.fold(ctx)
+        if "stay" in user_resp.content.lower():
+            return await self.stay(ctx)
+        elif "hit" in user_resp.content.lower():
+            return await self.hit(ctx)
+        elif "fold" in user_resp.content.lower():
+            return await self.fold(ctx)
+        else:
+            log.error(
+                "LuigiPoker: Something broke unexpectedly in _play_response. Please report it.", exc_info=True,
+            )
+
+    async def hit(self, ctx):
+        card_question = await ctx.send(
+            "What cards do you want to swap out?\n"
+            "Use numbers 1 through 5 to specify, with commas in between.\n"
+            "Examples: `1,3,5` or `4, 5`"
+        )
+        try:
+            user_resp = await ctx.bot.wait_for("message", timeout=60, check=MessagePredicate.same_context(ctx))
+        except asyncio.TimeoutError:
+            await ctx.send("No response.")
+            return await self.fold(ctx)
+
+        user_answers = user_resp.content.strip().split(",")
+        user_answers_valid = list(set(user_answers) & set(["1", "2", "3", "4", "5"]))
+        if len(user_answers_valid) == 0:
+            return await self.hit(ctx)
+
+        await ctx.send("Swapping Cards...")
+        self.player_deck.swap(user_answers_valid)
+        square = "\N{WHITE MEDIUM SMALL SQUARE}"
+        msg = (
+            f"Dealer's Deck: {square*5}\n"
+            f"Your Deck:     {self.player_deck.suit(0)}{self.player_deck.suit(1)}"
+            f"{self.player_deck.suit(2)}{self.player_deck.suit(3)}{self.player_deck.suit(4)}"
+        )
+        await ctx.send(box(msg))
+        await ctx.send("`Stay` or `fold`?")
+        self._hit[ctx.guild.id] = True
+        answers = ["stay", "fold"]
+        await self._play_response(ctx, answers)
+
+    async def fold(self, ctx):
+        msg = "You have folded.\n"
+        msg += box(
+            f"Dealer's Deck: {self.dealer_deck.suit(0)}{self.dealer_deck.suit(1)}"
+            f"{self.dealer_deck.suit(2)}{self.dealer_deck.suit(3)}{self.dealer_deck.suit(4)}\n"
+            f"Your Deck:     {self.player_deck.suit(0)}{self.player_deck.suit(1)}"
+            f"{self.player_deck.suit(2)}{self.player_deck.suit(3)}{self.player_deck.suit(4)}"
+        )
+
+        self._in_game[ctx.guild.id] = False
+        self._hit[ctx.guild.id] = False
+        await ctx.send(msg)
+
+    async def stay(self, ctx):
+        say = ""
+        win = False
+        same_move = False
+        tied = False
+
+        # Flush
+        if self.flush(self.player_deck) != self.flush(self.dealer_deck):
+            say = "a Flush"
+            if self.flush(self.player_deck):
+                win = True
+        elif self.flush(self.player_deck) and self.flush(self.dealer_deck):
+            say = "Flush"
+            same_move = True
+            if self.player_deck.first_pair > self.dealer_deck.first_pair:
+                win = True
+            elif self.player_deck.first_pair == self.dealer_deck.first_pair:
+                tied = True
+
+        # Four of a Kind
+        elif self.four_of_a_kind(self.player_deck) != self.four_of_a_kind(self.dealer_deck):
+            say = "a Four of a Kind"
+            if self.four_of_a_kind(self.player_deck):
+                win = True
+        elif self.four_of_a_kind(self.player_deck) and self.four_of_a_kind(self.dealer_deck):
+            say = "Four of a Kind"
+            same_move = True
+            if self.player_deck.first_pair > self.dealer_deck.first_pair:
+                win = True
+            elif self.player_deck.first_pair == self.dealer_deck.first_pair:
+                tied = True
+
+        # Full House
+        elif self.full_house(self.player_deck) != self.full_house(self.dealer_deck):
+            say = "a Full House"
+            if self.full_house(self.player_deck):
+                win = True
+        elif self.full_house(self.player_deck) and self.full_house(self.dealer_deck):
+            say = "Full House"
+            same_move = True
+            if self.player_deck.first_pair > self.dealer_deck.first_pair:
+                win = True
+            elif self.player_deck.second_pair > self.dealer_deck.second_pair:
+                win = True
+            elif (
+                self.player_deck.first_pair == self.dealer_deck.first_pair
+                and self.player_deck.second_pair == self.dealer_deck.second_pair
+            ):
+                tied = True
+
+        # Full House
+        elif self.three_of_a_kind(self.player_deck) != self.three_of_a_kind(self.dealer_deck):
+            say = "a Three of a Kind"
+            if self.three_of_a_kind(self.player_deck):
+                win = True
+        elif self.three_of_a_kind(self.player_deck) and self.three_of_a_kind(self.dealer_deck):
+            say = "Three of a Kind"
+            same_move = True
+            if self.player_deck.first_pair > self.dealer_deck.first_pair:
+                win = True
+            elif self.player_deck.first_pair == self.dealer_deck.first_pair:
+                tied = True
+
+        # Two Pairs
+        elif self.two_pair(self.player_deck) != self.two_pair(self.dealer_deck):
+            say = "Two Pairs"
+            if self.two_pair(self.player_deck):
+                win = True
+        elif self.two_pair(self.player_deck) and self.two_pair(self.dealer_deck):
+            say = "Two Pairs"
+            same_move = True
+            if self.player_deck.first_pair > self.dealer_deck.first_pair:
+                win = True
+            elif self.player_deck.second_pair > self.dealer_deck.second_pair:
+                win = True
+            elif (
+                self.player_deck.first_pair == self.dealer_deck.first_pair
+                and self.player_deck.second_pair == self.dealer_deck.second_pair
+            ):
+                tied = True
+
+        # One Pair
+        elif self.one_pair(self.player_deck) != self.one_pair(self.dealer_deck):
+            say = "a Pair"
+            if self.one_pair(self.player_deck):
+                win = True
+        elif self.one_pair(self.player_deck) and self.one_pair(self.dealer_deck):
+            say = "Pair"
+            same_move = True
+            if self.player_deck.first_pair > self.dealer_deck.first_pair:
+                win = True
+            elif self.player_deck.first_pair == self.dealer_deck.first_pair:
+                tied = True
+        else:
+            tied = True
+
+        msg = "You've stayed.\n"
+
+        if same_move:
+            if win:
+                msg += f"You won! Your {say} is greater than Dealer's {say}!"
+            else:
+                msg += f"You lost! The Dealer's {say} is greater than your {say}!"
+        elif win:
+            msg += f"You won! You got {say}!"
+        elif tied:
+            msg += "Both the Dealer and the Player have tied."
+        else:
+            msg += f"You lost! The Dealer got {say}."
+
+        msg += box(
+            f"Dealer's Deck: {self.dealer_deck.suit(0)}{self.dealer_deck.suit(1)}"
+            f"{self.dealer_deck.suit(2)}{self.dealer_deck.suit(3)}{self.dealer_deck.suit(4)}\n"
+            f"Your Deck:     {self.player_deck.suit(0)}{self.player_deck.suit(1)}"
+            f"{self.player_deck.suit(2)}{self.player_deck.suit(3)}{self.player_deck.suit(4)}"
+        )
+        self._in_game[ctx.guild.id] = False
+        self._hit[ctx.guild.id] = False
+        await ctx.send(msg)
+
+    @staticmethod
+    def one_pair(deck):
+        answer = False
+        for x in range(0, deck.len() - 1):
+            if deck.num(x) == deck.num(x + 1):
+                deck.first_pair = deck.num(x)
+                answer = True
+
+        return answer
+
+    @staticmethod
+    def two_pair(deck):
+        answer = False
+        first_pair = 0
+        second_pair = 0
+
+        for x in range(0, deck.len() - 1):
+            if deck.num(x) == deck.num(x + 1):
+                if first_pair == 0:
+                    first_pair = deck.num(x)
+                elif first_pair != deck.num(x) and second_pair == 0:
+                    second_pair = deck.num(x)
+
+        if first_pair != 0 and second_pair != 0:
+            deck.first_pair = first_pair
+            deck.second_pair = second_pair
+            answer = True
+
+        return answer
+
+    @staticmethod
+    def three_of_a_kind(deck):
+        answer = False
+        for x in range(0, deck.len() - 2):
+            if deck.num(x) == deck.num(x + 1) and deck.num(x + 1) == deck.num(x + 2):
+                deck.first_pair = deck.num(x)
+                answer = True
+
+        return answer
+
+    @staticmethod
+    def full_house(deck):
+        answer = False
+        first_pair = 0
+        second_pair = 0
+        for x in range(0, deck.len() - 2):
+            if deck.num(x) == deck.num(x + 1) and deck.num(x + 1) == deck.num(x + 2):
+                if first_pair == 0:
+                    first_pair = deck.num(x)
+        for x in range(0, deck.len() - 1):
+            if deck.num(x) == deck.num(x + 1):
+                if first_pair != deck.num(x) and second_pair == 0:
+                    second_pair = deck.num(x)
+
+        if first_pair != 0 and second_pair != 0:
+            deck.first_pair = first_pair
+            deck.second_pair = second_pair
+            answer = True
+
+        return answer
+
+    @staticmethod
+    def four_of_a_kind(deck):
+        answer = False
+        for x in range(0, deck.len() - 3):
+            if (
+                deck.num(x) == deck.num(x + 1)
+                and deck.num(x + 1) == deck.num(x + 2)
+                and deck.num(x + 2) == deck.num(x + 3)
+            ):
+                deck.first_pair = deck.num(x)
+                answer = True
+
+        return answer
+
+    @staticmethod
+    def flush(deck):
+        answer = False
+        x = 0
+        if (
+            deck.num(x) == deck.num(x + 1)
+            and deck.num(x + 1) == deck.num(x + 2)
+            and deck.num(x + 2) == deck.num(x + 3)
+            and deck.num(x + 3) == deck.num(x + 4)
+        ):
+            deck.first_pair = deck.num(x)
+            answer = True
+
+        return answer

noflippedtables/__init__.py

@@ -1,5 +1,7 @@
 from .noflippedtables import NoFlippedTables
 
+__red_end_user_data_statement__ = "This cog does not persistently store data or metadata about users."
+
 
 def setup(bot):
-  bot.add_cog(NoFlippedTables(bot))
+    bot.add_cog(NoFlippedTables(bot))

noflippedtables/info.json

@@ -5,5 +5,6 @@
     "description" : "Unflip all the flipped tables.",
     "install_msg" : "Usage: [p]help tableset",
     "tags" : ["noflippedtables", "no flip", "tables"],
-    "disabled" : false
+    "disabled" : false,
+	"end_user_data_statement": "This cog does not persistently store data or metadata about users."
 }

noflippedtables/noflippedtables.py

@@ -8,6 +8,10 @@ from redbot.core.utils.chat_formatting import box
 class NoFlippedTables(commands.Cog):
     """For the table sympathizers"""
 
+    async def red_delete_data_for_user(self, **kwargs):
+        """ Nothing to delete """
+        return
+
     def __init__(self, bot):
         self.bot = bot
         self.config = Config.get_conf(self, 2712290002, force_registration=True)
@@ -81,6 +85,8 @@ class NoFlippedTables(commands.Cog):
         user = message.author
         if not message.guild:
             return
+        if not channel.permissions_for(message.guild.me).send_messages:
+            return
         if hasattr(user, "bot") and user.bot is True:
             return
         toggle = await self.config.guild(message.guild).TOGGLE()

nolinks/__init__.py

@@ -1,5 +1,7 @@
 from .nolinks import NoLinks
 
+__red_end_user_data_statement__ = "This cog does not persistently store data or metadata about users."
+
 
 def setup(bot):
-    bot.add_cog(NoLinks(bot))
+    bot.add_cog(NoLinks(bot))

nolinks/info.json

@@ -13,5 +13,6 @@
 		"links",
         "automod"
 	],
-	"type": "COG"
+	"type": "COG",
+	"end_user_data_statement": "This cog does not persistently store data or metadata about users."
 }

nolinks/nolinks.py

@@ -2,16 +2,18 @@ import discord
 import re
 from redbot.core import Config, commands, checks
 
+LINKS = re.compile(
+    "(([\w]+:)?//)?(([\d\w]|%[a-fA-f\d]{2,2})+(:([\d\w]|%[a-fA-f\d]{2,2})+)?@)?([\d\w][-\d\w]{0,253}[\d\w]\.)+[\w]{2,63}(:[\d]+)?(/([-+_~.\d\w]|%[a-fA-f\d]{2,2})*)*(\?(&?([-+_~.\d\w]|%[a-fA-f\d]{2,2})=?)*)?(#([-+_~.\d\w]|%[a-fA-f\d]{2,2})*)?"
+)
 
-BaseCog = getattr(commands, "Cog", object)
 
-listener = getattr(commands.Cog, "listener", None)  # Trusty + Sinbad
-if listener is None:
+class NoLinks(commands.Cog):
+    """A heavy-handed hammer for anything that looks like a link."""
 
-    def listener(name=None):
-        return lambda x: x
+    async def red_delete_data_for_user(self, **kwargs):
+        """ Nothing to delete """
+        return
 
-class NoLinks(BaseCog):
     def __init__(self, bot):
         self.bot = bot
         self.config = Config.get_conf(self, 2740131001, force_registration=True)
@@ -110,7 +112,7 @@ class NoLinks(BaseCog):
         await self.config.guild(ctx.guild).watching.set(channel_list)
         await ctx.send(f"{self.bot.get_channel(channel.id).mention} will not have links removed.")
 
-    @listener()
+    @commands.Cog.listener()
     async def on_message(self, message):
         if isinstance(message.channel, discord.abc.PrivateChannel):
             return
@@ -133,12 +135,8 @@ class NoLinks(BaseCog):
                 sentence = message.content.split()
                 for word in sentence:
                     if self._match_url(word):
-                        msg = "**Message Removed in** {} ({})\n".format(
-                            message.channel.mention, message.channel.id
-                        )
-                        msg += "**Message sent by**: {} ({})\n".format(
-                            message.author.name, message.author.id
-                        )
+                        msg = "**Message Removed in** {} ({})\n".format(message.channel.mention, message.channel.id)
+                        msg += "**Message sent by**: {} ({})\n".format(message.author.name, message.author.id)
                         msg += "**Message content**:\n{}".format(message.content)
                         if message_channel:
                             await message_channel.send(msg)
@@ -150,10 +148,4 @@ class NoLinks(BaseCog):
 
     @staticmethod
     def _match_url(url):
-        regex = re.compile(
-            "(([\w]+:)?//)?(([\d\w]|%[a-fA-f\d]{2,2})+(:([\d\w]|%[a-fA-f\d]{2,2})+)?@)?([\d\w][-\d\w]{0,253}[\d\w]\.)+[\w]{2,63}(:[\d]+)?(/([-+_~.\d\w]|%[a-fA-f\d]{2,2})*)*(\?(&?([-+_~.\d\w]|%[a-fA-f\d]{2,2})=?)*)?(#([-+_~.\d\w]|%[a-fA-f\d]{2,2})*)?"
-        )
-        if regex.match(url):
-            return True
-        else:
-            return False
+        return LINKS.match(url)

otherbot/__init__.py

@@ -1,5 +1,11 @@
 from .otherbot import Otherbot
 
+__red_end_user_data_statement__ = (
+    "This cog does not persistently store end user data. " "This cog does store discord IDs as needed for operation. "
+)
 
-def setup(bot):
-    bot.add_cog(Otherbot(bot))
+
+async def setup(bot):
+    cog = Otherbot(bot)
+    await cog.generate_cache()
+    bot.add_cog(cog)

otherbot/info.json

@@ -1,6 +1,6 @@
 {
 	"author": [
-		"aikaterna"
+		"aikaterna", "Predä 。#1001"
 	],
 	"description": "Alerts a role when bot(s) go offline.",
     "install_msg": "Thanks for installing, have fun.",
@@ -11,5 +11,6 @@
 	"tags": [
 		"bots"
 	],
-	"type": "COG"
-}
+	"type": "COG",
+	"end_user_data_statement": "This cog does not persistently store end user data. This cog does store discord IDs as needed for operation. "
+}

otherbot/otherbot.py

@@ -1,33 +1,181 @@
+from typing import Literal
+
 import discord
+from redbot.core.bot import Red
 from redbot.core import commands, checks, Config
 
+from datetime import datetime
 
-BaseCog = getattr(commands, "Cog", object)
+DEFAULT_OFFLINE_EMOJI = "\N{LARGE RED CIRCLE}"
+DEFAULT_ONLINE_EMOJI = "\N{WHITE HEAVY CHECK MARK}"
 
-listener = getattr(commands.Cog, "listener", None)  # Trusty + Sinbad
-if listener is None:
 
-    def listener(name=None):
-        return lambda x: x
+class Otherbot(commands.Cog):
+    __author__ = ["aikaterna", "Predä 。#1001"]
+    __version__ = "0.10"
 
-class Otherbot(BaseCog):
-    def __init__(self, bot):
+    async def red_delete_data_for_user(
+        self, *, requester: Literal["discord", "owner", "user", "user_strict"], user_id: int,
+    ):
+        if requester == "discord":
+            # user is deleted, just comply
+
+            data = await self.config.all_guilds()
+            for guild_id, guild_data in data.items():
+                if user_id in guild_data.get("watching", []):
+                    bypass = guild_data.get("watching", [])
+                    bypass = set(bypass)
+                    bypass.discard(user_id)
+                    await self.config.guild_from_id(guild_id).bypass.set(list(bypass))
+
+    def __init__(self, bot: Red):
         self.bot = bot
         self.config = Config.get_conf(self, 2730321001, force_registration=True)
+        self.config.register_guild(
+            ping=None,
+            reporting=None,
+            watching=[],
+            online_watching=[],
+            offline_emoji=DEFAULT_OFFLINE_EMOJI,
+            online_emoji=DEFAULT_ONLINE_EMOJI,
+            embed_offline=True,
+            embed_online=True,
+        )
 
-        default_guild = {"ping": None, "reporting": None, "watching": []}
+    async def generate_cache(self):
+        self.otherbot_cache = await self.config.all_guilds()
 
-        self.config.register_guild(**default_guild)
+    def cog_unload(self):
+        self.otherbot_cache.clear()
+
+    async def get_watching(self, watch_list: list, watch_type: str, guild: int):
+        data = []
+        for user_id in watch_list:
+            user = self.bot.get_user(user_id)
+            if not user:
+                async with self.config.guild_from_id(guild).all() as config:
+                    config[watch_type].remove(user_id)
+            else:
+                data.append(user.mention)
+        return data
 
     @commands.group()
     @commands.guild_only()
     @checks.admin_or_permissions(manage_roles=True)
-    async def otherbot(self, ctx):
+    async def otherbot(self, ctx: commands.Context):
         """Otherbot configuration options."""
-        pass
+        # Following logic from Trusty's welcome cog:
+        # https://github.com/TrustyJAID/Trusty-cogs/blob/master/welcome/welcome.py#L81
+        guild = ctx.guild
+        if not ctx.invoked_subcommand:
+            guild_data = await self.config.guild(guild).all()
+            settings_name = dict(
+                ping="Ping role",
+                reporting="Channel reporting",
+                watching="Offline tracking",
+                online_watching="Online tracking",
+                offline_emoji="Offline emoji",
+                online_emoji="Online emoji",
+                embed_offline="Offline embed",
+                embed_online="Online embed",
+            )
+            msg = ""
+            if ctx.channel.permissions_for(ctx.me).embed_links:
+                em = discord.Embed(
+                    color=await ctx.embed_colour(), title=f"Otherbot settings for {guild.name}"
+                )
+                for attr, name in settings_name.items():
+                    if attr == "ping":
+                        role = guild.get_role(guild_data["ping"])
+                        if role:
+                            msg += f"**{name}**: {role.mention}\n"
+                        else:
+                            msg += f"**{name}**: Not set.\n"
+                    elif attr == "reporting":
+                        channel = guild.get_channel(guild_data["reporting"])
+                        if channel:
+                            msg += f"**{name}**: {channel.mention}\n"
+                        else:
+                            msg += f"**{name}**: Not set.\n"
+                    elif attr == "watching":
+                        if guild_data["watching"]:
+                            msg += (
+                                f"**{name}**: "
+                                + " ".join(
+                                    await self.get_watching(
+                                        guild_data["watching"], "watching", guild.id
+                                    )
+                                )
+                                + "\n"
+                            )
+                        else:
+                            msg += f"**{name}**: Not set.\n"
+                    elif attr == "online_watching":
+                        if guild_data["online_watching"]:
+                            msg += (
+                                f"**{name}**: "
+                                + " ".join(
+                                    await self.get_watching(
+                                        guild_data["online_watching"], "online_watching", guild.id
+                                    )
+                                )
+                                + "\n"
+                            )
+                        else:
+                            msg += f"**{name}**: Not set.\n"
+                    else:
+                        msg += f"**{name}**: {guild_data[attr]}\n"
+                em.description = msg
+                em.set_thumbnail(url=guild.icon_url)
+                await ctx.send(embed=em)
+            else:
+                msg = "```\n"
+                for attr, name in settings_name.items():
+                    if attr == "ping":
+                        role = guild.get_role(guild_data["ping"])
+                        if role:
+                            msg += f"{name}: {role.mention}\n"
+                        else:
+                            msg += f"{name}: Not set.\n"
+                    elif attr == "reporting":
+                        channel = guild.get_channel(guild_data["reporting"])
+                        if channel:
+                            msg += f"{name}: {channel.mention}\n"
+                        else:
+                            msg += f"{name}: Not set.\n"
+                    elif attr == "watching":
+                        if guild_data["watching"]:
+                            msg += (
+                                f"{name}: "
+                                + " ".join(
+                                    await self.get_watching(
+                                        guild_data["watching"], "watching", guild.id
+                                    )
+                                )
+                                + "\n"
+                            )
+                        else:
+                            msg += f"{name}: Not set."
+                    elif attr == "online_watching":
+                        if guild_data["online_watching"]:
+                            msg += (
+                                f"{name}: "
+                                + " ".join(
+                                    await self.get_watching(
+                                        guild_data["online_watching"], "online_watching", guild.id
+                                    )
+                                )
+                                + "\n"
+                            )
+                        else:
+                            msg += f"{name}: Not set.\n"
+                    else:
+                        msg += f"**{name}**: {guild_data[attr]}\n"
+                msg += "```"
+                await ctx.send(msg)
 
     @otherbot.command()
-    async def channel(self, ctx, channel: discord.TextChannel = None):
+    async def channel(self, ctx: commands.Context, channel: discord.TextChannel = None):
         """
         Sets the channel to report in.
         
@@ -37,9 +185,10 @@ class Otherbot(BaseCog):
             channel = ctx.channel
         await self.config.guild(ctx.guild).reporting.set(channel.id)
         await ctx.send(f"Reporting channel set to: {channel.mention}.")
+        await self.generate_cache()
 
     @otherbot.command()
-    async def pingrole(self, ctx, role_name: discord.Role = None):
+    async def pingrole(self, ctx: commands.Context, role_name: discord.Role = None):
         """Sets the role to use for pinging. Leave blank to reset it."""
         if not role_name:
             await self.config.guild(ctx.guild).ping.set(None)
@@ -47,55 +196,233 @@ class Otherbot(BaseCog):
         await self.config.guild(ctx.guild).ping.set(role_name.id)
         pingrole_id = await self.config.guild(ctx.guild).ping()
         pingrole_obj = discord.utils.get(ctx.guild.roles, id=pingrole_id)
-        await ctx.send(f"Ping role set to: {pingrole_obj.name}.")
+        await ctx.send(f"Ping role set to: `{pingrole_obj.name}`.")
+        await self.generate_cache()
 
-    @otherbot.command()
-    @checks.admin_or_permissions(manage_roles=True)
-    async def remove(self, ctx, bot_user: discord.Member = None):
-        """Remove a bot from the watching list."""
-        async with self.config.guild(ctx.guild).watching() as watch_list:
-            watch_list.remove(bot_user.id)
-        await ctx.send(f"Not watching {bot_user.mention} any more.")
+    @otherbot.group(name="watch", aliases=["watching"])
+    async def otherbot_watch(self, ctx: commands.Context):
+        """Watch settings."""
 
-    @otherbot.command()
-    @checks.admin_or_permissions(manage_roles=True)
-    async def watching(self, ctx, bot_user: discord.Member = None):
-        """Add a bot to watch. Leave blank to list existing bots on the list."""
-        data = await self.config.guild(ctx.guild).all()
-        msg = "```Watching these bots:\n"
-        if not data["watching"]:
-            msg += "None."
-        if not bot_user:
-            for saved_bot_id in data["watching"]:
-                bot_user = await self.bot.fetch_user(saved_bot_id)
-                if len(bot_user.name) > 16:
-                    bot_name = f"{bot_user.name:16}...#{bot_user.discriminator}"
-                else:
-                    bot_name = f"{bot_user.name}#{bot_user.discriminator}"
-                msg += f"{bot_name:24} ({bot_user.id})\n"
-            msg += "```"
-            return await ctx.send(msg)
-        if not bot_user.bot:
-            return await ctx.send("User is not a bot.")
-        async with self.config.guild(ctx.guild).watching() as watch_list:
-            watch_list.append(bot_user.id)
-        await ctx.send(f"Now watching: {bot_user.mention}.")
-        if not data["reporting"]:
-            await self.config.guild(ctx.guild).reporting.set(ctx.message.channel.id)
-            await ctx.send(
-                f"Reporting channel set to: {ctx.message.channel.mention}. Use `{ctx.prefix}otherbot channel` to change this."
+    @otherbot_watch.group(name="offline")
+    async def otherbot_watch_offline(self, ctx: commands.Context):
+        """Manage offline notifications."""
+
+    @otherbot_watch_offline.command(name="add")
+    async def otherbot_watch_offline_add(self, ctx: commands.Context, bot: discord.Member):
+        """Add a bot that will be tracked when it goes offline."""
+        if not bot.bot:
+            return await ctx.send(
+                "You can't track normal users. Please try again with a bot user."
             )
 
-    @listener()
-    async def on_member_update(self, before, after):
+        async with self.config.guild(ctx.guild).watching() as watch_list:
+            watch_list.append(bot.id)
+        await ctx.send(f"I will now track {bot.mention} when it goes offline.")
+        await self.generate_cache()
+
+    @otherbot_watch_offline.command(name="remove")
+    async def otherbot_watch_offline_remove(self, ctx: commands.Context, bot: discord.Member):
+        """Removes a bot currently tracked."""
+        if not bot.bot:
+            return await ctx.send(
+                "You can't choose a normal user. Please try again with a bot user."
+            )
+
+        async with self.config.guild(ctx.guild).watching() as watch_list:
+            try:
+                watch_list.remove(bot.id)
+                await ctx.send(
+                    f"Successfully removed {bot.mention} from offline tracked bot list."
+                )
+            except ValueError:
+                await ctx.send(f"{bot.mention} is not currently tracked.")
+        await self.generate_cache()
+
+    @otherbot_watch_offline.command(name="list")
+    async def otherbot_watch_offline_list(self, ctx: commands.Context):
+        """Lists currently tracked bots."""
+        watching = await self.config.guild(ctx.guild).watching()
+        if not watching:
+            return await ctx.send("There is currently no bots tracked for offline status.")
+
+        watching_list = await self.get_watching(watching, "watching", ctx.guild.id)
+        await ctx.send(
+            f"{len(watching):,} bot{'s' if len(watching) > 1 else ''} are currently tracked for offline status:\n"
+            + ", ".join(watching_list)
+        )
+        await self.generate_cache()
+
+    @otherbot_watch_offline.command(name="emoji")
+    async def otherbot_watch_offline_emoji(self, ctx: commands.Context, *, emoji: str = None):
+        """Choose which emoji that will be used for offline messages."""
+        if not emoji:
+            await self.config.guild(ctx.guild).offline_emoji.set(DEFAULT_OFFLINE_EMOJI)
+            await ctx.send(f"Offline emoji resetted to default: {DEFAULT_OFFLINE_EMOJI}")
+        else:
+            await self.config.guild(ctx.guild).offline_emoji.set(emoji)
+            await ctx.tick()
+        await self.generate_cache()
+
+    @otherbot_watch_offline.command(name="embed")
+    async def otherbot_watch_offline_embed(self, ctx: commands.Context):
+        """Set wether you want to receive notifications in embed or not."""
+        current = await self.config.guild(ctx.guild).embed_offline()
+        await self.config.guild(ctx.guild).embed_offline.set(not current)
+        await ctx.send(
+            "I will now send offline notifications in embeds."
+            if not current
+            else "I will no longer send offline notifications in embeds."
+        )
+        await self.generate_cache()
+
+    @otherbot_watch.group(name="online")
+    async def otherbot_watch_online(self, ctx: commands.Context):
+        """Manage online notifications."""
+
+    @otherbot_watch_online.command(name="add")
+    async def otherbot_watch_online_add(self, ctx: commands.Context, bot: discord.Member):
+        """Add a bot that will be tracked when it comes back online."""
+        if not bot.bot:
+            return await ctx.send(
+                "You can't track normal users. Please try again with a bot user."
+            )
+
+        async with self.config.guild(ctx.guild).online_watching() as watch_list:
+            watch_list.append(bot.id)
+        await ctx.send(f"I will now track {bot.mention} when it goes back online.")
+        await self.generate_cache()
+
+    @otherbot_watch_online.command(name="remove")
+    async def otherbot_watch_online_remove(self, ctx: commands.Context, bot: discord.Member):
+        """Removes a bot currently tracked."""
+        if not bot.bot:
+            return await ctx.send(
+                "You can't choose a normal user. Please try again with a bot user."
+            )
+
+        async with self.config.guild(ctx.guild).online_watching() as watch_list:
+            try:
+                watch_list.remove(bot.id)
+                await ctx.send(f"Successfully removed {bot.mention} from online tracked bot list.")
+            except ValueError:
+                await ctx.send(f"{bot.mention} is not currently tracked.")
+        await self.generate_cache()
+
+    @otherbot_watch_online.command(name="list")
+    async def otherbot_watch_online_list(self, ctx: commands.Context):
+        """Lists currently tracked bots."""
+        watching = await self.config.guild(ctx.guild).online_watching()
+        if not watching:
+            return await ctx.send("There is currently no bots tracked for online status.")
+
+        watching_list = await self.get_watching(watching, "online_watching", ctx.guild.id)
+        await ctx.send(
+            f"{len(watching):,} bot{'s' if len(watching) > 1 else ''} are currently tracked for online status:\n"
+            + ", ".join(watching_list)
+        )
+        await self.generate_cache()
+
+    @otherbot_watch_online.command(name="emoji")
+    async def otherbot_watch_online_emoji(self, ctx: commands.Context, *, emoji: str = None):
+        """Choose which emoji that will be used for online messages."""
+        if not emoji:
+            await self.config.guild(ctx.guild).online_emoji.set(DEFAULT_ONLINE_EMOJI)
+            await ctx.send(f"Online emoji resetted to default: {DEFAULT_ONLINE_EMOJI}")
+        else:
+            await self.config.guild(ctx.guild).online_emoji.set(emoji)
+            await ctx.tick()
+        await self.generate_cache()
+
+    @otherbot_watch_online.command(name="embed")
+    async def otherbot_watch_online_embed(self, ctx: commands.Context):
+        """Set wether you want to receive notifications in embed or not."""
+        current = await self.config.guild(ctx.guild).embed_online()
+        await self.config.guild(ctx.guild).embed_online.set(not current)
+        await ctx.send(
+            "I will now send online notifications in embeds."
+            if not current
+            else "I will no longer send online notifications in embeds."
+        )
+        await self.generate_cache()
+
+    @commands.Cog.listener()
+    async def on_member_update(self, before: discord.Member, after: discord.Member):
         if after.guild is None or not after.bot:
             return
-        data = await self.config.guild(after.guild).all()
-        if after.status == discord.Status.offline and (after.id in data["watching"]):
-            channel_object = self.bot.get_channel(data["reporting"])
-            if not data["ping"]:
-                await channel_object.send(f"{after.mention} is offline.")
-            else:
-                await channel_object.send(f'<@&{data["ping"]}>, {after.mention} is offline.')
-        else:
-            pass
+
+        data = self.otherbot_cache.get(after.guild.id)
+        if data is None:
+            return
+        channel = self.bot.get_channel(data["reporting"])
+        if not channel:
+            return
+        if not (data["watching"] or data["online_watching"]):
+            return
+        if (
+            before.status != discord.Status.offline
+            and after.status == discord.Status.offline
+            and (after.id in data["watching"])
+        ):
+            try:
+                if data["embed_offline"]:
+                    em = discord.Embed(
+                        color=0x8B0000,
+                        description=f"{after.mention} is offline. {data['offline_emoji']}",
+                        timestamp=datetime.utcnow(),
+                    )
+                    if not data["ping"]:
+                        await channel.send(embed=em)
+                    else:
+                        if discord.version_info.minor < 4:
+                            await channel.send(f"<@&{data['ping']}>", embed=em)
+                        else:
+                            await channel.send(
+                                f"<@&{data['ping']}>",
+                                embed=em,
+                                allowed_mentions=discord.AllowedMentions(roles=True),
+                            )
+                else:
+                    if not data["ping"]:
+                        await channel.send(f"{after.mention} is offline. {data['offline_emoji']}")
+                    else:
+                        await channel.send(
+                            f"<@&{data['ping']}>, {after.mention} is offline. {data['offline_emoji']}"
+                        )
+            except discord.Forbidden:
+                async with self.config.guild(after.guild).watching() as old_data:
+                    old_data.remove(after.id)
+        elif (
+            before.status == discord.Status.offline
+            and after.status != discord.Status.offline
+            and (after.id in data["online_watching"])
+        ):
+            try:
+                if data["embed_online"]:
+                    em = discord.Embed(
+                        color=0x008800,
+                        description=f"{after.mention} is back online. {data['online_emoji']}",
+                        timestamp=datetime.utcnow(),
+                    )
+                    if not data["ping"]:
+                        await channel.send(embed=em)
+                    else:
+                        if discord.version_info.minor < 4:
+                            await channel.send(f"<@&{data['ping']}>", embed=em)
+                        else:
+                            await channel.send(
+                                f"<@&{data['ping']}>",
+                                embed=em,
+                                allowed_mentions=discord.AllowedMentions(roles=True),
+                            )
+                else:
+                    if not data["ping"]:
+                        await channel.send(
+                            f"{after.mention} is back online. {data['online_emoji']}"
+                        )
+                    else:
+                        await channel.send(
+                            f"<@&{data['ping']}>, {after.mention} is back online. {data['online_emoji']}"
+                        )
+            except discord.Forbidden:
+                async with self.config.guild(after.guild).online_watching() as old_data:
+                    old_data.remove(after.id)

partycrash/__init__.py

@@ -1,5 +1,7 @@
 from .partycrash import PartyCrash
 
+__red_end_user_data_statement__ = "This cog does not persistently store data or metadata about users."
+
 
 def setup(bot):
     bot.add_cog(PartyCrash(bot))

partycrash/info.json

@@ -11,5 +11,6 @@
 	"tags": [
 		"invite"
 	],
-	"type": "COG"
+	"type": "COG",
+	"end_user_data_statement": "This cog does not persistently store data or metadata about users."
 }

partycrash/partycrash.py

@@ -4,12 +4,14 @@ from redbot.core.utils.chat_formatting import box, pagify
 import asyncio
 
 
-BaseCog = getattr(commands, "Cog", object)
-
-class PartyCrash(BaseCog):
+class PartyCrash(commands.Cog):
     """Partycrash inspired by v2 Admin by Will
        Does not generate invites, only lists existing invites."""
 
+    async def red_delete_data_for_user(self, **kwargs):
+        """ Nothing to delete """
+        return
+
     def __init__(self, bot):
         self.bot = bot
 
@@ -77,8 +79,6 @@ class PartyCrash(BaseCog):
                 try:
                     await self._get_invites(guild, ctx)
                 except discord.errors.Forbidden:
-                    return await ctx.send(
-                        f"I don't have permission to get invites for {guild.name}."
-                    )
+                    return await ctx.send(f"I don't have permission to get invites for {guild.name}.")
             except asyncio.TimeoutError:
                 return await ctx.send("No server number entered, try again later.")

pingtime/__init__.py

@@ -1,5 +1,7 @@
 from .pingtime import Pingtime
 
+__red_end_user_data_statement__ = "This cog does not persistently store data or metadata about users."
+
 
 def setup(bot):
     bot.add_cog(Pingtime(bot))

pingtime/info.json

@@ -9,5 +9,6 @@
 		"pingtime",
         "latency"
 	],
-	"type": "COG"
+	"type": "COG",
+	"end_user_data_statement": "This cog does not persistently store data or metadata about users."
 }

pingtime/pingtime.py

@@ -3,8 +3,14 @@ from redbot.core import commands
 
 BaseCog = getattr(commands, "Cog", object)
 
+
 class Pingtime(BaseCog):
     """🏓"""
+
+    async def red_delete_data_for_user(self, **kwargs):
+        """ Nothing to delete """
+        return
+
     def __init__(self, bot):
         self.bot = bot
 

pressf/__init__.py

@@ -1,4 +1,7 @@
 from .pressf import PressF
 
+__red_end_user_data_statement__ = "This cog does not persistently store data or metadata about users."
+
+
 def setup(bot):
     bot.add_cog(PressF(bot))

pressf/info.json

@@ -9,5 +9,6 @@
         "pressf",
         "respects"
     ],
-    "type": "COG"
+    "type": "COG",
+	"end_user_data_statement": "This cog does not persistently store data or metadata about users."
 }

pressf/pressf.py

@@ -7,6 +7,10 @@ from redbot.core.utils.common_filters import filter_mass_mentions
 class PressF(commands.Cog):
     """Pay some respects."""
 
+    async def red_delete_data_for_user(self, **kwargs):
+        """ Nothing to delete """
+        return
+
     def __init__(self, bot):
         self.bot = bot
         self.channels = {}
@@ -41,13 +45,13 @@ class PressF(commands.Cog):
             f"Everyone, let's pay respects to **{filter_mass_mentions(answer)}**! Press the f reaction on the this message to pay respects."
         )
         await message.add_reaction("\U0001f1eb")
-        self.channels[str(ctx.channel.id)] = {'msg_id': message.id, 'reacted': []}
+        self.channels[str(ctx.channel.id)] = {"msg_id": message.id, "reacted": []}
         await asyncio.sleep(120)
         try:
             await message.delete()
         except (discord.errors.NotFound, discord.errors.Forbidden):
             pass
-        amount = len(self.channels[str(ctx.channel.id)]['reacted'])
+        amount = len(self.channels[str(ctx.channel.id)]["reacted"])
         word = "person has" if amount == 1 else "people have"
         await ctx.send(f"**{amount}** {word} paid respects to **{filter_mass_mentions(answer)}**.")
         del self.channels[str(ctx.channel.id)]
@@ -56,11 +60,11 @@ class PressF(commands.Cog):
     async def on_reaction_add(self, reaction, user):
         if str(reaction.message.channel.id) not in self.channels:
             return
-        if self.channels[str(reaction.message.channel.id)]['msg_id'] != reaction.message.id:
+        if self.channels[str(reaction.message.channel.id)]["msg_id"] != reaction.message.id:
             return
         if user.id == self.bot.user.id:
             return
-        if user.id not in self.channels[str(reaction.message.channel.id)]['reacted']:
+        if user.id not in self.channels[str(reaction.message.channel.id)]["reacted"]:
             if str(reaction.emoji) == "\U0001f1eb":
                 await reaction.message.channel.send(f"**{user.name}** has paid their respects.")
-                self.channels[str(reaction.message.channel.id)]['reacted'].append(user.id)
+                self.channels[str(reaction.message.channel.id)]["reacted"].append(user.id)

pupper/__init__.py

@@ -1,5 +1,7 @@
 from .pupper import Pupper
 
+__red_end_user_data_statement__ = "This cog does not persistently store data or metadata about users."
+
 
 async def setup(bot):
     bot.add_cog(Pupper(bot))

pupper/info.json

@@ -8,5 +8,6 @@
 	"tags": [
 		"pets"
 	],
-	"type": "COG"
+	"type": "COG",
+	"end_user_data_statement": "This cog does not persistently store data or metadata about users."
 }

pupper/pupper.py

@@ -1,12 +1,21 @@
 import asyncio
 import datetime
 import discord
+import logging
 import random
 from redbot.core import commands, checks, Config, bank
-from redbot.core.utils.chat_formatting import box, humanize_list
+from redbot.core.errors import BalanceTooHigh
+from redbot.core.utils.chat_formatting import box, humanize_list, pagify
+
+
+log = logging.getLogger("red.aikaterna.pupper")
 
 
 class Pupper(commands.Cog):
+    async def red_delete_data_for_user(self, **kwargs):
+        """ Nothing to delete """
+        return
+
     def __init__(self, bot):
         self.bot = bot
         self.config = Config.get_conf(self, 2767241393, force_registration=True)
@@ -20,6 +29,7 @@ class Pupper(commands.Cog):
             "hello_msg": "Hi! Can someone pet me?",
             "last_pet": "2019-08-01 00:00:00.000001",
             "toggle": False,
+            "delete_after": 10,
         }
 
         self.config.register_guild(**default_guild)
@@ -29,14 +39,57 @@ class Pupper(commands.Cog):
     @commands.group()
     async def pets(self, ctx):
         """Manage your pet."""
-        pass
+        if ctx.invoked_subcommand is None:
+            guild_data = await self.config.guild(ctx.guild).all()
+            if not guild_data["channel"]:
+                channel_names = ["No channels set."]
+            else:
+                channel_names = []
+                for channel_id in guild_data["channel"]:
+                    channel_obj = self.bot.get_channel(channel_id)
+                    channel_names.append(channel_obj.name)
+
+            space = "\N{EN SPACE}"
+            toggle = "Active" if guild_data["toggle"] else "Inactive"
+            delete_after = "No deletion" if not guild_data["delete_after"] else guild_data["delete_after"]
+
+            msg = f"[Channels]:       {humanize_list(channel_names)}\n"
+            msg += f"[Cooldown]:       {guild_data['cooldown']} seconds\n"
+            msg += f"[Credit range]:   {guild_data['credits'][0]} - {guild_data['credits'][1]} credits\n"
+            msg += f"[Delete after]:   {delete_after}\n"
+            msg += f"[Toggle]:         {toggle}\n"
+            msg += f"{space}\n"
+            msg += f"[Hello message]:  {guild_data['hello_msg']}\n"
+            msg += f"[Thanks message]: {guild_data['borf_msg']}\n"
+
+            for page in pagify(msg, delims=["\n"]):
+                await ctx.send(box(page, lang="ini"))
 
     @pets.command()
     async def toggle(self, ctx):
         """Toggle pets on the server."""
         toggle = await self.config.guild(ctx.guild).toggle()
-        msg = f"Pets active: {not toggle}.\n"
         await self.config.guild(ctx.guild).toggle.set(not toggle)
+        await ctx.send(f"The pet is now {'' if not toggle else 'in'}active.")
+
+    @pets.command()
+    async def delete(self, ctx, amount: int = 0):
+        """
+        Set how long to wait before deleting the thanks message.
+        To leave the thanks message with no deletion, use 0 as the amount.
+        10 is the default.
+        Max is 5 minutes (300).
+		"""
+        if amount < 0:
+            return await ctx.send("Use a positive number.")
+        if 1 <= amount <= 5:
+            return await ctx.send("Use a slightly larger number, greater than 5.")
+        if amount > 300:
+            return await ctx.send("Use a smaller number, less than or equal to 300.")
+
+        set_amount = None if amount == 0 else amount
+        await self.config.guild(ctx.guild).delete_after.set(set_amount)
+        msg = f"Timer set to {amount}." if set_amount else "Delete timer has been turned off."
         await ctx.send(msg)
 
     @pets.command()
@@ -95,13 +148,13 @@ class Pupper(commands.Cog):
         """Channel management for pet appearance."""
         await ctx.send_help()
         channel_list = await self.config.guild(ctx.guild).channel()
-        channel_msg = "Petting Channels:\n"
+        channel_msg = "[Petting Channels]:\n"
         if not channel_list:
             channel_msg += "None."
         for chan in channel_list:
             channel_obj = self.bot.get_channel(chan)
             channel_msg += f"{channel_obj.name}\n"
-        await ctx.send(box(channel_msg))
+        await ctx.send(box(channel_msg, lang="ini"))
 
     @channel.command()
     async def add(self, ctx, channel: discord.TextChannel):
@@ -118,9 +171,7 @@ class Pupper(commands.Cog):
     async def addall(self, ctx):
         """Add all valid channels for the guild that the bot can speak in."""
         bot_text_channels = [
-            c
-            for c in ctx.guild.text_channels
-            if c.permissions_for(ctx.guild.me).send_messages is True
+            c for c in ctx.guild.text_channels if c.permissions_for(ctx.guild.me).send_messages is True
         ]
         channel_list = await self.config.guild(ctx.guild).channel()
         channels_appended = []
@@ -138,13 +189,9 @@ class Pupper(commands.Cog):
         second_msg = ""
         await self.config.guild(ctx.guild).channel.set(channel_list)
         if len(channels_appended) > 0:
-            first_msg = (
-                f"{humanize_list(channels_appended)} added to the valid petting channels.\n"
-            )
+            first_msg = f"{humanize_list(channels_appended)} added to the valid petting channels.\n"
         if len(channels_in_list) > 0:
-            second_msg = (
-                f"{humanize_list(channels_in_list)}: already in the list of petting channels."
-            )
+            second_msg = f"{humanize_list(channels_in_list)}: already in the list of petting channels."
         await ctx.send(f"{first_msg}{second_msg}")
 
     @channel.command()
@@ -172,54 +219,61 @@ class Pupper(commands.Cog):
 
     @commands.Cog.listener()
     async def on_message(self, message):
-        if isinstance(message.channel, discord.abc.PrivateChannel):
-            return
-        if message.author.bot:
-            return
-        guild_data = await self.config.guild(message.guild).all()
-        if not guild_data["toggle"]:
-            return
-        if not guild_data["channel"]:
-            return
-        self.pets.setdefault(message.guild.id, False)
-        if self.pets[message.guild.id]:
-            return
+        try:
+            if isinstance(message.channel, discord.abc.PrivateChannel):
+                return
+            if message.author.bot:
+                return
+            guild_data = await self.config.guild(message.guild).all()
+            if not guild_data["toggle"]:
+                return
+            if not guild_data["channel"]:
+                return
+            self.pets.setdefault(message.guild.id, False)
+            if self.pets[message.guild.id]:
+                return
 
-        last_time = datetime.datetime.strptime(str(guild_data["last_pet"]), "%Y-%m-%d %H:%M:%S.%f")
-        now = datetime.datetime.now(datetime.timezone.utc)
-        now = now.replace(tzinfo=None)
-        if (
-            int((now - last_time).total_seconds())
-            > await self.config.guild(message.guild).cooldown()
-        ):
-            self._pet_lock(message.guild.id, True)
-            rando_channel = random.choice(guild_data["channel"])
-            await asyncio.sleep(random.randint(60, 480))
-            rando_channel_obj = self.bot.get_channel(rando_channel)
-            borf_msg = await rando_channel_obj.send(guild_data["hello_msg"])
-            pets = "👋"
-            pets_action = {"veryfastpats": "👋"}
+            last_time = datetime.datetime.strptime(str(guild_data["last_pet"]), "%Y-%m-%d %H:%M:%S.%f")
+            now = datetime.datetime.now(datetime.timezone.utc)
+            now = now.replace(tzinfo=None)
+            if int((now - last_time).total_seconds()) > await self.config.guild(message.guild).cooldown():
+                self._pet_lock(message.guild.id, True)
+                rando_channel = random.choice(guild_data["channel"])
+                await asyncio.sleep(random.randint(60, 480))
+                rando_channel_obj = self.bot.get_channel(rando_channel)
+                borf_msg = await rando_channel_obj.send(guild_data["hello_msg"])
+                pets = "👋"
+                pets_action = {"veryfastpats": "👋"}
 
-            def check(r, u):
-                return r.message.id == borf_msg.id and any(e in str(r.emoji) for e in pets)
+                def check(r, u):
+                    return r.message.id == borf_msg.id and any(e in str(r.emoji) for e in pets)
 
-            try:
-                r, u = await self.bot.wait_for("reaction_add", check=check, timeout=300.0)
-            except asyncio.TimeoutError:
-                return await borf_msg.delete()
+                try:
+                    r, u = await self.bot.wait_for("reaction_add", check=check, timeout=300.0)
+                except asyncio.TimeoutError:
+                    return await borf_msg.delete()
 
-            reacts = {v: k for k, v in pets_action.items()}
-            react = reacts[r.emoji]
-            if react == "veryfastpats":
-                await borf_msg.delete()
-                deposit = random.randint(guild_data["credits"][0], guild_data["credits"][1])
-                await bank.deposit_credits(u, deposit)
-                credits_name = await bank.get_currency_name(message.guild)
-                await rando_channel_obj.send(
-                    content=f"{guild_data['borf_msg']} (`+{deposit}` {credits_name})",
-                    delete_after=10,
-                )
-            else:
-                pass
-            self._pet_lock(message.guild.id, False)
-            await self.config.guild(message.guild).last_pet.set(str(now))
+                reacts = {v: k for k, v in pets_action.items()}
+                react = reacts[r.emoji]
+                if react == "veryfastpats":
+                    await borf_msg.delete()
+                    deposit = random.randint(guild_data["credits"][0], guild_data["credits"][1])
+                    try:
+                        large_bank = False
+                        await bank.deposit_credits(u, deposit)
+                    except BalanceTooHigh as e:
+                        large_bank = True
+                        await bank.set_balance(u, e.max_balance)
+                    credits_name = await bank.get_currency_name(message.guild)
+                    msg = (
+                        f"{guild_data['borf_msg']} (`+{deposit}` {credits_name})"
+                        if not large_bank
+                        else guild_data["borf_msg"]
+                    )
+                    await rando_channel_obj.send(content=msg, delete_after=guild_data["delete_after"])
+                else:
+                    pass
+                self._pet_lock(message.guild.id, False)
+                await self.config.guild(message.guild).last_pet.set(str(now))
+        except Exception:
+            log.error("Error in pupper loop.", exc_info=True)

quiz/__init__.py

@@ -0,0 +1,7 @@
+from .quiz import Quiz
+
+__red_end_user_data_statement__ = "This cog does not persistently store data or metadata about users."
+
+
+def setup(bot):
+    bot.add_cog(Quiz(bot))

quiz/info.json

@@ -0,0 +1,9 @@
+{
+	"author": ["Keane", "aikaterna"],
+	"description": "Play a kahoot-like trivia game.",
+	"install_msg": "Thanks for installing.",
+	"short": "Play a kahoot-like trivia game.",
+	"tags": ["trivia", "quiz"],
+	"type": "COG",
+	"end_user_data_statement": "This cog does not persistently store data or metadata about users."
+}

quiz/quiz.py

@@ -0,0 +1,530 @@
+import aiohttp
+import asyncio
+import datetime
+import discord
+import html
+import logging
+import math
+import random
+import time
+
+from redbot.core import bank, checks, commands, Config
+from redbot.core.errors import BalanceTooHigh
+from redbot.core.utils.chat_formatting import box
+
+
+log = logging.getLogger("red.aikaterna.quiz")
+
+
+def check_global_setting_admin():
+    """
+    Command decorator. If the bank is not global, it checks if the author is
+    either a bot admin or has the manage_guild permission.
+    """
+
+    async def pred(ctx: commands.Context):
+        author = ctx.author
+        if not await bank.is_global():
+            if not isinstance(ctx.channel, discord.abc.GuildChannel):
+                return False
+            if await ctx.bot.is_owner(author):
+                return True
+            if author == ctx.guild.owner:
+                return True
+            if ctx.channel.permissions_for(author).manage_guild:
+                return True
+            admin_role_ids = await ctx.bot.get_admin_role_ids(ctx.guild.id)
+            for role in author.roles:
+                if role.id in admin_role_ids:
+                    return True
+        else:
+            return await ctx.bot.is_owner(author)
+
+    return commands.check(pred)
+
+
+class Quiz(commands.Cog):
+    """
+    Play a kahoot-like trivia game with questions from Open Trivia Database.
+    Originally by Keane for Red v2
+    """
+
+    async def red_delete_data_for_user(self, **kwargs):
+        """ Nothing to delete """
+        return
+
+    def __init__(self, bot):
+        self.bot = bot
+
+        self.game_tasks = []
+        self.playing_channels = {}
+        self.session = aiohttp.ClientSession()
+        self.starter_task = self.bot.loop.create_task(self.start_loop())
+
+        self.config = Config.get_conf(self, 2782511001, force_registration=True)
+        default_guild = {
+            "afk": 3,
+            "multiplier": 100,
+            "questions": 20,
+            "show_answer": True,
+            "token": None,
+        }
+        self.config.register_guild(**default_guild)
+
+    @commands.guild_only()
+    @commands.group()
+    async def quiz(self, ctx):
+        """Play a kahoot-like trivia game.
+        Questions from the Open Trivia Database.
+
+        In this game, you will compete with other players to correctly answer each
+        question as quickly as you can. You have 10 seconds to type the answer
+        choice before time runs out. The longer you take to say the right answer,
+        the fewer points you get. If you get it wrong, you get no points. Only the
+        first valid answer (A, B, C, or D) will be recorded - be sure of the
+        answer before replying!
+
+        To end the game, stop responding to the questions and the game will time out.
+        """
+        pass
+
+    @quiz.command(name="play")
+    async def quiz_play(self, ctx, *, category_name_or_id=None):
+        """
+        Create or join a quiz game.
+        Specify a category name or ID number, otherwise it will be random.
+        Use [p]quiz categories to list category names or id numbers.
+        """
+        channel = ctx.message.channel
+        player = ctx.message.author
+
+        if not category_name_or_id:
+            # random
+            category_id = await self.category_selector()
+            category_name = await self.category_name_from_id(category_id)
+
+        elif category_name_or_id.isdigit():
+            # cat id specified
+            if 9 <= int(category_name_or_id) >= 32:
+                return await ctx.send(f"Invalid category number. Use `{ctx.prefix}quiz categories` to see a list.")
+            category_id = category_name_or_id
+            category_name = await self.category_name_from_id(int(category_name_or_id))
+        else:
+            # cat name specified
+            try:
+                category_name = await self.category_name_match(category_name_or_id)
+            except RuntimeError:
+                return await ctx.send(f"Invalid category name. Use `{ctx.prefix}quiz categories` to see a list.")
+            category_id = await self.category_id_from_name(category_name)
+
+        if channel.id not in self.playing_channels:
+            self.playing_channels[channel.id] = {
+                "Start": datetime.datetime.utcnow(),
+                "Started": False,
+                "Players": {player.id: 0},
+                "Answers": {},
+                "Category": str(category_name),
+                "CategoryID": int(category_id),
+            }
+            return await ctx.send(
+                f"{player.display_name} is starting a quiz game!\n"
+                f"Category: `{category_name}`\n"
+                f"It will start in 30 seconds. Use `{ctx.prefix}quiz play` to join."
+            )
+
+        channelinfo = self.playing_channels[channel.id]
+        if player.id in channelinfo["Players"]:
+            await ctx.send("You are already in the game.")
+        elif channelinfo["Started"]:
+            await ctx.send("A quiz game is already underway.")
+        else:
+            channelinfo["Players"][player.id] = 0
+            await ctx.send(f"{player.display_name} joined the game.")
+
+    @quiz.command(name="categories")
+    async def quiz_cat(self, ctx):
+        """List quiz categories."""
+        async with self.session.get("https://opentdb.com/api_category.php") as response:
+            response_json = await response.json()
+            msg = f"[Category Name]{' ' * 24}[ID]\n"
+            for cat_dict in response_json["trivia_categories"]:
+                padding = 40 - len(cat_dict["name"])
+                msg += f"{cat_dict['name']}{' ' * padding}{cat_dict['id']}\n"
+        embed = discord.Embed(description=box(msg, lang="ini"))
+        await ctx.send(embed=embed)
+
+    @commands.guild_only()
+    @commands.group()
+    @checks.mod_or_permissions(manage_guild=True)
+    async def quizset(self, ctx):
+        """Quiz settings."""
+        if ctx.invoked_subcommand is None:
+            guild_data = await self.config.guild(ctx.guild).all()
+            msg = (
+                f"[Quiz Settings for {ctx.guild.name}]\n"
+                f"AFK questions before end: {guild_data['afk']}\n"
+                f"Credit multiplier:        {guild_data['multiplier']}x\n"
+                f"Number of questions:      {guild_data['questions']}\n"
+                f"Reveal correct answer:    {guild_data['show_answer']}\n"
+            )
+            await ctx.send(box(msg, lang="ini"))
+
+    @quizset.command(name="afk")
+    async def quizset_afk(self, ctx, questions: int):
+        """Set number of questions before the game ends due to non-answers."""
+        if 1 <= questions <= 10:
+            await self.config.guild(ctx.guild).afk.set(questions)
+            plural = "" if int(questions) == 1 else "s"
+            return await ctx.send(
+                f"{questions} question{plural} will be asked before the game times out. "
+                "A question will be counted in this afk count if 0 or 1 person answers. "
+                "2 or more answers on a question will not trigger this counter."
+            )
+        await ctx.send("Please use a number between 1 and 10. The default is 3.")
+
+    @quizset.command(name="show")
+    async def quizset_show(self, ctx):
+        """Toggle revealing the answers."""
+        show = await self.config.guild(ctx.guild).show_answer()
+        await self.config.guild(ctx.guild).show_answer.set(not show)
+        await ctx.send(f"Question answers will be revealed during the game: {not show}")
+
+    @quizset.command(name="questions")
+    async def quizset_questions(self, ctx, questions: int):
+        """Set number of questions per game."""
+        if 5 <= questions <= 50:
+            await self.config.guild(ctx.guild).questions.set(questions)
+            return await ctx.send(f"Number of questions per game: {questions}")
+        await ctx.send("Please use a number between 5 and 50. The default is 20.")
+
+    @check_global_setting_admin()
+    @quizset.command(name="multiplier")
+    async def quizset_multiplier(self, ctx, multiplier: int):
+        """
+        Set the credit multiplier.
+        The accepted range is 0 - 10000.
+        0 will turn credit gain off.
+        Credit gain will be based on the number of questions set and user speed.
+        1x = A small amount of credits like 1-10.
+        100x = A handful of credits: 100-500.
+        10000x = Quite a lot of credits, around 10k to 50k.
+		"""
+        if 0 <= multiplier <= 10000:
+            await self.config.guild(ctx.guild).multiplier.set(multiplier)
+            credits_name = await bank.get_currency_name(ctx.guild)
+            return await ctx.send(f"Credit multipilier: `{multiplier}x`")
+        await ctx.send("Please use a number between 0 and 10000. The default is 100.")
+
+    async def start_loop(self):
+        """Starts quiz games when the timeout period ends."""
+        try:
+            while True:
+                for channelid in list(self.playing_channels):
+                    channelinfo = self.playing_channels[channelid]
+                    since_start = (datetime.datetime.utcnow() - channelinfo["Start"]).total_seconds()
+
+                    if since_start > 30 and not channelinfo["Started"]:
+                        channel = self.bot.get_channel(channelid)
+                        if len(channelinfo["Players"]) > 1:
+                            channelinfo["Started"] = True
+                            task = self.bot.loop.create_task(self.game(channel))
+                            self.game_tasks.append(task)
+                        else:
+                            await channel.send("Nobody else joined the quiz game.")
+                            self.playing_channels.pop(channelid)
+                await asyncio.sleep(2)
+        except Exception:
+            log.error("Error in Quiz start loop.", exc_info=True)
+
+    async def game(self, channel):
+        """Runs a quiz game on a channel."""
+        channelinfo = self.playing_channels[channel.id]
+        category = channelinfo["CategoryID"]
+        category_name = channelinfo["Category"]
+
+        try:
+            response = await self.get_questions(channel.guild, category=channelinfo["CategoryID"])
+        except RuntimeError:
+            await channel.send("An error occurred in retrieving questions. Please try again.")
+            self.playing_channels.pop(channel.id)
+            raise
+
+        # Introduction
+        intro = (
+            f"Welcome to the quiz game! Your category is `{category_name}`.\n"
+            "Remember to answer correctly as quickly as you can for more points.\n"
+            "You have 10 seconds per question: the timer is shown in reactions on each question.\n"
+            "The game will begin shortly."
+        )
+        await channel.send(intro)
+        await asyncio.sleep(4)
+
+        # Question and Answer
+        afk_questions = 0
+        for index, dictionary in enumerate(response["results"]):
+            answers = [dictionary["correct_answer"]] + dictionary["incorrect_answers"]
+
+            # Display question and countdown
+            if len(answers) == 2:  # true/false question
+                answers = ["True", "False", "", ""]
+            else:
+                answers = [html.unescape(answer) for answer in answers]
+                random.shuffle(answers)
+
+            message = ""
+            message += html.unescape(dictionary["question"]) + "\n"
+            message += f"A. {answers[0]}\n"
+            message += f"B. {answers[1]}\n"
+            message += f"C. {answers[2]}\n"
+            message += f"D. {answers[3]}\n"
+
+            message_obj = await channel.send(box(message))
+            await message_obj.add_reaction("0⃣")
+            channelinfo["Answers"].clear()  # clear the previous question's answers
+            start_time = time.perf_counter()
+
+            numbers = ["1⃣", "2⃣", "3⃣", "4⃣", "5⃣", "6⃣", "7⃣", "8⃣", "9⃣", "🔟"]
+            for i in range(10):
+                if len(channelinfo["Answers"]) == len(channelinfo["Players"]):
+                    break
+                await asyncio.sleep(1)
+                await message_obj.add_reaction(numbers[i])
+
+            # Organize answers
+            user_answers = channelinfo["Answers"]
+            # snapshot channelinfo["Answers"] at this point in time
+            # to ignore new answers that are added to it
+            answerdict = {["a", "b", "c", "d"][num]: answers[num] for num in range(4)}
+
+            # Check for AFK
+            if len(user_answers) < 2:
+                afk_questions += 1
+                afk_count = await self.config.guild(channel.guild).afk()
+                if afk_questions == int(afk_count):
+                    await channel.send("The game has been cancelled due to lack of participation.")
+                    self.playing_channels.pop(channel.id)
+                    return
+            else:
+                afk_questions = 0
+
+            # Find and display correct answer
+            correct_letter = ""
+            for letter, answer in answerdict.items():
+                if answer == html.unescape(dictionary["correct_answer"]):
+                    correct_letter = letter
+                    break
+            assert answerdict[correct_letter] == html.unescape(dictionary["correct_answer"])
+
+            if await self.config.guild(channel.guild).show_answer():
+                message = f"Correct answer:```{correct_letter.upper()}. {answerdict[correct_letter]}```"
+                await channel.send(message)
+
+            # Assign scores
+            for playerid in user_answers:
+                if user_answers[playerid]["Choice"] == correct_letter:
+                    time_taken = user_answers[playerid]["Time"] - start_time
+                    assert time_taken > 0
+                    if time_taken < 1:
+                        channelinfo["Players"][playerid] += 1000
+                    else:
+                        # the 20 in the formula below is 2 * 10s (max answer time)
+                        channelinfo["Players"][playerid] += round(1000 * (1 - (time_taken / 20)))
+
+            # Display top 5 players and their points
+            message = self.scoreboard(channel)
+            await channel.send("Scoreboard:\n" + message)
+            await asyncio.sleep(4)
+
+            questions = await self.config.guild(channel.guild).questions()
+            if index < (int(questions) - 1):
+                await channel.send("Next question...")
+                await asyncio.sleep(1)
+
+        await self.end_game(channel)
+
+    async def end_game(self, channel):
+        """Ends a quiz game."""
+        # non-linear credit earning .0002x^{2.9} where x is score/100
+        channelinfo = self.playing_channels[channel.id]
+        idlist = sorted(list(channelinfo["Players"]), key=(lambda idnum: channelinfo["Players"][idnum]), reverse=True,)
+
+        winner = channel.guild.get_member(idlist[0])
+        await channel.send(f"Game over! {winner.mention} won!")
+
+        multiplier = await self.config.guild(channel.guild).multiplier()
+        if multiplier == 0:
+            self.playing_channels.pop(channel.id)
+            return
+
+        leaderboard = "\n"
+        max_credits = self.calculate_credits(channelinfo["Players"][idlist[0]])
+        end_len = len(str(max_credits)) + 1
+        rank_len = len(str(len(channelinfo["Players"])))
+        rank = 1
+
+        for playerid in idlist:
+            player = channel.guild.get_member(playerid)
+
+            if len(player.display_name) > 25 - rank_len - end_len:
+                name = player.display_name[: 22 - rank_len - end_len] + "..."
+            else:
+                name = player.display_name
+
+            leaderboard += str(rank)
+            leaderboard += " " * (1 + rank_len - len(str(rank)))
+            leaderboard += name
+            creds = self.calculate_credits(channelinfo["Players"][playerid]) * int(multiplier)
+            creds_str = str(creds)
+            leaderboard += " " * (26 - rank_len - 1 - len(name) - len(creds_str))
+            leaderboard += creds_str + "\n"
+
+            try:
+                await bank.deposit_credits(player, creds)
+            except BalanceTooHigh as e:
+                await bank.set_balance(player, e.max_balance)
+
+            rank += 1
+
+        await channel.send("Credits earned:\n" + box(leaderboard, lang="py"))
+        self.playing_channels.pop(channel.id)
+
+    def scoreboard(self, channel):
+        """Returns a scoreboard string to be sent to the text channel."""
+        channelinfo = self.playing_channels[channel.id]
+        scoreboard = "\n"
+        idlist = sorted(list(channelinfo["Players"]), key=(lambda idnum: channelinfo["Players"][idnum]), reverse=True,)
+        max_score = channelinfo["Players"][idlist[0]]
+        end_len = len(str(max_score)) + 1
+        rank = 1
+        for playerid in idlist[:5]:
+            player = channel.guild.get_member(playerid)
+            if len(player.display_name) > 24 - end_len:
+                name = player.display_name[: 21 - end_len] + "..."
+            else:
+                name = player.display_name
+            scoreboard += str(rank) + " " + name
+            score_str = str(channelinfo["Players"][playerid])
+            scoreboard += " " * (24 - len(name) - len(score_str))
+            scoreboard += score_str + "\n"
+            rank += 1
+        return box(scoreboard, lang="py")
+
+    def calculate_credits(self, score):
+        """Calculates credits earned from a score."""
+        adjusted = score / 100
+        if adjusted < 156.591:
+            result = 0.0002 * (adjusted ** 2.9)
+        else:
+            result = (0.6625 * math.exp(0.0411 * adjusted)) + 50
+        return round(result)
+
+    @commands.Cog.listener()
+    async def on_message_without_command(self, message):
+        if not message.guild:
+            return
+        authorid = message.author.id
+        channelid = message.channel.id
+        choice = message.content.lower()
+        if channelid in self.playing_channels:
+            channelinfo = self.playing_channels[channelid]
+            if (
+                authorid in channelinfo["Players"]
+                and authorid not in channelinfo["Answers"]
+                and choice in {"a", "b", "c", "d"}
+            ):
+                channelinfo["Answers"][authorid] = {"Choice": choice, "Time": time.perf_counter()}
+
+    # OpenTriviaDB API functions
+    async def get_questions(self, server, category=None, difficulty=None):
+        """Gets questions, resetting a token or getting a new one if necessary."""
+        questions = await self.config.guild(server).questions()
+        parameters = {"amount": questions}
+        if category:
+            parameters["category"] = category
+        if difficulty:
+            parameters["difficulty"] = difficulty
+        for _ in range(3):
+            parameters["token"] = await self.get_token(server)
+            async with self.session.get("https://opentdb.com/api.php", params=parameters) as response:
+                response_json = await response.json()
+                response_code = response_json["response_code"]
+                if response_code == 0:
+                    return response_json
+                elif response_code == 1:
+                    raise RuntimeError("Question retrieval unsuccessful. Response code from OTDB: 1")
+                elif response_code == 2:
+                    raise RuntimeError("Question retrieval unsuccessful. Response code from OTDB: 2")
+                elif response_code == 3:
+                    # Token expired. Obtain new one.
+                    log.debug("Quiz: Response code from OTDB: 3")
+                    await self.config.guild(server).token.set(None)
+                elif response_code == 4:
+                    # Token empty. Reset it.
+                    log.debug("Quiz: Response code from OTDB: 4")
+                    await self.reset_token(server)
+        raise RuntimeError("Failed to retrieve questions.")
+
+    async def get_token(self, server):
+        """Gets the provided server's token, or generates
+        and saves one if one doesn't exist."""
+        token = await self.config.guild(server).token()
+        if not token:
+            async with self.session.get("https://opentdb.com/api_token.php", params={"command": "request"}) as response:
+                response_json = await response.json()
+                token = response_json["token"]
+                await self.config.guild(server).token.set(token)
+        return token
+
+    async def reset_token(self, server):
+        """Resets the provided server's token."""
+        token = await self.config.guild(server).token()
+        async with self.session.get(
+            "https://opentdb.com/api_token.php", params={"command": "reset", "token": token}
+        ) as response:
+            response_code = (await response.json())["response_code"]
+            if response_code != 0:
+                raise RuntimeError(f"Token reset was unsuccessful. Response code from OTDB: {response_code}")
+
+    async def category_selector(self):
+        """Chooses a random category that has enough questions."""
+        for _ in range(10):
+            category = random.randint(9, 32)
+            async with self.session.get("https://opentdb.com/api_count.php", params={"category": category}) as response:
+                response_json = await response.json()
+                assert response_json["category_id"] == category
+                if response_json["category_question_count"]["total_question_count"] > 39:
+                    return category
+        raise RuntimeError("Failed to select a category.")
+
+    async def category_name_from_id(self, idnum):
+        """Finds a category's name from its number."""
+        async with self.session.get("https://opentdb.com/api_category.php") as response:
+            response_json = await response.json()
+            for cat_dict in response_json["trivia_categories"]:
+                if cat_dict["id"] == idnum:
+                    return cat_dict["name"]
+        raise RuntimeError("Failed to find category's name.")
+
+    async def category_name_match(self, name):
+        """Check if a category name exists."""
+        async with self.session.get("https://opentdb.com/api_category.php") as response:
+            response_json = await response.json()
+            for cat_dict in response_json["trivia_categories"]:
+                if cat_dict["name"].lower() == name.lower():
+                    return cat_dict["name"]
+        raise RuntimeError("Failed to find category's name.")
+
+    async def category_id_from_name(self, name):
+        """Finds a category's name from its number."""
+        async with self.session.get("https://opentdb.com/api_category.php") as response:
+            response_json = await response.json()
+            for cat_dict in response_json["trivia_categories"]:
+                if cat_dict["name"] == name:
+                    return cat_dict["id"]
+        raise RuntimeError("Failed to find category's id.")
+
+    def cog_unload(self):
+        self.bot.loop.create_task(self.session.close())
+        self.starter_task.cancel()
+        for task in self.game_tasks:
+            task.cancel()

region/__init__.py

@@ -1,5 +1,7 @@
 from .region import Region
 
+__red_end_user_data_statement__ = "This cog does not persistently store data or metadata about users."
+
 
 def setup(bot):
     bot.add_cog(Region())

region/info.json

@@ -5,5 +5,6 @@
     "description" : "Change the Discord server's region with a command.",
     "install_msg" : "Thanks for installing.",
     "tags" : ["voice region", "region"],
-    "disabled" : false
+    "disabled" : false,
+    "end_user_data_statement": "This cog does not persistently store data or metadata about users."
 }

region/region.py

@@ -6,6 +6,10 @@ from redbot.core.utils.chat_formatting import humanize_list
 class Region(commands.Cog):
     """Change the guild voice region."""
 
+    async def red_delete_data_for_user(self, **kwargs):
+        """ Nothing to delete """
+        return
+
     @checks.mod_or_permissions(administrator=True)
     @commands.cooldown(1, 60, discord.ext.commands.BucketType.guild)
     @commands.command()
@@ -44,6 +48,4 @@ class Region(commands.Cog):
             return await ctx.send("I don't have permissions to edit this guild's settings.")
         except discord.errors.HTTPException:
             return await ctx.send(f"Error: An invalid server region was passed: `{region}`")
-        await ctx.send(
-            f"The voice server region for `{ctx.guild.name}` has been changed to `{region}`."
-        )
+        await ctx.send(f"The voice server region for `{ctx.guild.name}` has been changed to `{region}`.")

retrosign/__init__.py

@@ -1,5 +1,7 @@
 from .retrosign import Retrosign
 
+__red_end_user_data_statement__ = "This cog does not persistently store data or metadata about users."
+
 
 def setup(bot):
     bot.add_cog(Retrosign(bot))

retrosign/info.json

@@ -15,5 +15,6 @@
 		"retro",
         "80s"
 	],
-	"type": "COG"
+	"type": "COG",
+	"end_user_data_statement": "This cog does not persistently store data or metadata about users."
 }

retrosign/retrosign.py

@@ -6,7 +6,6 @@ from bs4 import BeautifulSoup as bs
 import discord
 from redbot.core import commands
 from io import BytesIO
-import os
 from random import choice
 import re
 import unicodedata
@@ -14,6 +13,11 @@ import unicodedata
 
 class Retrosign(commands.Cog):
     """Make an 80s retro sign. Originally by Anismash"""
+
+    async def red_delete_data_for_user(self, **kwargs):
+        """ Nothing to delete """
+        return
+
     def __init__(self, bot):
         self.bot = bot
         self.session = aiohttp.ClientSession()
@@ -26,47 +30,27 @@ class Retrosign(commands.Cog):
         if len(texts) == 1:
             lenstr = len(texts[0])
             if lenstr <= 15:
-                data = dict(
-                    bcg=choice([1, 2, 3, 4, 5]),
-                    txt=choice([1, 2, 3, 4]),
-                    text1="",
-                    text2=texts[0],
-                    text3="",
-                )
+                data = dict(bcg=choice([1, 2, 3, 4, 5]), txt=choice([1, 2, 3, 4]), text1="", text2=texts[0], text3="",)
             else:
                 return await ctx.send("\N{CROSS MARK} Your line is too long (14 character limit)")
         elif len(texts) == 3:
-            texts[0] = unicodedata.normalize('NFD', texts[0]).encode('ascii', 'ignore')
-            texts[0] = texts[0].decode('UTF-8')
-            texts[0] = re.sub(r'[^A-Za-z0-9 ]', '', texts[0])
+            texts[0] = unicodedata.normalize("NFD", texts[0]).encode("ascii", "ignore")
+            texts[0] = texts[0].decode("UTF-8")
+            texts[0] = re.sub(r"[^A-Za-z0-9 ]", "", texts[0])
             if len(texts[0]) >= 15:
-                return await ctx.send(
-                    "\N{CROSS MARK} Your first line is too long (14 character limit)"
-                )
+                return await ctx.send("\N{CROSS MARK} Your first line is too long (14 character limit)")
             if len(texts[1]) >= 13:
-                return await ctx.send(
-                    "\N{CROSS MARK} Your second line is too long (12 character limit)"
-                )
+                return await ctx.send("\N{CROSS MARK} Your second line is too long (12 character limit)")
             if len(texts[2]) >= 26:
-                return await ctx.send(
-                    "\N{CROSS MARK} Your third line is too long (25 character limit)"
-                )
+                return await ctx.send("\N{CROSS MARK} Your third line is too long (25 character limit)")
             data = dict(
-                bcg=choice([1, 2, 3, 4, 5]),
-                txt=choice([1, 2, 3, 4]),
-                text1=texts[0],
-                text2=texts[1],
-                text3=texts[2],
+                bcg=choice([1, 2, 3, 4, 5]), txt=choice([1, 2, 3, 4]), text1=texts[0], text2=texts[1], text3=texts[2],
             )
         else:
-            return await ctx.send(
-                "\N{CROSS MARK} please provide three words seperated by ';' or one word"
-            )
+            return await ctx.send("\N{CROSS MARK} please provide three words seperated by ';' or one word")
 
         async with ctx.channel.typing():
-            async with self.session.post(
-                "https://photofunia.com/effects/retro-wave", data=data
-            ) as response:
+            async with self.session.post("https://photofunia.com/effects/retro-wave", data=data) as response:
                 if response.status == 200:
                     soup = bs(await response.text(), "html.parser")
                     download_url = soup.find("div", class_="downloads-container").ul.li.a["href"]

rndstatus/__init__.py

@@ -1,5 +1,7 @@
 from .rndstatus import RndStatus
 
+__red_end_user_data_statement__ = "This cog does not persistently store data or metadata about users."
+
 
 def setup(bot):
     bot.add_cog(RndStatus(bot))

rndstatus/info.json

@@ -3,10 +3,12 @@
 		"aikaterna"
 	],
 	"description": "Random statuses with an optional bot stats mode. Ported from Twentysix's v2 cog.",
-    "install_msg": "Thanks for installing, have fun.",
+	"install_msg": "Thanks for installing, have fun.",
+	"min_bot_version": "3.3.6",
 	"short": "Random bot statuses",
 	"tags": [
 		"status"
 	],
-	"type": "COG"
-}
+	"type": "COG",
+	"end_user_data_statement": "This cog does not persistently store data or metadata about users."
+}

rndstatus/rndstatus.py

@@ -1,36 +1,46 @@
+import re
 import discord
 from redbot.core import Config, commands, checks
+from redbot.core.utils import AsyncIter
 from random import choice as rndchoice
-import time
+from collections import defaultdict
+import contextlib
+import asyncio
+import logging
+
+
+log = logging.getLogger("red.aikaterna.rndstatus")
 
 
 class RndStatus(commands.Cog):
     """Cycles random statuses or displays bot stats.
-
     If a custom status is already set, it won't change it until
     it's back to none. [p]set game"""
 
+    async def red_delete_data_for_user(self, **kwargs):
+        """ Nothing to delete """
+        return
+
     def __init__(self, bot):
         self.bot = bot
         self.last_change = None
         self.config = Config.get_conf(self, 2752521001, force_registration=True)
 
+        self.presence_task = asyncio.create_task(self.maybe_update_presence())
+
         default_global = {
             "botstats": False,
-            "delay": "300",
-            "statuses": [
-                "her Turn()",
-                "Tomb Raider II",
-                "Transistor",
-                "NEO Scavenger",
-                "Python",
-                "with your heart.",
-            ],
+            "delay": 300,
+            "statuses": ["her Turn()", "Tomb Raider II", "Transistor", "NEO Scavenger", "Python", "with your heart.",],
             "streamer": "rndstatusstreamer",
-            "type": 1,
+            "type": 0,
+            "status": 0,
         }
         self.config.register_global(**default_global)
 
+    def cog_unload(self):
+        self.presence_task.cancel()
+
     @commands.group(autohelp=True)
     @commands.guild_only()
     @checks.is_owner()
@@ -41,7 +51,6 @@ class RndStatus(commands.Cog):
     @rndstatus.command(name="set")
     async def _set(self, ctx, *statuses: str):
         """Sets Red's random statuses.
-
         Accepts multiple statuses.
         Must be enclosed in double quotes in case of multiple words.
         Example:
@@ -49,147 +58,150 @@ class RndStatus(commands.Cog):
         Shows current list if empty."""
         saved_status = await self.config.statuses()
         if statuses == () or "" in statuses:
-            return await ctx.send("Current statuses: " + " | ".join(saved_status))
+            msg = (
+                f"Current statuses: {(' | ').join(saved_status)}\n"
+                f"To set new statuses, use the instructions in `{ctx.prefix}help rndstatus set`."
+            )
+            return await ctx.send(msg)
         await self.config.statuses.set(list(statuses))
-        await ctx.send(
-            "Done. Redo this command with no parameters to see the current list of statuses."
-        )
+        await self.presence_updater()
+        await ctx.send("Done. Redo this command with no parameters to see the current list of statuses.")
 
     @rndstatus.command(name="streamer")
     async def _streamer(self, ctx: commands.Context, *, streamer=None):
-        """Set the streamer needed for streaming statuses.
-        """
-        
+        """Set the streamer name needed for streaming statuses."""
         saved_streamer = await self.config.streamer()
-        if streamer == None:
-            return await ctx.send("Current Streamer: " + saved_streamer)
+        if streamer is None:
+            return await ctx.send(f"Current Streamer: {saved_streamer}")
         await self.config.streamer.set(streamer)
-        await ctx.send(
-            "Done. Redo this command with no parameters to see the current streamer."
-        )
+        await ctx.send("Done. Redo this command with no parameters to see the current streamer.")
 
     @rndstatus.command()
     async def botstats(self, ctx, *statuses: str):
         """Toggle for a bot stats status instead of random messages."""
         botstats = await self.config.botstats()
         await self.config.botstats.set(not botstats)
-        await ctx.send("Botstats toggle: {}.".format(not botstats))
-        if not botstats == False:
-            await self.bot.change_presence(activity=None)
+        await ctx.send(f"Botstats toggle: {not botstats}.")
+        await self.presence_updater()
 
     @rndstatus.command()
     async def delay(self, ctx, seconds: int):
         """Sets interval of random status switch.
-
         Must be 20 or superior."""
         if seconds < 20:
             seconds = 20
         await self.config.delay.set(seconds)
-        await ctx.send(f"Interval set to {str(seconds)} seconds.")
+        await ctx.send(f"Interval set to {seconds} seconds.")
+
+    @rndstatus.command(name="type")
+    async def _rndstatus_type(self, ctx, status_type: int):
+        """Define the rndstatus game type.
 
-    @rndstatus.command()
-    async def type(self, ctx, type: int):
-        """Define the rndstatus type.
-        
         Type list:
         0 = Playing
         1 = Streaming
         2 = Listening
         3 = Watching"""
-        if 0 <= type <= 3:
-            await self.config.type.set(type)
-            await ctx.send("Rndstatus type set.")
+        if 0 <= status_type <= 3:
+            rnd_type = {0: "playing", 1: "streaming", 2: "listening", 3: "watching"}
+            await self.config.type.set(status_type)
+            await self.presence_updater()
+            await ctx.send(f"Rndstatus activity type set to {rnd_type[status_type]}.")
         else:
-            await ctx.send("Type must be between 0 and 3.")
+            await ctx.send(
+                f"Status activity type must be between 0 and 3. "
+                f"See `{ctx.prefix}help rndstatus type` for more information."
+            )
 
-    @commands.Cog.listener()
-    async def on_message(self, message):
+    @rndstatus.command()
+    async def status(self, ctx, status: int):
+        """Define the rndstatus presence status.
+
+        Status list:
+        0 = Online
+        1 = Idle
+        2 = DND
+        3 = Invisible"""
+        if 0 <= status <= 3:
+            rnd_status = {0: "online", 1: "idle", 2: "DND", 3: "invisible"}
+            await self.config.status.set(status)
+            await self.presence_updater()
+            await ctx.send(f"Rndstatus presence status set to {rnd_status[status]}.")
+        else:
+            await ctx.send(
+                f"Status presence type must be between 0 and 3. "
+                f"See `{ctx.prefix}help rndstatus status` for more information."
+            )
+
+    async def maybe_update_presence(self):
+        await self.bot.wait_until_red_ready()
+        delay = await self.config.delay()
+        while True:
+            try:
+                await self.presence_updater()
+                await asyncio.sleep(int(delay))
+            except asyncio.CancelledError:
+                break
+            except Exception as e:
+                log.exception(e, exc_info=e)
+
+    async def presence_updater(self):
+        pattern = re.compile(rf"<@!?{self.bot.user.id}>")
+        cog_settings = await self.config.all()
+        guilds = self.bot.guilds
+        guild = next(g for g in guilds if not g.unavailable)
         try:
-            current_game = str(message.guild.me.activity.name)
+            current_game = str(guild.me.activity.name)
         except AttributeError:
             current_game = None
-        statuses = await self.config.statuses()
-        botstats = await self.config.botstats()
-        prefix = await self.bot.db.prefix()
-        streamer = await self.config.streamer()
-        url = "https://www.twitch.tv/" + streamer
+        statuses = cog_settings["statuses"]
+        botstats = cog_settings["botstats"]
+        streamer = cog_settings["streamer"]
+        _type = cog_settings["type"]
+        _status = cog_settings["status"]
+
+        url = f"https://www.twitch.tv/{streamer}"
+        prefix = await self.bot.get_valid_prefixes()
+
+        if _status == 0:
+            status = discord.Status.online
+        elif _status == 1:
+            status = discord.Status.idle
+        elif _status == 2:
+            status = discord.Status.dnd
+        elif _status == 3:
+            status = discord.Status.offline
 
         if botstats:
-            total_users = sum(len(s.members) for s in self.bot.guilds)
+            me = self.bot.user
+            clean_prefix = pattern.sub(f"@{me.name}", prefix[0])
+            total_users = len(self.bot.users)
             servers = str(len(self.bot.guilds))
-            botstatus = f"{prefix[0]}help | {total_users} users | {servers} servers"
-            if self.last_change == None:
-                type = await self.config.type()
-                if type == 1:
-                    await self.bot.change_presence(
-                        activity=discord.Streaming(name=botstatus, url=url)
-                    )
+            botstatus = f"{clean_prefix}help | {total_users} users | {servers} servers"
+            if (current_game != str(botstatus)) or current_game is None:
+                if _type == 1:
+                    await self.bot.change_presence(activity=discord.Streaming(name=botstatus, url=url))
                 else:
-                    await self.bot.change_presence(
-                        activity=discord.Activity(name=botstatus, type=type)
-                    )
-                self.last_change = int(time.perf_counter())
-            if message.author.id == self.bot.user.id:
-                return
-            delay = await self.config.delay()
-            if abs(self.last_change - int(time.perf_counter())) < int(delay):
-                return
-            if (current_game != str(botstatus)) or current_game == None:
-                type = await self.config.type()
-                if type == 1:
-                    return await self.bot.change_presence(
-                        activity=discord.Streaming(name=botstatus, url=url)
-                    )
-                else:
-                    return await self.bot.change_presence(
-                        activity=discord.Activity(name=botstatus, type=type)
-                    )
+                    await self.bot.change_presence(activity=discord.Activity(name=botstatus, type=_type), status=status)
+        else:
+            if len(statuses) > 0:
+                new_status = self.random_status(guild, statuses)
+                if (current_game != new_status) or (current_game is None) or (len(statuses) == 1):
+                    if _type == 1:
+                        await self.bot.change_presence(activity=discord.Streaming(name=new_status, url=url))
+                    else:
+                        await self.bot.change_presence(
+                            activity=discord.Activity(name=new_status, type=_type), status=status
+                        )
 
-        if self.last_change == None:
-            if len(statuses) > 0 and (current_game in statuses or current_game == None):
-                new_status = self.random_status(message, statuses)
-                self.last_change = int(time.perf_counter())
-                type = await self.config.type()
-                if type == 1:
-                    await self.bot.change_presence(
-                        activity=discord.Streaming(name=new_status, url=url)
-                    )
-                else:
-                    await self.bot.change_presence(
-                        activity=discord.Activity(name=new_status, type=type)
-                    )
-
-        if message.author.id != self.bot.user.id:
-            delay = await self.config.delay()
-            if abs(self.last_change - int(time.perf_counter())) >= int(delay):
-                self.last_change = int(time.perf_counter())
-                new_status = self.random_status(message, statuses)
-                if current_game != new_status:
-                    if current_game in statuses or current_game == None:
-                        type = await self.config.type()
-                        if type == 1:
-                            await self.bot.change_presence(
-                                activity=discord.Streaming(name=new_status, url=url)
-                            )
-                        else:
-                            await self.bot.change_presence(
-                                activity=discord.Activity(name=new_status, type=type)
-                            )
-
-    def random_status(self, msg, statuses):
+    def random_status(self, guild, statuses):
         try:
-            current = str(msg.guild.me.activity.name)
+            current = str(guild.me.activity.name)
         except AttributeError:
             current = None
-        try:
-            new = str(msg.guild.me.activity.name)
-        except AttributeError:
-            new = None
-        if len(statuses) > 1:
-            while current == new:
-                new = rndchoice(statuses)
-        elif len(statuses) == 1:
-            new = statuses[0]
-        else:
-            new = None
-        return new
+        new_statuses = [s for s in statuses if s != current]
+        if len(new_statuses) > 1:
+            return rndchoice(new_statuses)
+        elif len(new_statuses) == 1:
+            return new_statuses[0]
+        return current

rss/__init__.py

@@ -0,0 +1,9 @@
+from redbot.core import commands
+
+from .rss import RSS
+
+
+async def setup(bot: commands.Bot):
+    n = RSS(bot)
+    bot.add_cog(n)
+    n.initialize()

rss/color.py

@@ -0,0 +1,77 @@
+import discord
+import re
+from scipy.spatial import KDTree
+import webcolors
+
+
+class Color:
+    """Helper for color handling."""
+
+    async def _color_converter(self, hex_code_or_color_word: str):
+        """
+        Used for user input on rss embed color
+        Input:    discord.Color name, CSS3 color name, 0xFFFFFF, #FFFFFF, FFFFFF
+        Output:   0xFFFFFF
+        """
+        # #FFFFFF and FFFFFF to 0xFFFFFF
+        hex_match = re.match(r"#?[a-f0-9]{6}", hex_code_or_color_word.lower())
+        if hex_match:
+            hex_code = f"0x{hex_code_or_color_word.lstrip('#')}"
+            return hex_code
+
+        # discord.Color checking
+        if hasattr(discord.Color, hex_code_or_color_word):
+            hex_code = str(getattr(discord.Color, hex_code_or_color_word)())
+            hex_code = hex_code.replace("#", "0x")
+            return hex_code
+
+        # CSS3 color name checking
+        try:
+            hex_code = webcolors.name_to_hex(hex_code_or_color_word, spec="css3")
+            hex_code = hex_code.replace("#", "0x")
+            return hex_code
+        except ValueError:
+            pass
+
+        return None
+
+    async def _hex_to_css3_name(self, hex_code: str):
+        """
+        Input:  0xFFFFFF
+        Output: CSS3 color name string closest match
+        """
+        hex_code = await self._hex_validator(hex_code)
+        rgb_tuple = await self._hex_to_rgb(hex_code)
+
+        names = []
+        positions = []
+
+        for hex, name in webcolors.css3_hex_to_names.items():
+            names.append(name)
+            positions.append(webcolors.hex_to_rgb(hex))
+
+        spacedb = KDTree(positions)
+        dist, index = spacedb.query(rgb_tuple)
+
+        return names[index]
+
+    async def _hex_to_rgb(self, hex_code: str):
+        """
+        Input:  0xFFFFFF
+        Output: (255, 255, 255)
+        """
+        return webcolors.hex_to_rgb(hex_code)
+
+    async def _hex_validator(self, hex_code: str):
+        """
+        Input:  0xFFFFFF
+        Output: #FFFFFF or None
+        """
+        if hex_code[:2] == "0x":
+            hex_code = hex_code.replace("0x", "#")
+        try:
+            # just a check to make sure it's a real color hex code
+            hex_code = webcolors.normalize_hex(hex_code)
+        except ValueError:
+            hex_code = None
+        return hex_code

rss/info.json

@@ -0,0 +1,10 @@
+{
+    "author": ["aikaterna"],
+    "install_msg": "Thanks for installing.",
+    "short": "Read RSS feeds",
+    "description": "Read RSS feeds",
+    "tags": ["rss"],
+    "permissions": ["embed_links"],
+    "requirements": ["bs4", "feedparser>=6.0.0", "scipy", "webcolors==1.3"],
+    "min_bot_version" : "3.4.0"
+}

rss/quiet_template.py

@@ -0,0 +1,31 @@
+from collections import ChainMap
+from string import Template
+
+
+class QuietTemplate(Template):
+    """
+    A subclass of string.Template that is less verbose on a missing key
+    https://github.com/python/cpython/blob/919f0bc8c904d3aa13eedb2dd1fe9c6b0555a591/Lib/string.py#L123
+    """
+
+    def quiet_safe_substitute(self, mapping={}, /, **kws):
+        if mapping is {}:
+            mapping = kws
+        elif kws:
+            mapping = ChainMap(kws, mapping)
+        # Helper function for .sub()
+        def convert(mo):
+            named = mo.group('named') or mo.group('braced')
+            if named is not None:
+                try:
+                    return str(mapping[named])
+                except KeyError:
+                    # return None instead of the tag name so that
+                    # invalid tags are not present in the feed output
+                    return None
+            if mo.group('escaped') is not None:
+                return self.delimiter
+            if mo.group('invalid') is not None:
+                return mo.group()
+            raise ValueError('Unrecognized named group in pattern', self.pattern)
+        return self.pattern.sub(convert, self.template)

rss/rss_feed.py

@@ -0,0 +1,50 @@
+class RssFeed():
+    """RSS feed object"""
+
+    def __init__(self, **kwargs):
+        super().__init__()
+        self.name: str = kwargs.get("name", None)
+        self.last_title: str = kwargs.get("last_title", None)
+        self.last_link: str = kwargs.get("last_link", None)
+        self.last_time: str = kwargs.get("last_time", None)
+        self.template: str = kwargs.get("template", None)
+        self.url: str = kwargs.get("url", None)
+        self.template_tags: List[str] = kwargs.get("template_tags", [])
+        self.is_special: List[str] = kwargs.get("is_special", [])
+        self.embed: bool = kwargs.get("embed", True)
+        self.embed_color: str = kwargs.get("embed_color", None)
+        self.embed_image: str = kwargs.get("embed_image", None)
+        self.embed_thumbnail: str = kwargs.get("embed_thumbnail", None)
+
+    def to_json(self) -> dict:
+        return {
+            "name": self.name,
+            "last_title": self.last_title,
+            "last_link": self.last_link,
+            "last_time": self.last_time,
+            "template": self.template,
+            "url": self.url,
+            "template_tags": self.template_tags,
+            "is_special": self.is_special,
+            "embed": self.embed,
+            "embed_color": self.embed_color,
+            "embed_image": self.embed_image,
+            "embed_thumbnail": self.embed_thumbnail,
+        }
+
+    @classmethod
+    def from_json(cls, data: dict):
+        return cls(
+            name=data["name"] if data["name"] else None,
+            last_title=data["last_title"] if data["last_title"] else None,
+            last_link=data["last_link"] if data["last_link"] else None,
+            last_time=data["last_time"] if data["last_time"] else None,
+            template=data["template"] if data["template"] else None,
+            url=data["url"] if data["url"] else None,
+            template_tags=data["template_tags"] if data["template_tags"] else [],
+            is_special=data["is_special"] if data["is_special"] else [],
+            embed=data["embed"] if data["embed"] else True,
+            embed_color=data["embed_color"] if data["embed_color"] else None,
+            embed_image=data["embed_image"] if data["embed_image"] else None,
+            embed_thumbnail=data["embed_thumbnail"] if data["embed_thumbnail"] else None,
+        )

rss/tag_type.py

@@ -0,0 +1,13 @@
+from enum import Enum
+
+
+INTERNAL_TAGS = ["is_special", "template_tags", "embed", "embed_color", "embed_image", "embed_thumbnail"]
+
+VALID_IMAGES = ["png", "webp", "gif", "jpeg", "jpg"]
+
+
+class TagType(Enum):
+    PLAINTEXT = 1
+    HTML = 2
+    DICT = 3
+    LIST = 4

seen/__init__.py

@@ -1,5 +1,10 @@
 from .seen import Seen
 
+__red_end_user_data_statement__ = (
+    "This cog does not persistently store end user data. "
+    "This cog does store discord IDs and last seen timestamp as needed for operation. "
+)
+
 
 async def setup(bot):
     cog = Seen(bot)

seen/info.json

@@ -8,5 +8,6 @@
 		"seen", 
 		"activity"
 	],
-	"type": "COG"
+	"type": "COG",
+	"end_user_data_statement": "This cog does not persistently store end user data. This cog does store discord IDs and last seen timestamp as needed for operation. "
 }

seen/seen.py

@@ -1,7 +1,7 @@
 import asyncio
 import contextlib
 import datetime
-from typing import Union
+from typing import Union, Literal
 
 import discord
 import time
@@ -14,6 +14,15 @@ _SCHEMA_VERSION = 2
 class Seen(commands.Cog):
     """Shows last time a user was seen in chat."""
 
+    async def red_delete_data_for_user(
+        self, *, requester: Literal["discord", "owner", "user", "user_strict"], user_id: int,
+    ):
+        if requester in ["discord", "owner"]:
+            data = await self.config.all_members()
+            for guild_id, members in data.items():
+                if user_id in members:
+                    await self.config.member_from_ids(guild_id, user_id).clear()
+
     def __init__(self, bot):
         self.bot = bot
         self.config = Config.get_conf(self, 2784481001, force_registration=True)
@@ -29,9 +38,7 @@ class Seen(commands.Cog):
 
     async def initialize(self):
         asyncio.ensure_future(
-            self._migrate_config(
-                from_version=await self.config.schema_version(), to_version=_SCHEMA_VERSION
-            )
+            self._migrate_config(from_version=await self.config.schema_version(), to_version=_SCHEMA_VERSION)
         )
 
     async def _migrate_config(self, from_version: int, to_version: int):
@@ -75,9 +82,7 @@ class Seen(commands.Cog):
         member_seen_cache = self._cache.get(author.guild.id, {}).get(author.id, None)
 
         if not member_seen_cache and not member_seen_config:
-            embed = discord.Embed(
-                colour=discord.Color.red(), title="I haven't seen that user yet."
-            )
+            embed = discord.Embed(colour=discord.Color.red(), title="I haven't seen that user yet.")
             return await ctx.send(embed=embed)
 
         if not member_seen_cache:
@@ -132,10 +137,7 @@ class Seen(commands.Cog):
 
     @commands.Cog.listener()
     async def on_typing(
-        self,
-        channel: discord.abc.Messageable,
-        user: Union[discord.User, discord.Member],
-        when: datetime.datetime,
+        self, channel: discord.abc.Messageable, user: Union[discord.User, discord.Member], when: datetime.datetime,
     ):
         if getattr(user, "guild", None):
             if user.guild.id not in self._cache:
@@ -150,18 +152,14 @@ class Seen(commands.Cog):
             self._cache[after.guild.id][after.author.id] = int(time.time())
 
     @commands.Cog.listener()
-    async def on_reaction_remove(
-        self, reaction: discord.Reaction, user: Union[discord.Member, discord.User]
-    ):
+    async def on_reaction_remove(self, reaction: discord.Reaction, user: Union[discord.Member, discord.User]):
         if getattr(user, "guild", None):
             if user.guild.id not in self._cache:
                 self._cache[user.guild.id] = {}
             self._cache[user.guild.id][user.id] = int(time.time())
 
     @commands.Cog.listener()
-    async def on_reaction_add(
-        self, reaction: discord.Reaction, user: Union[discord.Member, discord.User]
-    ):
+    async def on_reaction_add(self, reaction: discord.Reaction, user: Union[discord.Member, discord.User]):
         if getattr(user, "guild", None):
             if user.guild.id not in self._cache:
                 self._cache[user.guild.id] = {}

snacktime/__init__.py

@@ -1,5 +1,7 @@
 from .snacktime import Snacktime
 
+__red_end_user_data_statement__ = "This cog does not persistently store data or metadata about users."
+
 
 async def setup(bot):
     bot.add_cog(Snacktime(bot))

snacktime/info.json

@@ -5,5 +5,6 @@
     "description" : "snackburr will come around every-so-often if you've asked him to.\nI hear snackburr likes to come around more often when people are partyin.",
     "install_msg" : "A snack delivery bear has arrived ʕ•ᴥ• ʔ",
     "tags" : ["snack", "snacktime", "snackburr", "party", "party time"],
-    "disabled" : false
+    "disabled" : false,
+    "end_user_data_statement": "This cog does not persistently store data or metadata about users."
 }

snacktime/phrases.py

@@ -4,8 +4,8 @@ FRIENDS = {
     "Mr Pickles": "(=｀ェ´=) <",
     "Satin": "▼・ᴥ・▼ <",
     "Thunky": "ᘛ⁐̤ᕐᐷ <",
-    "Jingle": "꒰∗´꒳`꒱ <",
-    "FluffButt": "/ᐠ｡ꞈ｡ᐟ\ <",
+    "Jingle": "꒰∗'꒳'꒱ <",
+    "FluffButt": r"/ᐠ｡ꞈ｡ᐟ\ <",
     "Staplefoot": "(￣(エ)￣) <",
 }
 
@@ -33,12 +33,17 @@ SNACKBURR_PHRASES = {
         "Hey check out this sweet stach o' snacks I found! Who wants a cut?",
         "Who's ready to gobble down some snacks!?",
         "So who's gonna help me eat all these snacks? :3",
+        "Eyoooooooo I haz snacks! Yall wanna munch???",
     ],
     "OUT": [
         "I'm out of snacks! I'll be back with more soon.",
         "I'm out of snacks :( I'll be back soon with more!",
         "Aight, I gotta head out! I'll be back with more, don worry :3",
         "Alright, I gotta get back to my errands. I'll see you guys soon!",
+        "Uh okays, imma get back to my errands cuz outta snacks!",
+        "Yall are cool but i gotta get back to my errands. I'll visit again soon!",
+        "Errands call! Thanks for the help with eating all these snacks, I'll come again :3",
+        "I have to go back do my stuffs, but as soon as I get more snacks imma come and share!!!",
     ],
     "LONELY": ["I guess you guys don't like snacktimes.. I'll stop comin around."],
     "NO_TAKERS": [
@@ -47,6 +52,12 @@ SNACKBURR_PHRASES = {
         "I don't see anybody.. <.< ... >.> ... All the snacks for me!!",
         "I guess nobody wants snacks huh.. Well, I'll come back later",
         "I guess i'll just come back later..",
+        "Well. Since yall dun want snacks imma eat them all!!!",
+        "Where is everyone, I brought so many snacks...",
+        "I did offer to share, but I guess you dun want. Oh well, I'll come back later :3",
+        "Whoa... you dun wanna have any snacks?!",
+        "I'll just eat all those snacks by myself then!",
+        ":3 okay, catch yall lata",
     ],
     "GIVE": [
         "Here ya go, {0}, here's {1} pb!",
@@ -56,6 +67,14 @@ SNACKBURR_PHRASES = {
         "Ok {0}, here's {1} pb for you. Anyone else want some?",
         "Alllright, {1} pb for {0}!",
         "Hold your horses {0}! Alright, {1} pb for you :)",
+        "Woooooooooo hey {0}, here have {1} pb!",
+        "Here's {1} pb for {0} :3",
+        "Heyheyehy hiya {0}! Here's {1} pb for you!",
+        "Oh hiya {0} :) imma give you {1} pb now!",
+        "Heyyyyyyyyyyy {0}, I brought you {1} pb :)",
+        "Oh you wanna munchies? I have munchies for you, {0}! Have {1} pb :)",
+        "{1} pb for {0}!!!",
+        "{0} {0} {0}! Grab {1} pb!",
     ],
     "LAST_SECOND": [
         "Fine fine, {0}, I'll give you {1} of my on-the-road pb.. Cya!",
@@ -65,9 +84,46 @@ SNACKBURR_PHRASES = {
         "Don't be greedy now! you already got some pb {0}!",
         "You already got your snacks {0}!",
         "Come on {0}, you already got your snacks! We gotta make sure there's some for errbody!",
+        "But! {0} you already had a bunch of snacks!",
+        "Hey {0}, there must be snacks for others too!!",
+        "Donot be like that, {0}, I wanna give snacks to errybody!",
+        "Aw but {0}, we gonna run outta snacks if I give you again :(",
+        "Let's make a deal, remind me when I come back from my errands next time, {0} :3",
+        "Next time I'm comin 'round imma give you again, {0}",
+        "I alredy handed you snacks {0}...",
+        "But... but... you... you had your snacks {0} ._.",
+        "I wanna give snacks to errybody! You can't have them all, {0}!",
+        "You already munched on some snacks, {0}!",
+        "Did you already gobble down yours, {0}? Gotta leave some for the others!",
     ],
-    "ENABLE": [
-        "Oh you guys want snacks?! Aight, I'll come around every so often to hand some out!"
+    "EAT_BEFORE": [
+        "monstrously",
+        "shyly",
+        "earnestly",
+        "eagerly",
+        "enthusiastically",
+        "ravenously",
+        "delicately",
+        "daintily",
     ],
+    "EAT_AFTER": [
+        "gobbles up",
+        "pigs out on",
+        "wolfs down",
+        "chows down",
+        "munches on",
+        "chugs",
+        "puts away",
+        "ravages",
+        "siphons into their mouth",
+        "disposes of",
+        "swallows",
+        "chomps",
+        "consumes",
+        "demolishes",
+        "partakes of",
+        "ingests",
+    ],
+    "ENABLE": ["Oh you guys want snacks?! Aight, I'll come around every so often to hand some out!"],
     "DISABLE": ["You guys don't want snacks anymore? Alright, I'll stop comin around."],
 }

snacktime/snacktime.py

@@ -5,6 +5,7 @@ from random import randint
 from random import choice as randchoice
 
 from redbot.core import bank, checks, commands, Config
+from redbot.core.errors import BalanceTooHigh
 from redbot.core.utils.chat_formatting import box, humanize_list, pagify
 
 from .phrases import FRIENDS, SNACKBURR_PHRASES
@@ -16,6 +17,10 @@ log = logging.getLogger("red.aikaterna.snacktime")
 class Snacktime(commands.Cog):
     """Snackburr's passing out pb jars!"""
 
+    async def red_delete_data_for_user(self, **kwargs):
+        """ Nothing to delete """
+        return
+
     def __init__(self, bot):
         self.bot = bot
         self.config = Config.get_conf(self, 2712291001, force_registration=True)
@@ -48,14 +53,23 @@ class Snacktime(commands.Cog):
         self.config.register_guild(**default_guild)
         self.config.register_channel(**default_channel)
 
-    async def persona_choice(self, msg):
-        invite_friends = await self.config.guild(msg.guild).FRIENDS()
+    async def persona_choice(self, ctx: None, message: None):
+        if ctx:
+            invite_friends = await self.config.guild(ctx.guild).FRIENDS()
+        else:
+            invite_friends = await self.config.guild(message.guild).FRIENDS()
         personas = FRIENDS
         if not invite_friends:
-            return "Snackburr"
+            return "Snackburr" if message else "ʕ •ᴥ•ʔ <"
         elif invite_friends is True:
-            del personas["Snackburr"]
-        return randchoice(list(personas.keys()))
+            try:
+                del personas["Snackburr"]
+            except KeyError:
+                pass
+        if message:
+            return randchoice(list(personas.keys()))
+        else:
+            return randchoice(list(personas.values()))
 
     async def get_response(self, msg, phrase_type):
         scid = f"{msg.guild.id}-{msg.channel.id}"
@@ -64,6 +78,27 @@ class Snacktime(commands.Cog):
         phrase = randchoice(SNACKBURR_PHRASES[phrase_type])
         return f"`{persona_phrase} {phrase}`"
 
+    @commands.cooldown(1, 1, commands.BucketType.channel)
+    @commands.guild_only()
+    @commands.command()
+    async def eat(self, ctx, amount: int):
+        """
+        all this talk about pb is makin me hungry.
+
+        how bout you guys?
+        """
+        persona = await self.persona_choice(ctx=ctx, message=None)
+        if amount < 0:
+            return await ctx.send(f"`{persona} Woah slow down!`")
+        if amount > await bank.get_balance(ctx.author):
+            return await ctx.send(f"`{persona} You don't got that much pb!.. don't look at me..`")
+
+        await bank.withdraw_credits(ctx.author, amount)
+
+        first_phrase = randchoice(SNACKBURR_PHRASES["EAT_BEFORE"])
+        second_phrase = randchoice(SNACKBURR_PHRASES["EAT_AFTER"])
+        await ctx.send(f"`{persona} {ctx.author.display_name} {first_phrase} {second_phrase} {amount} whole pb jars!`")
+
     @commands.guild_only()
     @commands.group()
     @checks.mod_or_permissions(manage_guild=True)
@@ -88,9 +123,7 @@ class Snacktime(commands.Cog):
 
             msg = f"[Delivering in]:           {humanize_list(channel_names)}\n"
             msg += f"[Event start delay]:       {guild_data['EVENT_START_DELAY']} seconds\n"
-            msg += (
-                f"[Event start variance]:    {guild_data['EVENT_START_DELAY_VARIANCE']} seconds\n"
-            )
+            msg += f"[Event start variance]:    {guild_data['EVENT_START_DELAY_VARIANCE']} seconds\n"
             msg += f"[Friends status]:          {invite_friends}\n"
             msg += f"[Messages before event]:   {guild_data['MSGS_BEFORE_EVENT']}\n"
             msg += f"[Snack amount limit]:      {guild_data['SNACK_AMOUNT']} pb\n"
@@ -103,18 +136,14 @@ class Snacktime(commands.Cog):
     @snackset.command()
     async def errandtime(self, ctx, seconds: int):
         """How long snackburr needs to be out doin errands.. more or less."""
-        event_start_delay_variance = await self.config.guild(
-            ctx.guild
-        ).EVENT_START_DELAY_VARIANCE()
+        event_start_delay_variance = await self.config.guild(ctx.guild).EVENT_START_DELAY_VARIANCE()
         if seconds <= event_start_delay_variance:
             await ctx.send("errandtime must be greater than errandvariance!")
         elif seconds <= 0:
             await ctx.send("errandtime must be greater than 0")
         else:
             await self.config.guild(ctx.guild).EVENT_START_DELAY.set(seconds)
-            await ctx.send(
-                f"snackburr's errands will now take around {round(seconds/60, 2)} minutes!"
-            )
+            await ctx.send(f"snackburr's errands will now take around {round(seconds/60, 2)} minutes!")
 
     @snackset.command()
     async def errandvariance(self, ctx, seconds: int):
@@ -126,9 +155,7 @@ class Snacktime(commands.Cog):
             await ctx.send("errandvariance must be 0 or greater!")
         else:
             await self.config.guild(ctx.guild).EVENT_START_DELAY_VARIANCE.set(seconds)
-            await ctx.send(
-                f"snackburr now might be {round(seconds/60, 2)} minutes early or late to snacktime"
-            )
+            await ctx.send(f"snackburr now might be {round(seconds/60, 2)} minutes early or late to snacktime")
 
     @snackset.command(name="snacktime")
     async def snacktimetime(self, ctx, seconds: int):
@@ -152,9 +179,7 @@ class Snacktime(commands.Cog):
             await ctx.send("snackvariance must be 0 or greater!")
         else:
             await self.config.guild(ctx.guild).SNACK_DURATION_VARIANCE.set(seconds)
-            await ctx.send(
-                f"snackburr now may have to leave snacktime {round(seconds/60, 2)} minutes early or late"
-            )
+            await ctx.send(f"snackburr now may have to leave snacktime {round(seconds/60, 2)} minutes early or late")
 
     @snackset.command()
     async def msgsneeded(self, ctx, amt: int):
@@ -163,9 +188,7 @@ class Snacktime(commands.Cog):
             await ctx.send("msgsneeded must be greater than 0")
         else:
             await self.config.guild(ctx.guild).MSGS_BEFORE_EVENT.set(amt)
-            await ctx.send(
-                f"snackburr will now wait until {amt} messages pass until he comes with snacks"
-            )
+            await ctx.send(f"snackburr will now wait until {amt} messages pass until he comes with snacks")
 
     @snackset.command()
     async def amount(self, ctx, amt: int):
@@ -225,7 +248,7 @@ class Snacktime(commands.Cog):
                 return
             else:
                 phrases = [
-                    "Don't look at me. I donno where snackburr's at ¯\_(ツ)_/¯",
+                    r"Don't look at me. I donno where snackburr's at ¯\_(ツ)_/¯",
                     "I hear snackburr likes parties. *wink wink",
                     "I hear snackburr is attracted to channels with active conversations",
                     "If you party, snackburr will come! 〈( ^o^)ノ",
@@ -239,13 +262,9 @@ class Snacktime(commands.Cog):
             return
         self.snacktimeCheckLock[scid] = True
         if seconds < 0:
-            await ctx.send(
-                f"I'm not sure where snackburr is.. He's already {round(abs(seconds/60), 2)} minutes late!"
-            )
+            await ctx.send(f"I'm not sure where snackburr is.. He's already {round(abs(seconds/60), 2)} minutes late!")
         else:
-            await ctx.send(
-                f"snackburr's out on errands! I think he'll be back in {round(seconds/60, 2)} minutes"
-            )
+            await ctx.send(f"snackburr's out on errands! I think he'll be back in {round(seconds/60, 2)} minutes")
         await asyncio.sleep(40)
         self.snacktimeCheckLock[scid] = False
 
@@ -253,7 +272,7 @@ class Snacktime(commands.Cog):
         scid = f"{message.guild.id}-{message.channel.id}"
         if self.acceptInput.get(scid, False):
             return
-        self.channel_persona[scid] = await self.persona_choice(message)
+        self.channel_persona[scid] = await self.persona_choice(ctx=None, message=message)
         await message.channel.send(await self.get_response(message, "SNACKTIME"))
 
         self.acceptInput[scid] = True
@@ -273,20 +292,14 @@ class Snacktime(commands.Cog):
                 await self.config.channel(message.channel).repeatMissedSnacktimes.set(0)
             else:
                 await message.channel.send(await self.get_response(message, "NO_TAKERS"))
-                repeat_missed_snacktimes = await self.config.channel(
-                    message.channel
-                ).repeatMissedSnacktimes()
-                await self.config.channel(message.channel).repeatMissedSnacktimes.set(
-                    repeat_missed_snacktimes + 1
-                )
+                repeat_missed_snacktimes = await self.config.channel(message.channel).repeatMissedSnacktimes()
+                await self.config.channel(message.channel).repeatMissedSnacktimes.set(repeat_missed_snacktimes + 1)
                 await asyncio.sleep(2)
                 if (repeat_missed_snacktimes + 1) > 9:  # move to a setting
                     await message.channel.send(await self.get_response(message, "LONELY"))
                     deliver_channels = await self.config.guild(message.guild).DELIVER_CHANNELS()
                     new_deliver_channels = deliver_channels.remove(message.channel.id)
-                    await self.config.guild(message.guild).DELIVER_CHANNELS.set(
-                        new_deliver_channels
-                    )
+                    await self.config.guild(message.guild).DELIVER_CHANNELS.set(new_deliver_channels)
                     await self.config.channel(message.channel).repeatMissedSnacktimes.set(0)
         except:
             log.error("Snacktime: Failed to send message in startSnack")
@@ -332,9 +345,7 @@ class Snacktime(commands.Cog):
                         # start snacktime
                         await self.startSnack(message)
                 # if no snack coming, schedule one
-                elif self.snackInProgress.get(scid, False) == False and not self.startLock.get(
-                    scid, False
-                ):
+                elif self.snackInProgress.get(scid, False) == False and not self.startLock.get(scid, False):
                     self.msgsPassed[scid] = self.msgsPassed.get(scid, 0) + 1
                     # check for collisions
                     msgs_before_event = await self.config.guild(message.guild).MSGS_BEFORE_EVENT()
@@ -352,9 +363,7 @@ class Snacktime(commands.Cog):
                             log.debug(f"Snacktime: {message.author.name} - I got the Lock")
                             self.lockRequests[scid] = []
                             # someone got through already
-                            if self.msgsPassed[
-                                scid
-                            ] < msgs_before_event or self.snackInProgress.get(scid, False):
+                            if self.msgsPassed[scid] < msgs_before_event or self.snackInProgress.get(scid, False):
                                 log.debug("Snacktime: Lock: someone got through already.")
                                 return
                             else:
@@ -371,8 +380,7 @@ class Snacktime(commands.Cog):
                         log.debug(f"Snacktime: activity: {message.content}")
                         guild_data = await self.config.guild(message.guild).all()
                         timeTillSnack = guild_data["EVENT_START_DELAY"] + randint(
-                            -guild_data["EVENT_START_DELAY_VARIANCE"],
-                            guild_data["EVENT_START_DELAY_VARIANCE"],
+                            -guild_data["EVENT_START_DELAY_VARIANCE"], guild_data["EVENT_START_DELAY_VARIANCE"],
                         )
                         log.debug(f"Snacktime: {str(timeTillSnack)} seconds till snacktime")
                         self.snacktimePrediction[scid] = msgTime + guild_data["EVENT_START_DELAY"]
@@ -417,10 +425,7 @@ class Snacktime(commands.Cog):
                     userWants = False
                     for agreePhrase in agree_phrases:
                         # no one word answers
-                        if (
-                            agreePhrase in message.content.lower()
-                            and len(message.content.split()) > 1
-                        ):
+                        if agreePhrase in message.content.lower() and len(message.content.split()) > 1:
                             userWants = True
                             break
                     if userWants:
@@ -439,10 +444,13 @@ class Snacktime(commands.Cog):
                                 resp = await self.get_response(message, "LAST_SECOND")
                                 resp = resp.format(message.author.name, snackAmt)
                                 await message.channel.send(resp)
-                            await bank.deposit_credits(message.author, snackAmt)
-                        except:
+                            try:
+                                await bank.deposit_credits(message.author, snackAmt)
+                            except BalanceTooHigh as b:
+                                await bank.set_balance(message.author, b.max_balance)
+                        except Exception as e:
                             log.info(
-                                f"Snacktime: Failed to send pb message. {message.author.name} didn't get pb"
+                                f"Failed to send pb message. {message.author.name} didn't get pb\n", exc_info=True,
                             )
 
                 else:

timezone/__init__.py

@@ -1,5 +1,16 @@
 from .timezone import Timezone
 
+__red_end_user_data_statement__ = (
+    "This cog stores data provided by users "
+    "for the express purpose of redisplaying. "
+    "It does not store user data which was not "
+    "provided through a command. "
+    "Users may remove their own content "
+    "without making a data removal request. "
+    "This cog does not support data requests, "
+    "but will respect deletion requests."
+)
+
 
 def setup(bot):
     bot.add_cog(Timezone(bot))

timezone/info.json

@@ -12,5 +12,6 @@
 	"requirements": [
 		"pytz"
 	],
-	"type": "COG"
+	"type": "COG",
+	"end_user_data_statement": "This cog stores data provided by users for the express purpose of redisplaying. It does not store user data which was not provided through a command. Users may remove their own content without making a data removal request. This cog does not support data requests, but will respect deletion requests."
 }

timezone/timezone.py

@@ -1,21 +1,34 @@
 import discord
 import pytz
 from datetime import datetime
-from pytz import all_timezones
+from pytz import common_timezones
 from pytz import country_timezones
-from typing import Optional
+from typing import Optional, Literal, Tuple, Union
 from redbot.core import Config, commands, checks
 
 
 class Timezone(commands.Cog):
     """Gets times across the world..."""
 
+    async def red_delete_data_for_user(
+        self, *, requester: Literal["discord", "owner", "user", "user_strict"], user_id: int,
+    ):
+        await self.config.user_from_id(user_id).clear()
+
     def __init__(self, bot):
         self.bot = bot
         self.config = Config.get_conf(self, 278049241001, force_registration=True)
         default_user = {"usertime": None}
         self.config.register_user(**default_user)
 
+    async def get_usertime(self, user: discord.User):
+        tz = None
+        usertime = await self.config.user(user).usertime()
+        if usertime:
+            tz = pytz.timezone(usertime)
+
+        return usertime, tz
+
     @commands.guild_only()
     @commands.group()
     async def time(self, ctx):
@@ -45,8 +58,11 @@ class Timezone(commands.Cog):
                         "<https://en.wikipedia.org/wiki/List_of_tz_database_time_zones>"
                     )
                 else:
+                    tz = tz.title() if "/" in tz else tz.upper()
+                    if tz not in common_timezones:
+                        raise Exception(tz)
                     fmt = "**%H:%M** %d-%B-%Y **%Z (UTC %z)**"
-                    time = datetime.now(pytz.timezone(tz.title()))
+                    time = datetime.now(pytz.timezone(tz))
                     await ctx.send(time.strftime(fmt))
         except Exception as e:
             await ctx.send(f"**Error:** {str(e)} is an unsupported timezone.")
@@ -62,13 +78,13 @@ class Timezone(commands.Cog):
                 tz = str(country_timezones(code))
                 msg = (
                     f"Supported timezones for **{code}:**\n{tz[:-1][1:]}"
-                    f"\n**Use** `[p]time tz Continent/City` **to display the current time in that timezone.**"
+                    f"\n**Use** `{ctx.prefix}time tz Continent/City` **to display the current time in that timezone.**"
                 )
                 await ctx.send(msg)
             else:
                 await ctx.send(
                     "That code isn't supported. For a full list, see here: "
-                    "<https://en.wikipedia.org/wiki/List_of_tz_database_time_zones>"
+                    "<https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes>"
                 )
 
     @time.command()
@@ -78,41 +94,41 @@ class Timezone(commands.Cog):
             Usage: [p]time me Continent/City
         """
         if tz is None:
-            usertime = await self.config.user(ctx.message.author).usertime()
+            usertime, tz = await self.get_usertime(ctx.author)
             if not usertime:
                 await ctx.send(
-                    "You haven't set your timezone. Do `[p]time me Continent/City`: "
+                    f"You haven't set your timezone. Do `{ctx.prefix}time me Continent/City`: "
                     "see <https://en.wikipedia.org/wiki/List_of_tz_database_time_zones>"
                 )
             else:
-                time = datetime.now(pytz.timezone(usertime))
+                time = datetime.now(tz)
                 time = time.strftime("**%H:%M** %d-%B-%Y **%Z (UTC %z)**")
                 msg = f"Your current timezone is **{usertime}.**\n" f"The current time is: {time}"
                 await ctx.send(msg)
         else:
-            exist = True if tz.title() in all_timezones else False
+            exist = True if tz.title() in common_timezones else False
             if exist:
                 if "'" in tz:
                     tz = tz.replace("'", "")
-                await self.config.user(ctx.message.author).usertime.set(tz.title())
+                await self.config.user(ctx.author).usertime.set(tz.title())
                 await ctx.send(f"Successfully set your timezone to **{tz.title()}**.")
             else:
                 await ctx.send(
-                    "**Error:** Unrecognized timezone. Try `[p]time me Continent/City`: "
+                    f"**Error:** Unrecognized timezone. Try `{ctx.prefix}time me Continent/City`: "
                     "see <https://en.wikipedia.org/wiki/List_of_tz_database_time_zones>"
                 )
 
     @time.command()
-    @checks.admin_or_permissions(manage_guild=True)
+    @commands.is_owner()
     async def set(self, ctx, user: discord.Member, *, tz=None):
         """Allows the mods to edit timezones."""
         if not user:
-            user = ctx.message.author
+            user = ctx.author
         if tz is None:
             await ctx.send("That timezone is invalid.")
             return
         else:
-            exist = True if tz.title() in all_timezones else False
+            exist = True if tz.title() in common_timezones else False
             if exist:
                 if "'" in tz:
                     tz = tz.replace("'", "")
@@ -120,7 +136,7 @@ class Timezone(commands.Cog):
                 await ctx.send(f"Successfully set {user.name}'s timezone to **{tz.title()}**.")
             else:
                 await ctx.send(
-                    "**Error:** Unrecognized timezone. Try `[p]time set @user Continent/City`: "
+                    f"**Error:** Unrecognized timezone. Try `{ctx.prefix}time set @user Continent/City`: "
                     "see <https://en.wikipedia.org/wiki/List_of_tz_database_time_zones>"
                 )
 
@@ -130,14 +146,44 @@ class Timezone(commands.Cog):
         if not user:
             await ctx.send("That isn't a user!")
         else:
-            usertime = await self.config.user(user).usertime()
+            usertime, tz = await self.get_usertime(user)
             if usertime:
-                time = datetime.now(pytz.timezone(usertime))
+                time = datetime.now(tz)
                 fmt = "**%H:%M** %d-%B-%Y **%Z (UTC %z)**"
                 time = time.strftime(fmt)
                 await ctx.send(
-                    f"{user.name}'s current timezone is: **{usertime}**\n"
-                    f"The current time is: {str(time)}"
+                    f"{user.name}'s current timezone is: **{usertime}**\n" f"The current time is: {str(time)}"
                 )
             else:
                 await ctx.send("That user hasn't set their timezone.")
+
+    @time.command()
+    async def compare(self, ctx, user: discord.Member = None):
+        """Compare your saved timezone with another user's timezone."""
+        if not user:
+            return await ctx.send_help()
+
+        usertime, user_tz = await self.get_usertime(ctx.author)
+        othertime, other_tz = await self.get_usertime(user)
+
+        if not usertime:
+            return await ctx.send(
+                f"You haven't set your timezone. Do `{ctx.prefix}time me Continent/City`: "
+                "see <https://en.wikipedia.org/wiki/List_of_tz_database_time_zones>"
+            )
+        if not othertime:
+            return await ctx.send(f"That user's timezone isn't set yet.")
+
+        user_now = datetime.now(user_tz)
+        user_diff = user_now.utcoffset().total_seconds() / 60 / 60
+        other_now = datetime.now(other_tz)
+        other_diff = other_now.utcoffset().total_seconds() / 60 / 60
+        time_diff = int(abs(user_diff - other_diff))
+        fmt = "**%H:%M %Z (UTC %z)**"
+        other_time = other_now.strftime(fmt)
+        plural = "" if time_diff == 1 else "s"
+        time_amt = "the same time zone as you" if time_diff == 0 else f"{time_diff} hour{plural}"
+        position = "ahead of" if user_diff < other_diff else "behind"
+        position_text = "" if time_diff == 0 else f" {position} you"
+
+        await ctx.send(f"{user.display_name}'s time is {other_time} which is {time_amt}{position_text}.")

tools/__init__.py

@@ -1,4 +1,7 @@
 from .tools import Tools
 
+__red_end_user_data_statement__ = "This cog does not persistently store data or metadata about users."
+
+
 def setup(bot):
-	bot.add_cog(Tools(bot))
+    bot.add_cog(Tools(bot))

tools/converter.py

@@ -51,9 +51,7 @@ class GuildChannelConverter(converter.IDConverter, converter.Converter):
             else:
                 result = converter._get_from_guilds(bot, "get_channel", channel_id)
 
-        if not isinstance(
-            result, (discord.TextChannel, discord.VoiceChannel, discord.CategoryChannel)
-        ):
+        if not isinstance(result, (discord.TextChannel, discord.VoiceChannel, discord.CategoryChannel)):
             raise BadArgument('Channel "{}" not found.'.format(argument))
 
         return result

tools/info.json

@@ -5,7 +5,7 @@
 	],
 	"description": "Mod and admin tools.",
     "install_msg": "Thanks for installing. Use `[p]help` Tools to get started.",
-    "min_python_version": [3, 6, 0],
+    "min_python_version": [3, 8, 0],
     "permissions" : [
 		"ban_members",
 		"manage_channels"
@@ -17,5 +17,6 @@
 	"tags": [
 		"tools"
 	],
-	"type": "COG"
+	"type": "COG",
+	"end_user_data_statement": "This cog does not persistently store data or metadata about users."
 }

tools/tools.py

@@ -2,29 +2,36 @@ import asyncio
 import datetime
 import discord
 import inspect
-import random
-import os
-import time
-from redbot.core import Config, checks, commands
+import logging
+import re
+from redbot.core import checks, commands
 from redbot.core.utils import chat_formatting as cf
-from redbot.core.utils.menus import menu, DEFAULT_CONTROLS
+from redbot.core.utils.common_filters import filter_invites
+from redbot.core.utils.menus import menu, DEFAULT_CONTROLS, close_menu
 from tabulate import tabulate
 from contextlib import suppress as sps
 
 
+log = logging.getLogger("red.aikaterna.tools")
+
+
 class Tools(commands.Cog):
     """Mod and Admin tools."""
 
+    async def red_delete_data_for_user(self, **kwargs):
+        """ Nothing to delete """
+        return
+
     def __init__(self, bot):
         self.bot = bot
 
     async def _Tools__error(self, ctx, error):
         if error.__cause__:
             cause = error.__cause__
-            print(f"Tools Cog :: Error Occured ::\n{error}\n{cause}\n")
+            log.info(f"Tools Cog :: Error Occured ::\n{error}\n{cause}\n")
         else:
             cause = error
-            print(f"Tools Cog :: Error Occured :: \n{cause}\n")
+            log.info(f"Tools Cog :: Error Occured :: \n{cause}\n")
 
     @commands.guild_only()
     @checks.mod_or_permissions(manage_channels=True)
@@ -47,13 +54,9 @@ class Tools(commands.Cog):
             tcs = guild.text_channels
             vcs = guild.voice_channels
         except AttributeError:
-            return await ctx.send(
-                "User is not in that guild or I do not have access to that guild."
-            )
+            return await ctx.send("User is not in that guild or I do not have access to that guild.")
 
-        author_text_channels = [
-            c for c in tcs if c.permissions_for(ctx.author).read_messages is True
-        ]
+        author_text_channels = [c for c in tcs if c.permissions_for(ctx.author).read_messages is True]
         author_voice_channels = [c for c in vcs if c.permissions_for(ctx.author).connect is True]
 
         user_text_channels = [c for c in tcs if c.permissions_for(user).read_messages is True]
@@ -66,9 +69,7 @@ class Tools(commands.Cog):
             user_voice_channels
         )  # voice channels only the author has access to
 
-        user_only_t = set(user_text_channels) - set(
-            author_text_channels
-        )  # text channels only the user has access to
+        user_only_t = set(user_text_channels) - set(author_text_channels)  # text channels only the user has access to
         user_only_v = set(user_voice_channels) - set(
             author_voice_channels
         )  # voice channels only the user has access to
@@ -81,18 +82,14 @@ class Tools(commands.Cog):
         )  # voice channels that author and user have in common
 
         msg = "```ini\n"
-        msg += "{} [TEXT CHANNELS IN COMMON]:\n\n{}\n\n".format(
-            len(common_t), ", ".join([c.name for c in common_t])
-        )
+        msg += "{} [TEXT CHANNELS IN COMMON]:\n\n{}\n\n".format(len(common_t), ", ".join([c.name for c in common_t]))
         msg += "{} [TEXT CHANNELS {} HAS EXCLUSIVE ACCESS TO]:\n\n{}\n\n".format(
             len(user_only_t), user.name.upper(), ", ".join([c.name for c in user_only_t])
         )
         msg += "{} [TEXT CHANNELS YOU HAVE EXCLUSIVE ACCESS TO]:\n\n{}\n\n\n".format(
             len(author_only_t), ", ".join([c.name for c in author_only_t])
         )
-        msg += "{} [VOICE CHANNELS IN COMMON]:\n\n{}\n\n".format(
-            len(common_v), ", ".join([c.name for c in common_v])
-        )
+        msg += "{} [VOICE CHANNELS IN COMMON]:\n\n{}\n\n".format(len(common_v), ", ".join([c.name for c in common_v]))
         msg += "{} [VOICE CHANNELS {} HAS EXCLUSIVE ACCESS TO]:\n\n{}\n\n".format(
             len(user_only_v), user.name.upper(), ", ".join([c.name for c in user_only_v])
         )
@@ -113,16 +110,10 @@ class Tools(commands.Cog):
             guild = self.bot.get_guild(guild)
 
         try:
-            can_access = [
-                c.name
-                for c in guild.text_channels
-                if c.permissions_for(user).read_messages == True
-            ]
+            can_access = [c.name for c in guild.text_channels if c.permissions_for(user).read_messages == True]
             text_channels = [c.name for c in guild.text_channels]
         except AttributeError:
-            return await ctx.send(
-                "User is not in that guild or I do not have access to that guild."
-            )
+            return await ctx.send("User is not in that guild or I do not have access to that guild.")
 
         prefix = "You have" if user.id == ctx.author.id else user.name + " has"
         msg = "```ini\n[{} access to {} out of {} text channels]\n\n".format(
@@ -130,9 +121,7 @@ class Tools(commands.Cog):
         )
 
         msg += "[ACCESS]:\n{}\n\n".format(", ".join(can_access))
-        msg += "[NO ACCESS]:\n{}\n```".format(
-            ", ".join(list(set(text_channels) - set(can_access)))
-        )
+        msg += "[NO ACCESS]:\n{}\n```".format(", ".join(list(set(text_channels) - set(can_access))))
         await ctx.send(msg)
 
     @access.command()
@@ -146,14 +135,10 @@ class Tools(commands.Cog):
             guild = self.bot.get_guild(guild)
 
         try:
-            can_access = [
-                c.name for c in guild.voice_channels if c.permissions_for(user).connect is True
-            ]
+            can_access = [c.name for c in guild.voice_channels if c.permissions_for(user).connect is True]
             voice_channels = [c.name for c in guild.voice_channels]
         except AttributeError:
-            return await ctx.send(
-                "User is not in that guild or I do not have access to that guild."
-            )
+            return await ctx.send("User is not in that guild or I do not have access to that guild.")
 
         prefix = "You have" if user.id == ctx.author.id else user.name + " has"
         msg = "```ini\n[{} access to {} out of {} voice channels]\n\n".format(
@@ -161,9 +146,7 @@ class Tools(commands.Cog):
         )
 
         msg += "[ACCESS]:\n{}\n\n".format(", ".join(can_access))
-        msg += "[NO ACCESS]:\n{}\n```".format(
-            ", ".join(list(set(voice_channels) - set(can_access)))
-        )
+        msg += "[NO ACCESS]:\n{}\n```".format(", ".join(list(set(voice_channels) - set(can_access))))
         await ctx.send(msg)
 
     @commands.guild_only()
@@ -190,8 +173,7 @@ class Tools(commands.Cog):
         embed_list = []
         for page in cf.pagify(msg, shorten_by=1400):
             embed = discord.Embed(
-                description="**Total bans:** {}\n\n{}".format(bancount, page),
-                colour=await ctx.embed_colour(),
+                description="**Total bans:** {}\n\n{}".format(bancount, page), colour=await ctx.embed_colour(),
             )
             embed_list.append(embed)
         await menu(ctx, embed_list, DEFAULT_CONTROLS)
@@ -274,7 +256,13 @@ class Tools(commands.Cog):
         """Check members in the role specified."""
         guild = ctx.guild
         await ctx.trigger_typing()
-        role = discord.utils.find(lambda r: r.name.lower() == rolename.lower(), guild.roles)
+        if rolename.startswith("<@&"):
+            role_id = int(re.search(r"<@&(.{18})>$", rolename)[1])
+            role = discord.utils.get(ctx.guild.roles, id=role_id)
+        elif len(rolename) in [17, 18] and rolename.isdigit():
+            role = discord.utils.get(ctx.guild.roles, id=int(rolename))
+        else:
+            role = discord.utils.find(lambda r: r.name.lower() == rolename.lower(), guild.roles)
 
         if role is None:
             roles = []
@@ -285,84 +273,100 @@ class Tools(commands.Cog):
             if len(roles) == 1:
                 role = roles[0]
             elif len(roles) < 1:
-                await ctx.send("No roles were found")
+                await ctx.send("No roles were found.")
                 return
             else:
-                msg = "**Roles found with** {} **in the name.**\n\n".format(rolename)
+                msg = (
+                    f"**{len(roles)} roles found with** `{rolename}` **in the name.**\n"
+                    f"Type the number of the role you wish to see.\n\n"
+                )
                 tbul8 = []
                 for num, role in enumerate(roles):
                     tbul8.append([num + 1, role.name])
                 m1 = await ctx.send(msg + tabulate(tbul8, tablefmt="plain"))
 
                 def check(m):
-                    if (m.author == author) and (m.channel == ctx.channel):
+                    if (m.author == ctx.author) and (m.channel == ctx.channel):
                         return True
 
-                response = await self.bot.wait_for("message", check=check, timeout=25)
-                if response is None:
+                try:
+                    response = await self.bot.wait_for("message", check=check, timeout=25)
+                except asyncio.TimeoutError:
                     await m1.delete()
                     return
-                elif not response.content.isdigit():
+                if not response.content.isdigit():
                     await m1.delete()
                     return
                 else:
                     response = int(response.content)
 
                 if response not in range(0, len(roles) + 1):
-                    return
+                    return await ctx.send("Cancelled.")
                 elif response == 0:
-                    await ctx.send("Cancelled.")
-                    return
+                    return await ctx.send("Cancelled.")
                 else:
                     role = roles[response - 1]
 
-        if role is not None and len([m for m in guild.members if role in m.roles]) < 50:
-            awaiter = await ctx.send(
-                embed=discord.Embed(
-                    description="Getting member names...", colour=await ctx.embed_colour()
-                )
+        awaiter = await ctx.send(
+            embed=discord.Embed(description="Getting member names...", colour=await ctx.embed_colour())
+        )
+        await asyncio.sleep(1.5)  # taking time to retrieve the names
+        users_in_role = "\n".join(sorted(m.display_name for m in guild.members if role in m.roles))
+        if len(users_in_role) == 0:
+            embed = discord.Embed(
+                description=cf.bold(f"0 users found in the {role.name} role."), colour=await ctx.embed_colour(),
             )
-            await asyncio.sleep(1.5)  # taking time to retrieve the names
-            member = discord.Embed(
-                description="**{1} users found in the {0} role.**\n".format(
+            await awaiter.edit(embed=embed)
+            return
+        try:
+            await awaiter.delete()
+        except discord.NotFound:
+            pass
+        embed_list = []
+        for page in cf.pagify(users_in_role, delims=["\n"], page_length=200):
+            embed = discord.Embed(
+                description=cf.bold("{1} users found in the {0} role.\n").format(
                     role.name, len([m for m in guild.members if role in m.roles])
                 ),
                 colour=await ctx.embed_colour(),
             )
-            if len([m for m in guild.members if role in m.roles]) != 0:
-                member.add_field(
-                    name="Users",
-                    value="\n".join(m.display_name for m in guild.members if role in m.roles),
-                )
-            await awaiter.edit(embed=member)
-
-        elif len([m for m in guild.members if role in m.roles]) > 50:
-            awaiter = await ctx.send(
-                embed=discord.Embed(
-                    description="Getting member names...", colour=await ctx.embed_colour()
-                )
-            )
-            await asyncio.sleep(1.5)
-            await awaiter.edit(
-                embed=discord.Embed(
-                    description="List is too long for **{0}** role, **{1}** members found.\n".format(
-                        role.name, len([m.mention for m in guild.members if role in m.roles])
-                    ),
-                    colour=await ctx.embed_colour(),
-                )
-            )
+            embed.add_field(name="Users", value=page)
+            embed_list.append(embed)
+        final_embed_list = []
+        for i, embed in enumerate(embed_list):
+            embed.set_footer(text=f"Page {i + 1}/{len(embed_list)}")
+            final_embed_list.append(embed)
+        if len(embed_list) == 1:
+            close_control = {"\N{CROSS MARK}": close_menu}
+            await menu(ctx, final_embed_list, close_control)
         else:
+            await menu(ctx, final_embed_list, DEFAULT_CONTROLS)
+
+    @commands.guild_only()
+    @commands.command()
+    async def joined(self, ctx, user: discord.Member = None):
+        """Show when a user joined the guild."""
+        if not user:
+            user = ctx.author
+        if user.joined_at:
+            user_joined = user.joined_at.strftime("%d %b %Y %H:%M")
+            since_joined = (ctx.message.created_at - user.joined_at).days
+            joined_on = f"{user_joined} ({since_joined} days ago)"
+        else:
+            joined_on = "a mysterious date that not even Discord knows."
+
+        if ctx.channel.permissions_for(ctx.guild.me).embed_links:
             embed = discord.Embed(
-                description="Role was not found.", colour=await ctx.embed_colour()
+                description=f"{user.mention} joined this guild on {joined_on}.", color=await ctx.embed_colour(),
             )
-            await awaiter.edit(embed=embed)
+            await ctx.send(embed=embed)
+        else:
+            await ctx.send(f"{user.display_name} joined this guild on {joined_on}.")
 
     @commands.command(name="listguilds", aliases=["listservers", "guildlist", "serverlist"])
     @checks.mod_or_permissions()
     async def listguilds(self, ctx):
-        """
-        List the guilds|servers the bot is in
-        """
+        """List the guilds|servers the bot is in."""
         asciidoc = lambda m: "```asciidoc\n{}\n```".format(m)
         guilds = sorted(self.bot.guilds, key=lambda g: -g.member_count)
         header = ("```\n" "The bot is in the following {} server{}:\n" "```").format(
@@ -373,7 +377,10 @@ class Tools(commands.Cog):
         form = "{gid} :: {mems:0{zpadding}} :: {name}"
         all_forms = [
             form.format(
-                gid=g.id, mems=g.member_count, name=cf.escape(g.name), zpadding=max_zpadding
+                gid=g.id,
+                mems=g.member_count,
+                name=filter_invites(cf.escape(g.name)),
+                zpadding=max_zpadding
             )
             for g in guilds
         ]
@@ -402,9 +409,7 @@ class Tools(commands.Cog):
         topChannels_formed = "\n".join(self.channels_format(top_channels))
         categories_formed = "\n\n".join([self.category_format(tup) for tup in category_channels])
 
-        await ctx.send(
-            f"{ctx.guild.name} has {len(channels)} channel{'s' if len(channels) > 1 else ''}."
-        )
+        await ctx.send(f"{ctx.guild.name} has {len(channels)} channel{'s' if len(channels) > 1 else ''}.")
 
         for page in cf.pagify(topChannels_formed, delims=["\n"], shorten_by=16):
             await ctx.send(asciidoc(page))
@@ -425,9 +430,7 @@ class Tools(commands.Cog):
         header = "{:>33}\n{}\n\n".format(head1, "-" * 57)
 
         user_body = (
-            " {mem}\n"
-            " {spcs}Joined Guild:    {sp1}{join}\n"
-            " {spcs}Account Created: {sp2}{created}\n\n"
+            " {mem} ({memid})\n" " {spcs}Joined Guild:    {sp1}{join}\n" " {spcs}Account Created: {sp2}{created}\n\n"
         )
 
         disp = header
@@ -451,6 +454,7 @@ class Tools(commands.Cog):
 
             disp += user_body.format(
                 mem=member.display_name,
+                memid=member.id,
                 join=self._dynamic_time(member.joined_at),
                 created=self._dynamic_time(member.created_at),
                 spcs=smspc,
@@ -472,7 +476,7 @@ class Tools(commands.Cog):
         perms = iter(ctx.channel.permissions_for(user))
         perms_we_have = ""
         perms_we_dont = ""
-        for x in perms:
+        for x in sorted(perms):
             if "True" in str(x):
                 perms_we_have += "+\t{0}\n".format(str(x).split("'")[1])
             else:
@@ -489,17 +493,13 @@ class Tools(commands.Cog):
         else:
             role = self._role_from_string(ctx.guild, rolename)
         if role is None:
-            await ctx.send(
-                embed=discord.Embed(
-                    description="Cannot find role.", colour=await ctx.embed_colour()
-                )
-            )
+            await ctx.send(embed=discord.Embed(description="Cannot find role.", colour=await ctx.embed_colour()))
             return
         await ctx.send(f"**{rolename} ID:** {role.id}")
 
     @commands.guild_only()
     @commands.command()
-    async def rinfo(self, ctx, *, rolename):
+    async def rinfo(self, ctx, *, rolename: discord.Role):
         """Shows role info."""
         channel = ctx.channel
         guild = ctx.guild
@@ -521,7 +521,7 @@ class Tools(commands.Cog):
             perms = iter(role.permissions)
             perms_we_have = ""
             perms_we_dont = ""
-            for x in perms:
+            for x in sorted(perms):
                 if "True" in str(x):
                     perms_we_have += "{0}\n".format(str(x).split("'")[1])
                 else:
@@ -539,14 +539,12 @@ class Tools(commands.Cog):
                 em.add_field(name="Server", value=role.guild.name)
             em.add_field(name="Role Name", value=role.name)
             em.add_field(name="Created", value=self._dynamic_time(role.created_at))
-            em.add_field(
-                name="Users in Role", value=len([m for m in guild.members if role in m.roles])
-            )
+            em.add_field(name="Users in Role", value=len([m for m in guild.members if role in m.roles]))
             em.add_field(name="ID", value=role.id)
             em.add_field(name="Color", value=role.color)
             em.add_field(name="Position", value=role.position)
-            em.add_field(name="Valid Permissons", value="{}".format(perms_we_have))
-            em.add_field(name="Invalid Permissons", value="{}".format(perms_we_dont))
+            em.add_field(name="Valid Permissions", value="{}".format(perms_we_have))
+            em.add_field(name="Invalid Permissions", value="{}".format(perms_we_dont))
             em.set_thumbnail(url=role.guild.icon_url)
         try:
             await loadingmsg.edit(embed=em)
@@ -560,7 +558,7 @@ class Tools(commands.Cog):
                 perms = iter(role.permissions)
                 perms_we_have2 = ""
                 perms_we_dont2 = ""
-                for x in perms:
+                for x in sorted(perms):
                     if "True" in str(x):
                         perms_we_have2 += "+{0}\n".format(str(x).split("'")[1])
                     else:
@@ -596,8 +594,7 @@ class Tools(commands.Cog):
         embed_list = []
         for page in cf.pagify(rolelist, shorten_by=1400):
             embed = discord.Embed(
-                description=f"**Total roles:** {len(ctx.guild.roles)}\n\n{page}",
-                colour=await ctx.embed_colour(),
+                description=f"**Total roles:** {len(ctx.guild.roles)}\n\n{page}", colour=await ctx.embed_colour(),
             )
             embed_list.append(embed)
         await menu(ctx, embed_list, DEFAULT_CONTROLS)
@@ -609,24 +606,8 @@ class Tools(commands.Cog):
         guild = ctx.guild
         if not user:
             user = author
-        seen = len(
-            set(
-                [
-                    member.guild.name
-                    for member in self.bot.get_all_members()
-                    if member.id == user.id
-                ]
-            )
-        )
-        sharedservers = str(
-            set(
-                [
-                    member.guild.name
-                    for member in self.bot.get_all_members()
-                    if member.id == user.id
-                ]
-            )
-        )
+        seen = len(set([member.guild.name for member in self.bot.get_all_members() if member.id == user.id]))
+        sharedservers = str(set([member.guild.name for member in self.bot.get_all_members() if member.id == user.id]))
         for shared in sharedservers:
             shared = "".strip("'").join(sharedservers).strip("'")
             shared = shared.strip("{").strip("}")
@@ -654,15 +635,7 @@ class Tools(commands.Cog):
                 guild = self.bot.get_guild(int(guild))
             except TypeError:
                 return await ctx.send("Not a valid guild id.")
-        online = str(
-            len(
-                [
-                    m.status
-                    for m in guild.members
-                    if str(m.status) == "online" or str(m.status) == "idle"
-                ]
-            )
-        )
+        online = str(len([m.status for m in guild.members if str(m.status) == "online" or str(m.status) == "idle"]))
         total_users = str(len(guild.members))
         text_channels = [x for x in guild.channels if isinstance(x, discord.TextChannel)]
         voice_channels = [x for x in guild.channels if isinstance(x, discord.VoiceChannel)]
@@ -700,55 +673,41 @@ class Tools(commands.Cog):
         roles = [x.name for x in user.roles if x.name != "@everyone"]
         if not roles:
             roles = ["None"]
-        seen = str(
-            len(
-                set(
-                    [
-                        member.guild.name
-                        for member in self.bot.get_all_members()
-                        if member.id == user.id
-                    ]
-                )
-            )
-        )
+        seen = str(len(set([member.guild.name for member in self.bot.get_all_members() if member.id == user.id])))
 
         load = "```\nLoading user info...```"
         waiting = await ctx.send(load)
 
         data = "```ini\n"
-        data += "[Name]:      {}\n".format(cf.escape(str(user)))
-        data += "[Nickname]:  {}\n".format(cf.escape(str(user.nick)))
-        data += "[ID]:        {}\n".format(user.id)
-        data += "[Status]:    {}\n".format(user.status)
-        data += "[Servers]:   {} shared\n".format(seen)
-        act = user.activity
-        if act is None:
-            pass
-
-        elif act.type == discord.ActivityType.playing:
-            data += "[Playing]:   {}\n".format(cf.escape(str(act.name)))
-        elif act.type == discord.ActivityType.listening:
-            if isinstance(act, discord.Spotify):
-                _form = act.title
+        data += "[Name]:          {}\n".format(cf.escape(str(user)))
+        if user.nick is not None:
+            data += "[Nickname]:      {}\n".format(cf.escape(str(user.nick)))
+        data += "[ID]:            {}\n".format(user.id)
+        data += "[Status]:        {}\n".format(user.status)
+        data += "[Servers]:       {} shared\n".format(seen)
+        if actplay := discord.utils.get(user.activities, type=discord.ActivityType.playing):
+            data += "[Playing]:       {}\n".format(cf.escape(str(actplay.name)))
+        if actlisten := discord.utils.get(user.activities, type=discord.ActivityType.listening):
+            if isinstance(actlisten, discord.Spotify):
+                _form = "{} - {}".format(actlisten.artist, actlisten.title)
             else:
-                _form = act.name
-            data += "[Listening]: {}\n".format(cf.escape(_form))
-        elif act.type == discord.ActivityType.listening:
-            data += "[Watching]:   {}\n".format(cf.escape(str(user.activity.name)))
-        else:
-            data += "[Streaming]: [{}]({})\n".format(
-                cf.escape(str(user.activity.name)), cf.escape(user.activity.url)
-            )
+                _form = actlisten.name
+            data += "[Listening]:     {}\n".format(cf.escape(_form))
+        if actwatch := discord.utils.get(user.activities, type=discord.ActivityType.watching):
+            data += "[Watching]:      {}\n".format(cf.escape(str(actwatch.name)))
+        if actstream := discord.utils.get(user.activities, type=discord.ActivityType.streaming):
+            data += "[Streaming]: [{}]({})\n".format(cf.escape(str(actstream.name)), cf.escape(actstream.url))
+        if actcustom := discord.utils.get(user.activities, type=discord.ActivityType.custom):
+            if actcustom.name is not None:
+                data += "[Custom status]: {}\n".format(cf.escape(str(actcustom.name)))
         passed = (ctx.message.created_at - user.created_at).days
-        data += "[Created]:   {}\n".format(self._dynamic_time(user.created_at))
+        data += "[Created]:       {}\n".format(self._dynamic_time(user.created_at))
         joined_at = self.fetch_joined_at(user, ctx.guild)
         if caller != "invoke":
-            data += "[Joined]:    {}\n".format(self._dynamic_time(joined_at))
-            data += "[Roles]:     {}\n".format(", ".join(roles))
-            data += "[In Voice]:  {}\n".format(
-                user.voice.channel if user.voice is not None else None
-            )
-            data += "[AFK]:       {}\n".format(user.voice.afk if user.voice is not None else False)
+            data += "[Joined]:        {}\n".format(self._dynamic_time(joined_at))
+            data += "[Roles]:         {}\n".format(", ".join(roles))
+            data += "[In Voice]:      {}\n".format(user.voice.channel if user.voice is not None else None)
+            data += "[AFK]:           {}\n".format(user.voice.afk if user.voice is not None else False)
         data += "```"
         await asyncio.sleep(1)
         await waiting.edit(content=data)
@@ -861,11 +820,7 @@ class Tools(commands.Cog):
         type_justify = max([len(type_name(c)) for c in channels])
 
         return [
-            channel_form.format(
-                name=c.name[:24].ljust(name_justify),
-                ctype=type_name(c).ljust(type_justify),
-                cid=c.id,
-            )
+            channel_form.format(name=c.name[:24].ljust(name_justify), ctype=type_name(c).ljust(type_justify), cid=c.id,)
             for c in channels
         ]
 

trickortreat/__init__.py

@@ -1,5 +1,14 @@
 from .trickortreat import TrickOrTreat
 
+__red_end_user_data_statement__ = (
+    "This cog does not persistently store end user data. "
+    "This cog does store discord IDs as needed for operation. "
+    "This cog does store user stats for the cog such as their score. "
+    "Users may remove their own content without making a data removal request."
+    "This cog does not support data requests, "
+    "but will respect deletion requests."
+)
+
 
 def setup(bot):
     bot.add_cog(TrickOrTreat(bot))