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,23 +1,39 @@
 # 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. 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.
 
 chatchart - Generates a pie chart to display chat activity over the last 5000 messages. Requested by violetnyte.
 
-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.
+dadjokes - Another UltimatePancake cog. Get some dad jokes on command.
 
-imgwelcome - The repo can be found at: https://github.com/aikaterna/imgwelcome
+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](https://github.com/aikaterna/aikaterna-cogs/blob/v3/dungeon_readme.md) file on this repo for more information.
+
+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.
 
 nolinks - A very blunt hammer to remove anything that looks like a link. Roles can be whitelisted and it can watch multiple channels.
 
@@ -27,16 +43,32 @@ partycrash - A port of Will's partycrash command from the v2 Admin cog. This cog
 
 pingtime - Show all shards' pingtimes.
 
-retrosign - A v3 port of Anismash's retrosign cog: https://github.com/Anismash/Ani-Cogs/tree/master/retrosign
+pressf - A port/rewrite of NekoTony's v2 pressf cog. Pay your respects by pressing F.
+
+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.
 
 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.
 
 trickortreat - A trick or treat-based competitive candy eating game with a leaderboard and other fun commands like stealing candy from guildmates.
 
 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.
 
-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
+youtube - A v3 port of Paddo's youtube search cog for v2.
+
+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,18 +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)
+
+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": []}
@@ -29,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)
@@ -55,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
@@ -67,6 +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])
 
+    @commands.Cog.listener()
     async def on_message(self, m):
         if not m.attachments:
             return
@@ -95,16 +103,14 @@ 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
 
-    def __unload(self):
+    def cog_unload(self):
         self.bot.loop.create_task(self.session.close())

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,18 +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)
 
-
-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,
@@ -20,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):
@@ -57,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
             )
@@ -96,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
 
@@ -122,11 +164,10 @@ 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:
-                user = await self.bot.get_user_info(int(match.group(1)))
+                user = await self.bot.fetch_user(int(match.group(1)))
                 message = re.sub(match.re, "@" + user.name, message)
         return message
 
@@ -134,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):
@@ -183,6 +235,7 @@ class Away(BaseCog):
             return True
         return False
 
+    @commands.Cog.listener()
     async def on_message(self, message):
         tmp = {}
         guild = message.guild
@@ -196,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):
@@ -300,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)
@@ -311,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
         """
@@ -332,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
         """
@@ -406,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)
@@ -458,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"""
@@ -506,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,16 +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)
 
 
-BaseCog = getattr(commands, "Cog", object)
+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
 
-class Blurplefy(BaseCog):
     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)
 
@@ -40,9 +43,7 @@ class Blurplefy(BaseCog):
         """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
@@ -93,7 +94,7 @@ class Blurplefy(BaseCog):
             else:
                 picture = user.avatar_url
         try:
-            async with self.session.request("GET", picture) as r:
+            async with self.session.request("GET", str(picture)) as r:
                 response = await r.read()
         except ValueError:
             await ctx.send("{}, please link a valid image URL.".format(ctx.author.display_name))
@@ -120,7 +121,7 @@ class Blurplefy(BaseCog):
             role_check = False
 
         try:
-            async with self.session.request("GET", picture) as r:
+            async with self.session.request("GET", str(picture)) as r:
                 response = await r.read()
         except ValueError:
             await ctx.send("{}, please link a valid image URL.".format(ctx.author.display_name))
@@ -142,11 +143,7 @@ class Blurplefy(BaseCog):
             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")
@@ -157,19 +154,11 @@ class Blurplefy(BaseCog):
         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",
@@ -226,7 +215,7 @@ class Blurplefy(BaseCog):
             else:
                 picture = user.avatar_url
         try:
-            async with self.session.request("GET", picture) as r:
+            async with self.session.request("GET", str(picture)) as r:
                 response = await r.read()
         except ValueError:
             await ctx.send("{}, please link a valid image URL.".format(ctx.author.display_name))
@@ -249,20 +238,14 @@ class Blurplefy(BaseCog):
         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)
@@ -325,9 +308,7 @@ class Blurplefy(BaseCog):
                 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
@@ -398,21 +379,13 @@ class Blurplefy(BaseCog):
 
     @commands.command()
     async def countdown(self, ctx):
-        """Countdown to Discord's 4th Anniversary."""
-        embed = discord.Embed(name="", colour=0x7289da)
-        timeleft = (
-            datetime.datetime(2018, 5, 13)
-            + datetime.timedelta(hours=7)
-            - datetime.datetime.utcnow()
-        )
-        embed.set_author(name="Time left until Discord's 4th 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(2019, 5, 13)
-                + datetime.timedelta(hours=7)
-                - datetime.datetime.utcnow()
-            )
-            embed.set_author(name="Time left until Discord's 4th 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())))),
@@ -437,5 +410,5 @@ class Blurplefy(BaseCog):
             msg = ""
         return msg.format(d, h, m, s)
 
-    def __unload(self):
-        self.session.close()
+    def cog_unload(self):
+        self.bot.loop.create_task(self.session.close())

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,8 +1,7 @@
-from redbot.core import commands, data_manager
 from .cah import CardsAgainstHumanity
 
+__red_end_user_data_statement__ = "This cog does not persistently store data or metadata about users."
 
-def setup(bot: commands.Bot):
-    n = CardsAgainstHumanity(bot)
-    data_manager.load_bundled_data(n, __file__)
-    bot.add_cog(n)
+
+def setup(bot):
+    bot.add_cog(CardsAgainstHumanity(bot))

cah/info.json

@@ -0,0 +1,19 @@
+{
+	"author": [
+		"aikaterna"
+	],
+	"description": "Cards Against Humanity, played in DMs.",
+    "install_msg": "Warning: This cog can send a lot of DMs, and the bot can become rate limited. Be warned that installing this cog on a bot with a lot of users or servers might be detrimental to the bot's performance. Thanks for installing, have fun.",
+    "permissions" : [
+		"embed_links",
+		"manage_roles"
+	],
+	"short": "Cards Against Humanity.",
+	"tags": [
+		"CAH",
+        "cards",
+        "games"
+	],
+	"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

@@ -0,0 +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

@@ -0,0 +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:
+            result = await r.text()
+            await ctx.send(f"`{result}`")

dadjokes/info.json

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

dictionary/__init__.py

@@ -0,0 +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

@@ -0,0 +1,140 @@
+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()
+
+    def cog_unload(self):
+        self.bot.loop.create_task(self.session.close())
+
+    async def _get_soup_object(self, url):
+        try:
+            async with self.session.request("GET", url) as response:
+                return BeautifulSoup(await response.text(), "html.parser")
+        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_term = word.split(" ", 1)[0]
+        result = await self._antonym(ctx, search_term)
+        if not result:
+            await ctx.send("This word is not in the dictionary.")
+            return 
+
+        result_text = "*, *".join(result)
+        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}")
+        if not data:
+            return await ctx.send("Error fetching data.")
+        section = data.find_all("ul", {"class": "css-1ytlws2 et6tpn80"})
+        try:
+            section[1]
+        except IndexError:
+            return
+        spans = section[1].findAll("li")
+        antonyms = [span.text for span in spans[:50]]
+        return antonyms
+
+    @commands.command()
+    async def define(self, ctx, *, word: str):
+        """Displays definitions of a given word."""
+        search_msg = await ctx.send("Searching...")
+        search_term = word.split(" ", 1)[0]
+        result = await self._definition(ctx, search_term)
+        str_buffer = ""
+        if not result:
+            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
+            j = False
+            for val in result[key]:
+                if val.startswith("("):
+                    str_buffer += f"{str(counter)}. *{val})* "
+                    counter += 1
+                    j = True
+                else:
+                    if j:
+                        str_buffer += f"{val}\n"
+                        j = False
+                    else:
+                        str_buffer += f"{str(counter)}. {val}\n"
+                        counter += 1
+        await search_msg.delete()
+        for page in pagify(str_buffer, delims=["\n"]):
+            await ctx.send(page)
+
+    async def _definition(self, ctx, word):
+        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 = data.findAll("ul")
+        out = {}
+        if not lists:
+            return
+        for a in types:
+            reg = str(lists[types.index(a)])
+            meanings = []
+            for x in re.findall(r">\s\((.*?)\)\s<", reg):
+                if "often followed by" in x:
+                    pass
+                elif len(x) > 5 or " " in str(x):
+                    meanings.append(x)
+            name = a.text
+            out[name] = meanings
+        return out
+
+    async def _synonym(self, ctx, word):
+        data = await self._get_soup_object(f"http://www.thesaurus.com/browse/{word}")
+        if not data:
+            return await ctx.send("Error fetching data.")
+        section = data.find_all("ul", {"class": "css-1ytlws2 et6tpn80"})
+        try:
+            section[1]
+        except IndexError:
+            return
+        spans = section[0].findAll("li")
+        synonyms = [span.text for span in spans[:50]]
+        return synonyms
+
+    @commands.command()
+    async def synonym(self, ctx, *, word: str):
+        """Displays synonyms for a given word."""
+        search_term = word.split(" ", 1)[0]
+        result = await self._synonym(ctx, search_term)
+        if not result:
+            await ctx.send("This word is not in the dictionary.")
+            return
+
+        result_text = "*, *".join(result)
+        msg = f"Synonyms for **{search_term}**: *{result_text}*"
+        for page in pagify(msg, delims=["\n"]):
+            await ctx.send(page)

dictionary/info.json

@@ -0,0 +1,16 @@
+{
+	"author": [
+		"UltimatePancake", "aikaterna"
+	],
+	"description": "Gets definitions, antonyms, or synonyms for given words",
+	"install_msg": "After loading the cog with `[p]load dictionary`, use [p]help Dictionary to view commands.",
+	"short": "Gets definitions, antonyms, or synonyms for given words",
+	"tags": [
+		"dictionary"
+	],
+	"requirements": [
+		"beautifulsoup4"
+	],
+	"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,15 +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.data_manager import cog_data_path
+from redbot.core.utils.chat_formatting import box, pagify
 
 
-BaseCog = getattr(commands, "Cog", object)
+log = logging.getLogger("red.aikaterna.dungeon")
 
-class Dungeon(BaseCog):
+
+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)
@@ -19,6 +36,7 @@ class Dungeon(BaseCog):
             "auto_ban": False,
             "auto_ban_message": None,
             "auto_blacklist": False,
+            "bypass": [],
             "dm_message": None,
             "dm_toggle": False,
             "dungeon_channel": None,
@@ -44,33 +62,32 @@ class Dungeon(BaseCog):
         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)
