feat: ✨ Add info command (#30)

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Paillat <me@paillat.dev>

Author: 3 people

pyproject.toml

@@ -37,7 +37,7 @@ extend-ignore = [
     "COM812", # missing-trailing-comma conflicts with formatter
     "D10", # missing docstrings is overkill
 ]
-pydocstyle.convention = "numpy"
+pydocstyle.convention = "pep257"
 
 [tool.ruff.lint.per-file-ignores]
 "src/cogs/*" = [

src/cogs/slash_commands.py

@@ -1,11 +1,14 @@
 import asyncio
 import io
+import time
 from pathlib import Path
 
 import discord
 from discord import option, slash_command
 from PIL import Image, UnidentifiedImageError
 
+from src.exceptions import UnexpectedNoneError
+
 MAX_IMAGE_FILESIZE = 50_000_000  # 50 MB
 SUPPORTED_IMAGE_FORMATS = {"jpeg", "png", "gif", "webp", "tiff", "bmp"}
 TRANSPARENT_FORMATS = {"png", "webp", "tiff"}
@@ -14,6 +17,35 @@
 class SlashCommands(discord.Cog, name="slash_commands"):
     def __init__(self, bot: discord.Bot) -> None:
         self.bot = bot
+        self.started_time = time.time()
+
+    @slash_command()
+    async def info(self, ctx: discord.ApplicationContext) -> None:
+        """Display information about the bot."""
+        if self.bot.user is None:
+            raise UnexpectedNoneError(self.bot, "user")
+
+        container = discord.ui.Container()
+        container.add_text(f"""
+{self.bot.user.name} is a bot developed by [Versa Bots](https://github.com/Versa-Bots/) offering utility commands.""")
+        container.add_separator()
+        container.add_section(
+            discord.ui.TextDisplay(
+                f"""**Users:** {len(self.bot.users)}
+**Servers:** {len(self.bot.guilds)}
+**API Latency:** {round(self.bot.latency * 1000)}ms
+**Pycord Version:** {discord.__version__}
+**Uptime:** {self.format_uptime(time.time() - self.started_time)}
+**Code:** https://github.com/Versa-Bots/versa/"""
+            ),
+            accessory=discord.ui.Thumbnail(url=self.bot.user.display_avatar.url),
+        )
+        inv_button_row = discord.ui.ActionRow(
+            discord.ui.Button(
+                label="Invite", url=f"https://discord.com/api/oauth2/authorize?client_id={self.bot.user.id}"
+            )
+        )
+        await ctx.respond(view=discord.ui.DesignerView(container, inv_button_row))
 
     @slash_command()
     @option("image", discord.Attachment, description="The image to convert")
@@ -86,6 +118,24 @@ def convert_image(image_bytes: bytes, target_filetype: str) -> io.BytesIO:
         buffer.seek(0)
         return buffer
 
+    @staticmethod
+    def format_uptime(seconds: float) -> str:
+        seconds = int(seconds)
+        days, seconds = divmod(seconds, 86400)
+        hours, seconds = divmod(seconds, 3600)
+        minutes, seconds = divmod(seconds, 60)
+
+        parts = []
+        if days:
+            parts.append(f"{days}d")
+        if hours:
+            parts.append(f"{hours}h")
+        if minutes:
+            parts.append(f"{minutes}m")
+        parts.append(f"{seconds}s")
+
+        return " ".join(parts)
+
 
 def setup(bot: discord.Bot) -> None:
     bot.add_cog(SlashCommands(bot))

src/exceptions.py

@@ -0,0 +1,16 @@
+class UnexpectedNoneError(TypeError):
+    """
+    Exception raised when an attribute of an object is unexpectedly None.
+
+    This is raised when access of an optional class member that should never be None is required, and the value
+    of said member is unexpectedly None
+    """
+
+    def __init__(self, obj: object, attr: str) -> None:
+        """
+        Initialize the custom exception raised when an attribute of an object is unexpectedly None.
+
+        :param obj: The object containing the attribute that is None.
+        :param attr: The name of the attribute that is unexpectedly None.
+        """
+        super().__init__(f"{obj.__class__.__name__}.{attr} is None unexpectedly")