@@ -85,9 +102,7 @@ class Dungeon(BaseCog):
         """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):
@@ -102,9 +117,7 @@ class Dungeon(BaseCog):
         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}")
@@ -116,6 +129,35 @@ class Dungeon(BaseCog):
         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."""
@@ -175,7 +217,7 @@ class Dungeon(BaseCog):
         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)
@@ -206,7 +248,10 @@ class Dungeon(BaseCog):
         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)
 
@@ -218,13 +263,10 @@ class Dungeon(BaseCog):
                 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(
@@ -238,18 +280,14 @@ class Dungeon(BaseCog):
             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):
@@ -257,11 +295,7 @@ class Dungeon(BaseCog):
         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")
 
@@ -270,9 +304,7 @@ class Dungeon(BaseCog):
                 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
             )
@@ -288,7 +320,7 @@ class Dungeon(BaseCog):
             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:
@@ -348,6 +380,7 @@ class Dungeon(BaseCog):
         embed = discord.Embed(colour=ctx.guild.me.top_role.colour, description=msg)
         return await ctx.send(embed=embed)
 
+    @commands.Cog.listener()
     async def on_member_join(self, member):
         default_avatar = False
         toggle = await self.config.guild(member.guild).toggle()
@@ -365,16 +398,37 @@ class Dungeon(BaseCog):
         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)
@@ -384,51 +438,46 @@ class Dungeon(BaseCog):
                                 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."
@@ -441,12 +490,12 @@ class Dungeon(BaseCog):
                         "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

@@ -3,10 +3,13 @@ import discord
 from redbot.core import commands
 
 
-BaseCog = getattr(commands, "Cog", object)
-
-class Inspirobot(BaseCog):
+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()
@@ -15,9 +18,7 @@ class Inspirobot(BaseCog):
     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)
@@ -25,5 +26,5 @@ class Inspirobot(BaseCog):
         except Exception as e:
             await ctx.send(f"Oops, there was a problem: {e}")
 
-    def __unload(self):
-        self.session.close()
+    def cog_unload(self):
+        self.bot.loop.create_task(self.session.close())

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

@@ -0,0 +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))

noflippedtables/info.json

@@ -0,0 +1,10 @@
+{
+    "name" : "NoFlippedTables",
+    "author" : ["irdumb", "aikaterna"],
+    "short" : "Unflip some tables.",
+    "description" : "Unflip all the flipped tables.",
+    "install_msg" : "Usage: [p]help tableset",
+    "tags" : ["noflippedtables", "no flip", "tables"],
+    "disabled" : false,
+	"end_user_data_statement": "This cog does not persistently store data or metadata about users."
+}

noflippedtables/noflippedtables.py

@@ -0,0 +1,137 @@
+import asyncio
+from random import uniform as randfloat
+import re
+from redbot.core import commands, checks, Config
+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)
+
+        default_guild = {
+            "ALL_TABLES": True,
+            "BOT_EXEMPT": False,
+            "SNACKBEAR": False,
+            "TOGGLE": False,
+        }
+
+        self.config.register_guild(**default_guild)
+
+        self.flippedTables = {}
+
+    @checks.mod_or_permissions(manage_guild=True)
+    @commands.group()
+    async def tableset(self, ctx):
+        """Got some nice settings for my UNflipped tables"""
+        if ctx.invoked_subcommand is None:
+            settings = await self.config.guild(ctx.guild).all()
+            msg = "[Current Settings]\n"
+            for k, v in settings.items():
+                msg += str(k) + ": " + str(v) + "\n"
+            await ctx.send(box(msg, lang="ini"))
+
+    @tableset.command()
+    async def flipall(self, ctx):
+        """Enables/disables right all unflipped tables in a message"""
+        settings = await self.config.guild(ctx.guild).ALL_TABLES()
+        await self.config.guild(ctx.guild).ALL_TABLES.set(not settings)
+        if not settings:
+            await ctx.send("All tables will now be unflipped.")
+        else:
+            await ctx.send("Now only one table unflipped per message.")
+
+    @tableset.command()
+    async def flipbot(self, ctx):
+        """Enables/disables allowing bot to flip tables"""
+        settings = await self.config.guild(ctx.guild).BOT_EXEMPT()
+        await self.config.guild(ctx.guild).BOT_EXEMPT.set(not settings)
+        if not settings:
+            await ctx.send("Bot is now allowed to leave its own tables flipped.")
+        else:
+            await ctx.send("Bot must now unflip tables that itself flips.")
+
+    @tableset.command()
+    async def snackbear(self, ctx):
+        """Snackburr is unflipping tables!"""
+        settings = await self.config.guild(ctx.guild).SNACKBEAR()
+        await self.config.guild(ctx.guild).SNACKBEAR.set(not settings)
+        if not settings:
+            await ctx.send("Snackburr will now unflip tables.")
+        else:
+            await ctx.send("Snackburr is heading off for his errands!")
+
+    @tableset.command()
+    async def toggle(self, ctx):
+        """Toggle the unflipping on or off."""
+        settings = await self.config.guild(ctx.guild).TOGGLE()
+        await self.config.guild(ctx.guild).TOGGLE.set(not settings)
+        if not settings:
+            await ctx.send("No table shall be left unflipped in this server.")
+        else:
+            await ctx.send("No more unflipping here.")
+
+    @commands.Cog.listener()
+    # so much fluff just for this OpieOP
+    async def on_message(self, message):
+        channel = message.channel
+        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()
+        if not toggle:
+            return
+        if channel.id not in self.flippedTables:
+            self.flippedTables[channel.id] = {}
+        # ┬─┬ ┬┬ ┻┻ ┻━┻ ┬───┬ ┻━┻ will leave 3 tables left flipped
+        # count flipped tables
+        for m in re.finditer("┻━*┻|┬─*┬", message.content):
+            t = m.group()
+            bot_exempt = await self.config.guild(message.guild).BOT_EXEMPT()
+            if "┻" in t and not (message.author.id == self.bot.user.id and bot_exempt):
+                if t in self.flippedTables[channel.id]:
+                    self.flippedTables[channel.id][t] += 1
+                else:
+                    self.flippedTables[channel.id][t] = 1
+                    all_tables = await self.config.guild(message.guild).ALL_TABLES()
+                    if not all_tables:
+                        break
+            else:
+                f = t.replace("┬", "┻").replace("─", "━")
+                if f in self.flippedTables[channel.id]:
+                    if self.flippedTables[channel.id][f] <= 0:
+                        del self.flippedTables[channel.id][f]
+                    else:
+                        self.flippedTables[channel.id][f] -= 1
+        # wait random time. some tables may be unflipped by now.
+        await asyncio.sleep(randfloat(0, 1.5))
+        tables = ""
+
+        deleteTables = []
+        # unflip tables in self.flippedTables[channel.id]
+        for t, n in self.flippedTables[channel.id].items():
+            snackburr = await self.config.guild(message.guild).SNACKBEAR()
+            if snackburr:
+                unflipped = t.replace("┻", "┬").replace("━", "─") + " ノʕ •ᴥ•ノʔ" + "\n"
+            else:
+                unflipped = t.replace("┻", "┬").replace("━", "─") + " ノ( ゜-゜ノ)" + "\n"
+            for i in range(0, n):
+                tables += unflipped
+                # in case being processed in parallel
+                self.flippedTables[channel.id][t] -= 1
+            deleteTables.append(t)
+        for t in deleteTables:
+            del self.flippedTables[channel.id][t]
+        if tables != "":
+            await channel.send(tables)

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,10 +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)
 
-class NoLinks(BaseCog):
+class NoLinks(commands.Cog):
+    """A heavy-handed hammer for anything that looks like a link."""
+
+    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, 2740131001, force_registration=True)
@@ -104,6 +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.")
 
+    @commands.Cog.listener()
     async def on_message(self, message):
         if isinstance(message.channel, discord.abc.PrivateChannel):
             return
@@ -126,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)
@@ -143,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,34 +1,194 @@
+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}"
 
 
-class Otherbot(BaseCog):
-    def __init__(self, bot):
+class Otherbot(commands.Cog):
+    __author__ = ["aikaterna", "Predä 。#1001"]
+    __version__ = "0.10"
+
+    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):
-        """Sets the channel to report in."""
+    async def channel(self, ctx: commands.Context, channel: discord.TextChannel = None):
+        """
+        Sets the channel to report in.
+        
+        Default to the current one.
+        """
+        if not channel:
+            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)
@@ -36,52 +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.get_user_info(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."
             )
 
-    async def on_member_update(self, before, after):
-        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.')
+        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:
-            pass
+            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 = 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

@@ -0,0 +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

@@ -0,0 +1,14 @@
+{
+    "author": [
+        "aikaterna"
+    ],
+    "description": "Pay respects to a thing or user by pressing f.",
+    "install_msg": "Thanks for installing, have fun.",
+    "short": "Press f to pay respects.",
+    "tags": [
+        "pressf",
+        "respects"
+    ],
+    "type": "COG",
+	"end_user_data_statement": "This cog does not persistently store data or metadata about users."
+}

pressf/pressf.py

@@ -0,0 +1,70 @@
+import asyncio
+import discord
+from redbot.core import commands
+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 = {}
+
+    @commands.command()
+    @commands.bot_has_permissions(add_reactions=True)
+    async def pressf(self, ctx, *, user: discord.User = None):
+        """Pay respects by pressing F"""
+        if str(ctx.channel.id) in self.channels:
+            return await ctx.send(
+                "Oops! I'm still paying respects in this channel, you'll have to wait until I'm done."
+            )
+        self.channels[str(ctx.channel.id)] = {}
+
+        if user:
+            answer = user.display_name
+        else:
+            await ctx.send("What do you want to pay respects to?")
+
+            def check(m):
+                return m.author == ctx.author and m.channel == ctx.channel
+
+            try:
+                pressf = await ctx.bot.wait_for("message", timeout=120.0, check=check)
+            except asyncio.TimeoutError:
+                del self.channels[str(ctx.channel.id)]
+                return await ctx.send("You took too long to reply.")
+
+            answer = pressf.content[:1900]
+
+        message = await ctx.send(
+            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": []}
+        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"])
+        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)]
+
+    @commands.Cog.listener()
+    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:
+            return
+        if user.id == self.bot.user.id:
+            return
+        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)

pupper/__init__.py

@@ -0,0 +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

@@ -0,0 +1,13 @@
+{
+	"author": [
+		"aikaterna"
+	],
+	"description": "Pupper is a configurable pet that can hand out credits.",
+    "install_msg": "This cog and its countdowns are triggered by messages. If your bot doesn't see any messages posted anywhere in any server, the pet will never come around. This pet helps to keep chat active but it needs to be slightly active in the first place. If you see a message asking for pats (or whatever other greeting message you set), the first person to react with a wave emoji will get a random amount of credits. This cog also deletes the messages involved in the game, which can lead to channels showing an unread message when there really isn't anything there any more. Use `[p]help pets` to get started. If this command doesn't work for you, the `pets` command is only usable by people with the bot's Admin or Mod role, or if the user has administrative perms on the Discord server.",
+	"short": "Pet the dog.",
+	"tags": [
+		"pets"
+	],
+	"type": "COG",
+	"end_user_data_statement": "This cog does not persistently store data or metadata about users."
+}

pupper/pupper.py

@@ -0,0 +1,279 @@
+import asyncio
+import datetime
+import discord
+import logging
+import random
+from redbot.core import commands, checks, Config, bank
+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)
+        self.pets = {}
+
+        default_guild = {
+            "borf_msg": "borf! (thank for pats h00man, have a doggocoin)",
+            "channel": [],
+            "cooldown": 3600,
+            "credits": [100, 500],
+            "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)
+
+    @commands.guild_only()
+    @checks.mod_or_permissions(administrator=True)
+    @commands.group()
+    async def pets(self, ctx):
+        """Manage your pet."""
+        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()
+        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()
+    async def cooldown(self, ctx, seconds: int = None):
+        """Set the pet appearance cooldown in seconds. 
+
+        300s/5 minute minimum. Default is 3600s/1 hour."""
+
+        if not seconds:
+            seconds = 3600
+        if seconds < 300:
+            seconds = 300
+        await self.config.guild(ctx.guild).cooldown.set(seconds)
+        await ctx.send(f"Pet appearance cooldown set to {seconds}.")
+
+    @pets.command()
+    async def credits(self, ctx, min_amt: int, max_amt: int):
+        """Set the pet credits range on successful petting."""
+        if min_amt > max_amt:
+            return await ctx.send("Min must be less than max.")
+        if min_amt < 1 or max_amt < 1:
+            return await ctx.send("Min and max amounts must be greater than 1.")
+        await self.config.guild(ctx.guild).credits.set([min_amt, max_amt])
+        await ctx.send(f"Pet credit range set to {min_amt} - {max_amt}.")
+
+    @pets.command()
+    async def hello(self, ctx, *, message: str = None):
+        """Set the pet greeting message."""
+        if not message:
+            hello = await self.config.guild(ctx.guild).hello_msg()
+            return await ctx.send(
+                f"Current greeting message: `{hello}`\nUse this command with the message you would like to set."
+            )
+        if len(message) > 1000:
+            return await ctx.send("That dog sure likes to talk a lot. Try a shorter message.")
+        await self.config.guild(ctx.guild).hello_msg.set(message)
+        await ctx.send(f"Pet hello message set to: `{message}`.")
+
+    @pets.command()
+    async def thanks(self, ctx, *, message: str = None):
+        """Set the pet thanks message."""
+        if not message:
+            bye = await self.config.guild(ctx.guild).borf_msg()
+            return await ctx.send(
+                f"Current thanks message: `{bye}`\nUse this command with the message you would like to set."
+            )
+        if len(message) > 1000:
+            return await ctx.send("That dog sure likes to talk a lot. Try a shorter message.")
+        await self.config.guild(ctx.guild).borf_msg.set(message)
+        await ctx.send(f"Pet thanks message set to: `{message}`.")
+
+    @commands.guild_only()
+    @checks.mod_or_permissions(administrator=True)
+    @pets.group(invoke_without_command=True)
+    async def channel(self, ctx):
+        """Channel management for pet appearance."""
+        await ctx.send_help()
+        channel_list = await self.config.guild(ctx.guild).channel()
+        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, lang="ini"))
+
+    @channel.command()
+    async def add(self, ctx, channel: discord.TextChannel):
+        """Add a text channel for pets."""
+        channel_list = await self.config.guild(ctx.guild).channel()
+        if channel.id not in channel_list:
+            channel_list.append(channel.id)
+            await self.config.guild(ctx.guild).channel.set(channel_list)
+            await ctx.send(f"{channel.mention} added to the valid petting channels.")
+        else:
+            await ctx.send(f"{channel.mention} is already in the list of petting channels.")
+
+    @channel.command()
+    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
+        ]
+        channel_list = await self.config.guild(ctx.guild).channel()
+        channels_appended = []
+        channels_in_list = []
+
+        for text_channel in bot_text_channels:
+            if text_channel.id not in channel_list:
+                channel_list.append(text_channel.id)
+                channels_appended.append(text_channel.mention)
+            else:
+                channels_in_list.append(text_channel.mention)
+                pass
+
+        first_msg = ""
+        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"
+        if len(channels_in_list) > 0:
+            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()
+    async def remove(self, ctx, channel: discord.TextChannel):
+        """Remove a text channel from petting."""
+        channel_list = await self.config.guild(ctx.guild).channel()
+        if channel.id in channel_list:
+            channel_list.remove(channel.id)
+        else:
+            return await ctx.send(f"{channel.mention} not in the active channel list.")
+        await self.config.guild(ctx.guild).channel.set(channel_list)
+        await ctx.send(f"{channel.mention} removed from the list of petting channels.")
+
+    @channel.command()
+    async def removeall(self, ctx):
+        """Remove all petting channels from the list."""
+        await self.config.guild(ctx.guild).channel.set([])
+        await ctx.send("All channels have been removed from the list of petting channels.")
+
+    def _pet_lock(self, guild_id, tf):
+        if tf:
+            self.pets[guild_id] = True
+        else:
+            self.pets[guild_id] = False
+
+    @commands.Cog.listener()
+    async def on_message(self, message):
+        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": "👋"}
+
+                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()
+
+                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

@@ -0,0 +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

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

region/region.py

@@ -0,0 +1,51 @@
+import discord
+from redbot.core import checks, commands
+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()
+    async def region(self, ctx, *, region: str):
+        """Set the current guild's voice region."""
+        regions = [
+            "japan",
+            "singapore",
+            "eu-central",
+            "europe",
+            "india",
+            "us-central",
+            "london",
+            "eu-west",
+            "amsterdam",
+            "brazil",
+            "dubai",
+            "us-west",
+            "hongkong",
+            "us-south",
+            "southafrica",
+            "us-east",
+            "sydney",
+            "frankfurt",
+            "russia",
+        ]
+        region = region.replace(" ", "-")
+        if region not in regions:
+            ctx.command.reset_cooldown(ctx)
+            return await ctx.send(
+                f"`{region}` was not found in the list of Discord voice regions. Valid regions are: {humanize_list(regions)}."
+            )
+        try:
+            await ctx.guild.edit(region=region)
+        except discord.errors.Forbidden:
+            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}`.")

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,16 +6,18 @@ 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
 
 
-BaseCog = getattr(commands, "Cog", object)
-
-class Retrosign(BaseCog):
+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()
@@ -28,47 +30,27 @@ class Retrosign(BaseCog):
         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(
-                "http://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"]
@@ -79,5 +61,5 @@ class Retrosign(BaseCog):
                                 image = discord.File(fp=temp_image, filename="image.png")
                                 await ctx.channel.send(file=image)
 
-    def __unload(self):
-        self.session.detach()
+    def cog_unload(self):
+        self.bot.loop.create_task(self.session.close())

rndstatus/__init__.py

@@ -1,7 +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):
-    n = RndStatus(bot)
-    bot.add_listener(n.switch_status, "on_message")
-    bot.add_cog(n)
+    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,38 +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
 
 
-BaseCog = getattr(commands, "Cog", object)
+log = logging.getLogger("red.aikaterna.rndstatus")
 
-class RndStatus(BaseCog):
+
+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.",
-            ],
-            "type": "1",
+            "delay": 300,
+            "statuses": ["her Turn()", "Tomb Raider II", "Transistor", "NEO Scavenger", "Python", "with your heart.",],
+            "streamer": "rndstatusstreamer",
+            "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()
@@ -43,7 +51,6 @@ class RndStatus(BaseCog):
     @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:
@@ -51,112 +58,150 @@ class RndStatus(BaseCog):
         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 name needed for streaming statuses."""
+        saved_streamer = await self.config.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.")
 
     @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."
+            )
 
-    async def switch_status(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()
+        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()
-                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
-            self.last_change = int(time.perf_counter())
-            if (current_game != str(botstatus)) or current_game == None:
-                type = await self.config.type()
-                return await self.bot.change_presence(
-                    activity=discord.Activity(name=botstatus, type=type)
-                )
-
-        if self.last_change == None:
-            self.last_change = int(time.perf_counter())
-            if len(statuses) > 0 and (current_game in statuses or current_game == None):
-                new_status = self.random_status(message, statuses)
-                type = await self.config.type()
-                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()
+            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), 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)
+                            activity=discord.Activity(name=new_status, type=_type), status=status
                         )
 
-    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,12 @@
 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. "
+)
 
-def setup(bot):
-    bot.add_cog(Seen(bot))
+
+async def setup(bot):
+    cog = Seen(bot)
+    await cog.initialize()
+    bot.add_cog(cog)

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,36 +1,105 @@
 import asyncio
+import contextlib
+import datetime
+from typing import Union, Literal
+
 import discord
 import time
-from datetime import datetime
+
 from redbot.core import Config, commands
 
+_SCHEMA_VERSION = 2
 
-BaseCog = getattr(commands, "Cog", object)
 
-class Seen(BaseCog):
-    """Shows last time a user was seen in chat"""
+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)
 
-        default_member = {"member_seen": []}
+        default_global = dict(schema_version=1)
+        default_member = dict(seen=None)
 
+        self.config.register_global(**default_global)
         self.config.register_member(**default_member)
 
+        self._cache = {}
+        self._task = self.bot.loop.create_task(self._save_to_config())
+
+    async def initialize(self):
+        asyncio.ensure_future(
+            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):
+        if from_version == to_version:
+            return
+        elif from_version < to_version:
+            all_guild_data = await self.config.all_members()
+            users_data = {}
+            for guild_id, guild_data in all_guild_data.items():
+                for user_id, user_data in guild_data.items():
+                    for _, v in user_data.items():
+                        if not v:
+                            v = None
+                        if user_id not in users_data:
+                            users_data[guild_id][user_id] = {"seen": v}
+                        else:
+                            if (v and not users_data[guild_id][user_id]["seen"]) or (
+                                v
+                                and users_data[guild_id][user_id]["seen"]
+                                and v > users_data[guild_id][user_id]["seen"]
+                            ):
+                                users_data[guild_id][user_id] = {"seen": v}
+
+            group = self.config._get_base_group(self.config.MEMBER)  # Bulk update to new scope
+            async with group.all() as new_data:
+                for guild_id, member_data in users_data.items():
+                    new_data[guild_id] = member_data
+
+            # new schema is now in place
+            await self.config.schema_version.set(_SCHEMA_VERSION)
+
+            # migration done, now let's delete all the old stuff
+            await self.config.clear_all_members()
+
     @commands.guild_only()
     @commands.command(name="seen")
+    @commands.bot_has_permissions(embed_links=True)
     async def _seen(self, ctx, author: discord.Member):
-        """Shows last time a user was seen in chat"""
-        member_seen = await self.config.member(author).member_seen()
-        now = int(time.time())
-        try:
-            time_elapsed = int(now - member_seen)
-        except TypeError:
-            embed = discord.Embed(
-                colour=discord.Color.red(), title="I haven't seen that user yet."
-            )
+        """Shows last time a user was seen in chat."""
+        member_seen_config = await self.config.member(author).seen()
+        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.")
             return await ctx.send(embed=embed)
+
+        if not member_seen_cache:
+            member_seen = member_seen_config
+        elif not member_seen_config:
+            member_seen = member_seen_cache
+        elif member_seen_cache > member_seen_config:
+            member_seen = member_seen_cache
+        elif member_seen_config > member_seen_cache:
+            member_seen = member_seen_config
+        else:
+            member_seen = member_seen_cache or member_seen_config
+
+        now = int(time.time())
+        time_elapsed = int(now - member_seen)
         output = self._dynamic_time(time_elapsed)
+
         if output[2] < 1:
             ts = "just now"
         else:
@@ -48,26 +117,81 @@ class Seen(BaseCog):
             elif output[2] > 1:
                 ts += "{} minutes ago".format(output[2])
         em = discord.Embed(colour=discord.Color.green())
-        avatar = author.avatar_url if author.avatar else author.default_avatar_url
+        avatar = author.avatar_url or author.default_avatar_url
         em.set_author(name="{} was seen {}".format(author.display_name, ts), icon_url=avatar)
         await ctx.send(embed=em)
 
-    def _dynamic_time(self, time_elapsed):
+    @staticmethod
+    def _dynamic_time(time_elapsed):
         m, s = divmod(time_elapsed, 60)
         h, m = divmod(m, 60)
         d, h = divmod(h, 24)
-        return (d, h, m)
+        return d, h, m
 
+    @commands.Cog.listener()
     async def on_message(self, message):
-        if (
-            not isinstance(message.channel, discord.abc.PrivateChannel)
-            and self.bot.user.id != message.author.id
-        ):
-            prefixes = await self.bot.get_prefix(message)
-            if not any(message.content.startswith(n) for n in prefixes):
-                author = message.author
-                ts = int(time.time())
-                try:
-                    await self.config.member(author).member_seen.set(ts)
-                except AttributeError:
-                    pass
+        if getattr(message, "guild", None):
+            if message.guild.id not in self._cache:
+                self._cache[message.guild.id] = {}
+            self._cache[message.guild.id][message.author.id] = int(time.time())
+
+    @commands.Cog.listener()
+    async def on_typing(
+        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:
+                self._cache[user.guild.id] = {}
+            self._cache[user.guild.id][user.id] = int(time.time())
+
+    @commands.Cog.listener()
+    async def on_message_edit(self, before: discord.Message, after: discord.Message):
+        if getattr(after, "guild", None):
+            if after.guild.id not in self._cache:
+                self._cache[after.guild.id] = {}
+            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]):
+        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]):
+        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())
+
+    def cog_unload(self):
+        self.bot.loop.create_task(self._clean_up())
+
+    async def _clean_up(self):
+        if self._task:
+            self._task.cancel()
+        if self._cache:
+            group = self.config._get_base_group(self.config.MEMBER)  # Bulk update to config
+            async with group.all() as new_data:
+                for guild_id, member_data in self._cache.items():
+                    if str(guild_id) not in new_data:
+                        new_data[str(guild_id)] = {}
+                    for member_id, seen in member_data.items():
+                        new_data[str(guild_id)][str(member_id)] = {"seen": seen}
+
+    async def _save_to_config(self):
+        await self.bot.wait_until_ready()
+        with contextlib.suppress(asyncio.CancelledError):
+            while True:
+                users_data = self._cache.copy()
+                self._cache = {}
+                group = self.config._get_base_group(self.config.MEMBER)  # Bulk update to config
+                async with group.all() as new_data:
+                    for guild_id, member_data in users_data.items():
+                        if str(guild_id) not in new_data:
+                            new_data[str(guild_id)] = {}
+                        for member_id, seen in member_data.items():
+                            new_data[str(guild_id)][str(member_id)] = {"seen": seen}
+
+                await asyncio.sleep(60)

snacktime/__init__.py

@@ -0,0 +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

@@ -0,0 +1,10 @@
+{
+    "name" : "Snacktime",
+    "author" : ["irdumb", "aikaterna"],
+    "short" : "ʕ •ᴥ•ʔ < It's snacktime, who wants snacks?",
+    "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,
+    "end_user_data_statement": "This cog does not persistently store data or metadata about users."
+}

snacktime/phrases.py

@@ -0,0 +1,129 @@
+FRIENDS = {
+    "Snackburr": "ʕ •ᴥ•ʔ <",
+    "Pancakes": "₍⸍⸌̣ʷ̣̫⸍̣⸌₎ <",
+    "Mr Pickles": "(=｀ェ´=) <",
+    "Satin": "▼・ᴥ・▼ <",
+    "Thunky": "ᘛ⁐̤ᕐᐷ <",
+    "Jingle": "꒰∗'꒳'꒱ <",
+    "FluffButt": r"/ᐠ｡ꞈ｡ᐟ\ <",
+    "Staplefoot": "(￣(エ)￣) <",
+}
+
+
+SNACKBURR_PHRASES = {
+    "SNACKTIME": [
+        "It's snack time!",
+        "I'm back with s'more snacks! Who wants!?",
+        "I'm back errbody! Who wants some snacks!?",
+        "Woo man those errands are crazy! Anyways, anybody want some snacks?",
+        "I got snacks! If nobody wants em, I'm gonna eat em all!!",
+        "Hey, I'm back! Anybody in the mood for some snacks?!",
+        "Heyyaaayayyyaya! I say Hey, I got snacks!",
+        "Heyyaaayayyyaya! I say Hey, What's goin on?... I uh.. I got snacks.",
+        "If anybody has reason why these snacks and my belly should not be wed, speak now or forever hold your peace!",
+        "Got another snack delivery guys!",
+        "Did somebody say snacks?!?! o/",
+        "Choo Choo! it's the pb train! Come on over guys!",
+        "Snacks are here! Dig in! Who wants a plate?",
+        "Pstt.. I got the snacks you were lookin for. <.<",
+        "I hope you guys are hungry! Cause i'm loaded to the brim with snacks!!!",
+        "I was hungry on the way over so I kinda started without you guys :3 Who wants snacks!?!",
+        "Beep beep! I got a snack delivery comin in! Who wants snacks!",
+        "Guess what time it is?! It's snacktime!! Who wants?!",
+        "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": [
+        "I guess nobody wants snacks... more for me!",
+        "Guess nobody's here.. I'll just head out then",
+        "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!",
+        "Alright here ya go, {0}, {1} pb for you!",
+        "Yeah! Here you go, {0}! {1} pb!",
+        "Of course {0}! Here's {1} pb!",
+        "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!",
+        "Oh! {0}, you caught me right before I left! Alright, i'll give you {1} of my own pb",
+    ],
+    "GREEDY": [
+        "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!",
+    ],
+    "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

@@ -0,0 +1,474 @@
+import asyncio
+import discord
+import logging
+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
+
+
+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)
+
+        self.snackSchedule = {}
+        self.snacktimePrediction = {}
+        self.previousSpeaker = {}
+        self.snackInProgress = {}
+        self.acceptInput = {}
+        self.alreadySnacked = {}
+        self.msgsPassed = {}
+        self.startLock = {}
+        self.snacktimeCheckLock = {}
+        self.lockRequests = {}
+        self.channel_persona = {}
+
+        default_guild = {
+            "DELIVER_CHANNELS": [],
+            "FRIENDS": False,
+            "EVENT_START_DELAY": 1800,
+            "EVENT_START_DELAY_VARIANCE": 900,
+            "SNACK_DURATION": 240,
+            "SNACK_DURATION_VARIANCE": 120,
+            "MSGS_BEFORE_EVENT": 8,
+            "SNACK_AMOUNT": 200,
+        }
+
+        default_channel = {"repeatMissedSnacktimes": 0}
+
+        self.config.register_guild(**default_guild)
+        self.config.register_channel(**default_channel)
+
+    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" if message else "ʕ •ᴥ•ʔ <"
+        elif invite_friends is True:
+            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}"
+        persona = self.channel_persona[scid]
+        persona_phrase = FRIENDS.get(persona)
+        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)
+    async def snackset(self, ctx):
+        """snack stuff"""
+        if ctx.invoked_subcommand is None:
+            guild_data = await self.config.guild(ctx.guild).all()
+            if not guild_data["DELIVER_CHANNELS"]:
+                channel_names = ["No channels set."]
+            else:
+                channel_names = []
+                for channel_id in guild_data["DELIVER_CHANNELS"]:
+                    channel_obj = self.bot.get_channel(channel_id)
+                    channel_names.append(channel_obj.name)
+
+            if guild_data["FRIENDS"] is True:
+                invite_friends = "Friends only"
+            elif guild_data["FRIENDS"] is False:
+                invite_friends = "Snackburr only"
+            else:
+                invite_friends = "Everyone's invited!"
+
+            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"[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"
+            msg += f"[Snack duration]:          {guild_data['SNACK_DURATION']} seconds\n"
+            msg += f"[Snack duration variance]: {guild_data['SNACK_DURATION_VARIANCE']} seconds\n"
+
+            for page in pagify(msg, delims=["\n"]):
+                await ctx.send(box(page, lang="ini"))
+
+    @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()
+        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!")
+
+    @snackset.command()
+    async def errandvariance(self, ctx, seconds: int):
+        """How early or late snackburr might be to snacktime"""
+        event_start_delay = await self.config.guild(ctx.guild).EVENT_START_DELAY()
+        if seconds >= event_start_delay:
+            await ctx.send("errandvariance must be less than errandtime!")
+        elif seconds < 0:
+            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")
+
+    @snackset.command(name="snacktime")
+    async def snacktimetime(self, ctx, seconds: int):
+        """How long snackburr will hang out giving out snacks!.. more or less."""
+        snack_duration_variance = await self.config.guild(ctx.guild).SNACK_DURATION_VARIANCE()
+        if seconds <= snack_duration_variance:
+            await ctx.send("snacktime must be greater than snackvariance!")
+        elif seconds <= 0:
+            await ctx.send("snacktime must be greater than 0")
+        else:
+            await self.config.guild(ctx.guild).SNACK_DURATION.set(seconds)
+            await ctx.send(f"snacktimes will now last around {round(seconds/60, 2)} minutes!")
+
+    @snackset.command(name="snackvariance")
+    async def snacktimevariance(self, ctx, seconds: int):
+        """How early or late snackburr might have to leave for errands"""
+        snack_duration = await self.config.guild(ctx.guild).SNACK_DURATION()
+        if seconds >= snack_duration:
+            await ctx.send("snackvariance must be less than snacktime!")
+        elif seconds < 0:
+            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")
+
+    @snackset.command()
+    async def msgsneeded(self, ctx, amt: int):
+        """How many messages must pass in a conversation before a snacktime can start"""
+        if amt <= 0:
+            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")
+
+    @snackset.command()
+    async def amount(self, ctx, amt: int):
+        """How much pb max snackburr should give out to each person per snacktime"""
+
+        if amt <= 0:
+            await ctx.send("amount must be greater than 0")
+        else:
+            await self.config.guild(ctx.guild).SNACK_AMOUNT.set(amt)
+            await ctx.send(f"snackburr will now give out {amt} pb max per person per snacktime.")
+
+    @snackset.command(name="friends")
+    async def snackset_friends(self, ctx, choice: int):
+        """snackburr's friends wanna know what all the hub-bub's about!
+
+        Do you want to
+        1: invite them to the party,
+        2: only allow snackburr to chillax with you guys, or
+        3: kick snackburr out on the curb in favor of his obviously cooler friends?
+        """
+
+        if choice not in (1, 2, 3):
+            return await ctx.send_help()
+
+        choices = {
+            1: ("both", "Everybody's invited!"),
+            2: (False, "You chose to not invite snackburr's friends."),
+            3: (True, "You kick snackburr out in favor of his friends! Ouch. Harsh..."),
+        }
+        choice = choices[choice]
+
+        await self.config.guild(ctx.guild).FRIENDS.set(choice[0])
+        await ctx.send(choice[1])
+
+    @snackset.command()
+    async def deliver(self, ctx):
+        """Asks snackburr to start delivering to this channel"""
+        deliver_channels = await self.config.guild(ctx.guild).DELIVER_CHANNELS()
+        if not deliver_channels:
+            deliver_channels = []
+        if ctx.channel.id not in deliver_channels:
+            deliver_channels.append(ctx.channel.id)
+            await self.config.guild(ctx.guild).DELIVER_CHANNELS.set(deliver_channels)
+            await ctx.send("snackburr will start delivering here!")
+        else:
+            deliver_channels.remove(ctx.channel.id)
+            await self.config.guild(ctx.guild).DELIVER_CHANNELS.set(deliver_channels)
+            await ctx.send("snackburr will stop delivering here!")
+
+    @commands.guild_only()
+    @commands.command()
+    async def snacktime(self, ctx):
+        """Man i'm hungry! When's snackburr gonna get back with more snacks?"""
+        scid = f"{ctx.message.guild.id}-{ctx.message.channel.id}"
+        if self.snacktimePrediction.get(scid, None) == None:
+            if self.acceptInput.get(scid, False):
+                return
+            else:
+                phrases = [
+                    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^)ノ",
+                ]
+                await ctx.send(randchoice(phrases))
+            return
+        seconds = self.snacktimePrediction[scid] - self.bot.loop.time()
+        if self.snacktimeCheckLock.get(scid, False):
+            if randint(1, 4) == 4:
+                await ctx.send("Hey, snackburr's on errands. I ain't his keeper Kappa")
+            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!")
+        else:
+            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
+
+    async def startSnack(self, message):
+        scid = f"{message.guild.id}-{message.channel.id}"
+        if self.acceptInput.get(scid, False):
+            return
+        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
+        self.alreadySnacked[scid] = []
+
+        guild_data = await self.config.guild(message.guild).all()
+
+        duration = guild_data["SNACK_DURATION"] + randint(
+            -guild_data["SNACK_DURATION_VARIANCE"], guild_data["SNACK_DURATION_VARIANCE"]
+        )
+        await asyncio.sleep(duration)
+        # sometimes fails sending messages and stops all future snacktimes. Hopefully this fixes it.
+        try:
+            # list isn't empty
+            if self.alreadySnacked.get(scid, False):
+                await message.channel.send(await self.get_response(message, "OUT"))
+                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)
+                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.channel(message.channel).repeatMissedSnacktimes.set(0)
+        except:
+            log.error("Snacktime: Failed to send message in startSnack")
+        self.acceptInput[scid] = False
+        self.snackInProgress[scid] = False
+
+    @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
+
+        deliver_channels = await self.config.guild(message.guild).DELIVER_CHANNELS()
+        if not deliver_channels:
+            return
+        if message.channel.id not in deliver_channels:
+            return
+        scid = f"{message.guild.id}-{message.channel.id}"
+        if message.author.id != self.bot.user.id:
+            # if nobody has said anything since start
+            if self.previousSpeaker.get(scid, None) == None:
+                self.previousSpeaker[scid] = message.author.id
+            # if new speaker
+            elif self.previousSpeaker[scid] != message.author.id:
+                self.previousSpeaker[scid] = message.author.id
+                msgTime = self.bot.loop.time()
+                # if there's a scheduled snack
+                if self.snackSchedule.get(scid, None) != None:
+                    # if it's time for a snack
+                    if msgTime > self.snackSchedule[scid]:
+                        # 1 schedule at a time, so remove schedule
+                        self.snackSchedule[scid] = None
+                        self.snackInProgress[scid] = True
+
+                        # wait to make it more natural
+                        naturalWait = randint(30, 240)
+                        log.debug(f"Snacktime: snack trigger msg: {message.content}")
+                        log.debug(f"Snacktime: Waiting {str(naturalWait)} seconds")
+                        await asyncio.sleep(naturalWait)
+                        # 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):
+                    self.msgsPassed[scid] = self.msgsPassed.get(scid, 0) + 1
+                    # check for collisions
+                    msgs_before_event = await self.config.guild(message.guild).MSGS_BEFORE_EVENT()
+                    if self.msgsPassed[scid] > msgs_before_event:
+                        self.startLock[scid] = True
+                        if self.lockRequests.get(scid, None) == None:
+                            self.lockRequests[scid] = []
+                        self.lockRequests[scid].append(message)
+                        await asyncio.sleep(1)
+                        log.debug(
+                            f"Snacktime: :-+-|||||-+-: Lock request: {str(self.lockRequests[scid][0] == message)}"
+                        )
+                        if self.lockRequests[scid][0] == message:
+                            await asyncio.sleep(5)
+                            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):
+                                log.debug("Snacktime: Lock: someone got through already.")
+                                return
+                            else:
+                                log.debug(
+                                    "Snacktime: Lock: looks like i'm in the clear. lifting lock. If someone comes now, they should get the lock"
+                                )
+                                self.msgsPassed[scid] = msgs_before_event
+                                self.startLock[scid] = False
+                        else:
+                            log.debug(f"Snacktime: {message.author.name} Failed lock")
+                            return
+                    if self.msgsPassed[scid] == msgs_before_event:
+                        # schedule a snack
+                        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"],
+                        )
+                        log.debug(f"Snacktime: {str(timeTillSnack)} seconds till snacktime")
+                        self.snacktimePrediction[scid] = msgTime + guild_data["EVENT_START_DELAY"]
+                        self.snackSchedule[scid] = msgTime + timeTillSnack
+                        self.msgsPassed[scid] = 0
+
+            # it's snacktime! who want's snacks?
+            if self.acceptInput.get(scid, False):
+                if message.author.id not in self.alreadySnacked.get(scid, []):
+                    agree_phrases = [
+                        "holds out hand",
+                        "im ready",
+                        "i'm ready",
+                        "hit me up",
+                        "hand over",
+                        "hand me",
+                        "kindly",
+                        "i want",
+                        "i'll have",
+                        "ill have",
+                        "yes",
+                        "pls",
+                        "plz",
+                        "please",
+                        "por favor",
+                        "can i",
+                        "i'd like",
+                        "i would",
+                        "may i",
+                        "in my mouth",
+                        "in my belly",
+                        "snack me",
+                        "gimme",
+                        "give me",
+                        "i'll take",
+                        "ill take",
+                        "i am",
+                        "about me",
+                        "me too",
+                        "of course",
+                    ]
+                    userWants = False
+                    for agreePhrase in agree_phrases:
+                        # no one word answers
+                        if agreePhrase in message.content.lower() and len(message.content.split()) > 1:
+                            userWants = True
+                            break
+                    if userWants:
+                        if self.alreadySnacked.get(scid, None) == None:
+                            self.alreadySnacked[scid] = []
+                        self.alreadySnacked[scid].append(message.author.id)
+                        await asyncio.sleep(randint(1, 6))
+                        snack_amount = await self.config.guild(message.guild).SNACK_AMOUNT()
+                        snackAmt = randint(1, snack_amount)
+                        try:
+                            if self.acceptInput.get(scid, False):
+                                resp = await self.get_response(message, "GIVE")
+                                resp = resp.format(message.author.name, snackAmt)
+                                await message.channel.send(resp)
+                            else:
+                                resp = await self.get_response(message, "LAST_SECOND")
+                                resp = resp.format(message.author.name, snackAmt)
+                                await message.channel.send(resp)
+                            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"Failed to send pb message. {message.author.name} didn't get pb\n", exc_info=True,
+                            )
+
+                else:
+                    more_phrases = [
+                        "more pl",
+                        "i have some more",
+                        "i want more",
+                        "i have another",
+                        "i have more",
+                        "more snack",
+                    ]
+                    userWants = False
+                    for morePhrase in more_phrases:
+                        if morePhrase in message.content.lower():
+                            userWants = True
+                            break
+                    if userWants:
+                        await asyncio.sleep(randint(1, 6))
+                        if self.acceptInput.get(scid, False):
+                            resp = await self.get_response(message, "GREEDY")
+                            await message.channel.send(resp.format(message.author.name))

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"They 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,31 +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
 
-BaseCog = getattr(commands, "Cog", object)
+
+log = logging.getLogger("red.aikaterna.tools")
 
 
-class Tools(BaseCog):
+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)
@@ -49,13 +54,9 @@ class Tools(BaseCog):
             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]
@@ -68,9 +69,7 @@ class Tools(BaseCog):
             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
@@ -83,18 +82,14 @@ class Tools(BaseCog):
         )  # 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])
         )
@@ -115,16 +110,10 @@ class Tools(BaseCog):
             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(
@@ -132,9 +121,7 @@ class Tools(BaseCog):
         )
 
         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()
@@ -148,14 +135,10 @@ class Tools(BaseCog):
             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(
@@ -163,9 +146,7 @@ class Tools(BaseCog):
         )
 
         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()
@@ -181,7 +162,7 @@ class Tools(BaseCog):
         bancount = len(banlist)
         ban_list = []
         if bancount == 0:
-            banlist = "No users are banned from this server."
+            msg = "No users are banned from this server."
         else:
             msg = ""
             for user_obj in banlist:
@@ -192,8 +173,7 @@ class Tools(BaseCog):
         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)
@@ -276,7 +256,13 @@ class Tools(BaseCog):
         """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 = []
@@ -287,102 +273,131 @@ class Tools(BaseCog):
             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:
-            embed = discord.Embed(
-                description="Role was not found.", colour=await ctx.embed_colour()
-            )
-            await awaiter.edit(embed=embed)
+            await menu(ctx, final_embed_list, DEFAULT_CONTROLS)
 
-    @commands.command(name='listguilds', aliases=['listservers', 'guildlist', 'serverlist'])
+    @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=f"{user.mention} joined this guild on {joined_on}.", color=await ctx.embed_colour(),
+            )
+            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(len(guilds), 's' if len(guilds) > 1 else '')
+        header = ("```\n" "The bot is in the following {} server{}:\n" "```").format(
+            len(guilds), "s" if len(guilds) > 1 else ""
+        )
 
         max_zpadding = max([len(str(g.member_count)) for g in guilds])
         form = "{gid} :: {mems:0{zpadding}} :: {name}"
-        all_forms = [form.format(gid=g.id, mems=g.member_count, name=g.name, zpadding=max_zpadding) for g in guilds]
-        final = '\n'.join(all_forms)
+        all_forms = [
+            form.format(
+                gid=g.id,
+                mems=g.member_count,
+                name=filter_invites(cf.escape(g.name)),
+                zpadding=max_zpadding
+            )
+            for g in guilds
+        ]
+        final = "\n".join(all_forms)
 
         await ctx.send(header)
-        for page in cf.pagify(final, delims=['\n'], shorten_by=16):
-            await ctx.send(asciidoc(page))
+        page_list = []
+        for page in cf.pagify(final, delims=["\n"], page_length=1000):
+            page_list.append(asciidoc(page))
+
+        if len(page_list) == 1:
+            return await ctx.send(asciidoc(page))
+        await menu(ctx, page_list, DEFAULT_CONTROLS)
 
     @commands.guild_only()
     @checks.mod_or_permissions(manage_channels=True)
-    @commands.command(name='listchannel', aliases=['channellist'])
+    @commands.command(name="listchannel", aliases=["channellist"])
     async def listchannel(self, ctx):
         """
         List the channels of the current server
@@ -391,15 +406,15 @@ class Tools(BaseCog):
         channels = ctx.guild.channels
         top_channels, category_channels = self.sort_channels(ctx.guild.channels)
 
-        topChannels_formed = '\n'.join(self.channels_format(top_channels))
-        categories_formed = '\n\n'.join([self.category_format(tup) for tup in category_channels])
+        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 ''}.")
 
-        for page in cf.pagify(topChannels_formed, delims=['\n'], shorten_by=16):
+        for page in cf.pagify(topChannels_formed, delims=["\n"], shorten_by=16):
             await ctx.send(asciidoc(page))
 
-        for page in cf.pagify(categories_formed, delims=['\n\n'], shorten_by=16):
+        for page in cf.pagify(categories_formed, delims=["\n\n"], shorten_by=16):
             await ctx.send(asciidoc(page))
 
     @commands.guild_only()
@@ -415,9 +430,7 @@ class Tools(BaseCog):
         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
@@ -441,6 +454,7 @@ class Tools(BaseCog):
 
             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,
@@ -462,7 +476,7 @@ class Tools(BaseCog):
         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:
@@ -479,17 +493,13 @@ class Tools(BaseCog):
         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
@@ -511,7 +521,7 @@ class Tools(BaseCog):
             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:
@@ -529,14 +539,12 @@ class Tools(BaseCog):
                 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)
@@ -550,7 +558,7 @@ class Tools(BaseCog):
                 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:
@@ -569,6 +577,28 @@ class Tools(BaseCog):
                 )
             )
 
+    @commands.guild_only()
+    @commands.command(aliases=["listroles"])
+    @checks.mod_or_permissions(manage_guild=True)
+    async def rolelist(self, ctx):
+        """Displays the server's roles."""
+        form = "`{rpos:0{zpadding}}` - `{rid}` - `{rcolor}` - {rment} "
+        max_zpadding = max([len(str(r.position)) for r in ctx.guild.roles])
+        rolelist = [
+            form.format(rpos=r.position, zpadding=max_zpadding, rid=r.id, rment=r.mention, rcolor=r.color)
+            for r in ctx.guild.roles
+        ]
+
+        rolelist = sorted(rolelist, reverse=True)
+        rolelist = "\n".join(rolelist)
+        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(),
+            )
+            embed_list.append(embed)
+        await menu(ctx, embed_list, DEFAULT_CONTROLS)
+
     @commands.command(hidden=True)
     async def sharedservers(self, ctx, user: discord.Member = None):
         """Shows shared server info. Defaults to author."""
@@ -576,24 +606,8 @@ class Tools(BaseCog):
         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("}")
@@ -621,15 +635,7 @@ class Tools(BaseCog):
                 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)]
@@ -667,55 +673,41 @@ class Tools(BaseCog):
         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)
@@ -809,7 +801,10 @@ class Tools(BaseCog):
                 channels.pop(channels.index(c))
                 temp[c.category].append(c)
 
-        category_channels = sorted([(cat, sorted(chans, key=lambda c: c.position)) for cat, chans in temp.items()], key=lambda t: t[0].position)
+        category_channels = sorted(
+            [(cat, sorted(chans, key=lambda c: c.position)) for cat, chans in temp.items()],
+            key=lambda t: t[0].position,
+        )
         return channels, category_channels
 
     def channels_format(self, channels: list):
@@ -824,8 +819,10 @@ class Tools(BaseCog):
         name_justify = max([len(c.name[:24]) for c in channels])
         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) 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,)
+            for c in channels
+        ]
 
     def category_format(self, cat_chan_tuple: tuple):
 
@@ -834,7 +831,7 @@ class Tools(BaseCog):
 
         chfs = self.channels_format(chs)
         if chfs != []:
-            ch_forms = ['\t' + f for f in chfs]
-            return '\n'.join([f'{cat.name} :: {cat.id}'] + ch_forms)
+            ch_forms = ["\t" + f for f in chfs]
+            return "\n".join([f"{cat.name} :: {cat.id}"] + ch_forms)
         else:
-            return '\n'.join([f'{cat.name} :: {cat.id}'] + ['\tNo Channels'])
+            return "\n".join([f"{cat.name} :: {cat.id}"] + ["\tNo 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))