feat(neofetch.py): add new neofetch command to display system and server stats

chore(.pre-commit-config.yaml): add new pre-commit hooks for trailing commas and gitleaks
refactor(cog_loader.py): improve error logging for cog loading failures
style(.pre-commit-config.yaml, cog_loader.py): apply code formatting rules

style(dev.py, eval.py, git.py, mail.py, random.py): improve code readability by breaking down long lines of code into multiple lines
refactor(eval.py): add trailing comma to logger.warning for better code formatting
refactor(git.py): simplify import statement for Issue from githubkit.versions.latest.models
refactor(mail.py): add line breaks for better readability and code consistency
refactor(random.py): add line breaks in function parameters and conditions for better readability

style(xkcd.py, config.py, export.py): refactor function arguments to multi-line for better readability

style: reformat code for better readability in audit.py, commands.py, gate.py, member.py, run.py, temp_vc.py, tty_roles.py, purge.py
refactor: improve code readability by breaking down complex expressions and function calls into multiple lines

style: reformat code for better readability and PEP8 compliance in multiple files

refactor: simplify list declaration in guide.py for better readability

refactor: improve function parameter formatting in multiple files for better readability

refactor: improve string formatting in multiple files for better readability

refactor: improve function declaration formatting in multiple files for better readability

refactor: improve embed creation in rolecount.py for better readability

style(snippets.py, tldr.py, tools.py, wiki.py): reformat code for better readability
refactor(tools.py): simplify dictionary initialization for encodings and decodings
perf(tldr.py, tools.py): reduce subprocess.run arguments to improve performance
fix(wiki.py): correct the order of error handling and embed creation for better error management

refactor(case.py): improve readability by breaking down long function signatures into multiple lines
style(case.py): add trailing commas to improve code formatting and ease of future changes

style(case.py): improve readability by breaking down long function parameters into multiple lines
refactor(case.py): add trailing commas in dictionary to make future changes cleaner and more readable

style(guild_config.py): refactor function definitions to improve readability and adhere to PEP8 line length standards

style: apply PEP 8 style guide to improve readability and maintainability
refactor: add trailing commas to improve diff readability in future changes
fix(event_handler.py): add missing comma in message string to fix syntax error

style: apply black formatting to improve code readability and maintain consistency across the codebase

Author: kzndotsh

tux/cogs/fun/neofetch.py renamed to .archive/neofetch.py

@@ -24,7 +24,7 @@ def __init__(self, bot: commands.Bot) -> None:
     async def neofetch(self, interaction: discord.Interaction) -> None:
         if interaction.guild is None:
             await interaction.response.send_message(
-                content="This command cannot be used in direct messages.", ephemeral=True
+                content="This command cannot be used in direct messages.", ephemeral=True,
             )
             return
 
@@ -52,21 +52,23 @@ async def neofetch(self, interaction: discord.Interaction) -> None:
 ⠙⠲⠦⠥⢥⣅⡕⡐⡐⡐⡐⠌⢌⡾⠟⠟⠛⠛⠛⠛⠽⠾⣇⢂⢂⠢⡑⢌⢂⡶⠋⠀⠀⠀⠀
 ⠀⠀⠀⠀⠀⠀⠈⠑⠒⠶⠬⠞⠊⠀⠀⠀⠀⠀⠀⠀⠀⠀⠘⠢⣆⣑⡬⠖⠋⠀⠀⠀⠀⠀⠀"""
 
+
+
         # get uptime in the format of days, hours, minutes
         uptime = time.strftime("%d days, %H hours, %M minutes", time.gmtime(time.time() - psutil.boot_time()))
         cpuusage = psutil.cpu_percent()
         memusage = psutil.virtual_memory().percent
 
         lines = f"""{yellow}tux{reset}@{yellow}{interaction.guild.name.lower().replace(" ", "")}{reset}
------------------- 
+------------------
 Tux Stats{reset}
 {red}OS{reset}: Tux Alpha
 {yellow}Kernel{reset}: 6.9
 {green}Uptime{reset}: {uptime}
 {cyan}CPU{reset}: {cpuusage}%
 {blue}Memory{reset}: {memusage}%
 {pink}Ping{reset}: {round(self.bot.latency * 1000)}ms
------------------- 
+------------------
 Server Stats{reset}
 {red}Name{reset}: {interaction.guild.name}
 {yellow}Owner{reset}: {interaction.guild.owner}

.pre-commit-config.yaml

@@ -1,4 +1,9 @@
 repos:
+  - repo: https://github.com/asottile/add-trailing-comma
+    rev: v3.1.0
+    hooks:
+      - id: add-trailing-comma
+
   - repo: https://github.com/astral-sh/ruff-pre-commit
     rev: v0.5.0
     hooks:
@@ -7,3 +12,10 @@ repos:
         args: [--fix]
       # Run the formatter.
       - id: ruff-format
+
+  - repo: https://github.com/gitleaks/gitleaks
+    rev: v8.16.1
+    hooks:
+      - id: gitleaks
+
+exclude: ".archive/"

tux/cog_loader.py

@@ -76,7 +76,9 @@ async def load_cogs(self, apath: AsyncPath) -> None:
                     logger.debug(f"Successfully loaded cog: {module}")
 
                 except Exception as e:
-                    logger.error(f"Failed to load cog {module}. Error: {e}\n{traceback.format_exc()}")
+                    logger.error(
+                        f"Failed to load cog {module}. Error: {e}\n{traceback.format_exc()}",
+                    )
 
         except Exception as e:
             logger.error(f"An error occurred while processing {apath}: {e}")

tux/cogs/admin/dev.py

@@ -15,7 +15,11 @@ async def dev(self, ctx: commands.Context[commands.Bot]) -> None:
             await ctx.send_help("dev")
 
     @commands.has_guild_permissions(administrator=True)
-    @dev.command(name="sync_tree", description="Syncs the app command tree.", usage="dev sync_tree <guild>")
+    @dev.command(
+        name="sync_tree",
+        description="Syncs the app command tree.",
+        usage="dev sync_tree <guild>",
+    )
     async def sync_tree(self, ctx: commands.Context[commands.Bot], guild: discord.Guild) -> None:
         """
         Syncs the application commands to Discord.
@@ -47,7 +51,11 @@ async def sync_tree(self, ctx: commands.Context[commands.Bot], guild: discord.Gu
         await ctx.reply("Application command tree synced.")
 
     @commands.has_guild_permissions(administrator=True)
-    @dev.command(name="clear_tree", description="Clears the app command tree.", usage="dev clear_tree")
+    @dev.command(
+        name="clear_tree",
+        description="Clears the app command tree.",
+        usage="dev clear_tree",
+    )
     async def clear_tree(self, ctx: commands.Context[commands.Bot]) -> None:
         """
         Parameters
@@ -79,7 +87,11 @@ async def clear_tree(self, ctx: commands.Context[commands.Bot]) -> None:
         await ctx.reply("Slash command tree cleared.")
 
     @commands.has_guild_permissions(administrator=True)
-    @dev.command(name="load_cog", description="Loads a cog into the bot.", usage="dev load_cog <cog>")
+    @dev.command(
+        name="load_cog",
+        description="Loads a cog into the bot.",
+        usage="dev load_cog <cog>",
+    )
     @app_commands.describe(cog="The name of the cog to load.")
     async def load_cog(self, ctx: commands.Context[commands.Bot], *, cog: str) -> None:
         """
@@ -120,7 +132,11 @@ async def load_cog(self, ctx: commands.Context[commands.Bot], *, cog: str) -> No
             logger.info(f"Cog {cog} loaded.")
 
     @commands.has_guild_permissions(administrator=True)
-    @dev.command(name="unload_cog", description="Unloads a cog from the bot.", usage="dev unload_cog <cog>")
+    @dev.command(
+        name="unload_cog",
+        description="Unloads a cog from the bot.",
+        usage="dev unload_cog <cog>",
+    )
     async def unload_cog(self, ctx: commands.Context[commands.Bot], *, cog: str) -> None:
         """
         Unloads an cog from the bot.
@@ -154,7 +170,11 @@ async def unload_cog(self, ctx: commands.Context[commands.Bot], *, cog: str) ->
             await ctx.send(f"Cog {cog} unloaded.")
 
     @commands.has_guild_permissions(administrator=True)
-    @dev.command(name="reload_cog", description="Reloads a cog into the bot.", usage="dev reload_cog <cog>")
+    @dev.command(
+        name="reload_cog",
+        description="Reloads a cog into the bot.",
+        usage="dev reload_cog <cog>",
+    )
     async def reload_cog(self, ctx: commands.Context[commands.Bot], *, cog: str) -> None:
         """
         Reloads a cog in the bot.

tux/cogs/admin/eval.py

@@ -57,7 +57,7 @@ async def run(self, ctx: commands.Context[commands.Bot], *, cmd: str) -> None:
         # Check if the user is the bot owner
         if ctx.author.id != CONST.BOT_OWNER_ID:
             logger.warning(
-                f"{ctx.author} tried to run eval but is not the bot owner. (Owner ID: {self.bot.owner_id}, User ID: {ctx.author.id})"
+                f"{ctx.author} tried to run eval but is not the bot owner. (Owner ID: {self.bot.owner_id}, User ID: {ctx.author.id})",
             )
             await ctx.send("You are not the bot owner. Better luck next time!")
             return

tux/cogs/admin/git.py

@@ -1,9 +1,7 @@
 import discord
 from discord import app_commands
 from discord.ext import commands
-from githubkit.versions.latest.models import (
-    Issue,
-)
+from githubkit.versions.latest.models import Issue
 from loguru import logger
 
 from tux.services.github import GitHubService
@@ -15,11 +13,7 @@ class LinkButton(discord.ui.View):
     def __init__(self, url: str) -> None:
         super().__init__()
         self.add_item(
-            discord.ui.Button(
-                style=discord.ButtonStyle.link,
-                label="View on Github",
-                url=url,
-            )
+            discord.ui.Button(style=discord.ButtonStyle.link, label="View on Github", url=url),
         )
 
 
@@ -88,12 +82,7 @@ async def get_repo(self, interaction: discord.Interaction) -> None:
 
     @app_commands.checks.has_any_role("Contributor", "Root", "Admin")
     @git.command(name="create_issue", description="Create an issue.")
-    async def create_issue(
-        self,
-        interaction: discord.Interaction,
-        title: str,
-        body: str,
-    ) -> None:
+    async def create_issue(self, interaction: discord.Interaction, title: str, body: str) -> None:
         """
         Create an issue.
 
@@ -168,16 +157,15 @@ async def create_issue_comment(
             logger.error(f"Error creating comment: {e}")
 
         else:
-            await interaction.followup.send(embed=embed, view=LinkButton(created_issue_comment.html_url))
+            await interaction.followup.send(
+                embed=embed,
+                view=LinkButton(created_issue_comment.html_url),
+            )
             logger.info(f"{interaction.user} created a comment.")
 
     @app_commands.checks.has_any_role("Contributor", "Root", "Admin")
     @git.command(name="close_issue", description="Close an issue.")
-    async def close_issue(
-        self,
-        interaction: discord.Interaction,
-        issue_number: int,
-    ) -> None:
+    async def close_issue(self, interaction: discord.Interaction, issue_number: int) -> None:
         """
         Close an issue.
 
@@ -211,11 +199,7 @@ async def close_issue(
 
     @app_commands.checks.has_any_role("Contributor", "Root", "Admin")
     @git.command(name="get_issue", description="Get an issue.")
-    async def get_issue(
-        self,
-        interaction: discord.Interaction,
-        issue_number: int,
-    ) -> None:
+    async def get_issue(self, interaction: discord.Interaction, issue_number: int) -> None:
         """
         Get an issue.
 
@@ -321,7 +305,9 @@ async def get_closed_issues(self, interaction: discord.Interaction) -> None:
         else:
             await interaction.followup.send(
                 embed=embed,
-                view=LinkButton("https://github.com/allthingslinux/tux/issues?q=is%3Aissue+is%3Aclosed"),
+                view=LinkButton(
+                    "https://github.com/allthingslinux/tux/issues?q=is%3Aissue+is%3Aclosed",
+                ),
             )
             logger.info(f"{interaction.user} fetched closed issues.")
 
@@ -401,11 +387,7 @@ async def get_closed_pulls(self, interaction: discord.Interaction) -> None:
 
     @app_commands.checks.has_any_role("Contributor", "Root", "Admin")
     @git.command(name="get_pull", description="Get a pull request.")
-    async def get_pull(
-        self,
-        interaction: discord.Interaction,
-        pull_number: int,
-    ) -> None:
+    async def get_pull(self, interaction: discord.Interaction, pull_number: int) -> None:
         """
         Get a pull request.
 

tux/cogs/admin/mail.py

@@ -35,10 +35,16 @@ def __init__(self, bot: commands.Bot) -> None:
 
     @mail.command(name="register", description="Registers a user for mail.")
     @app_commands.checks.has_any_role("Root", "Admin", "Mod")
-    async def register(self, interaction: discord.Interaction, member: discord.Member, username: str) -> None:
+    async def register(
+        self,
+        interaction: discord.Interaction,
+        member: discord.Member,
+        username: str,
+    ) -> None:
         if not username.isalnum():
             await interaction.response.send_message(
-                "Username must be alphanumeric and contain no spaces.", ephemeral=True
+                "Username must be alphanumeric and contain no spaces.",
+                ephemeral=True,
             )
             return
 
@@ -71,7 +77,11 @@ async def register(self, interaction: discord.Interaction, member: discord.Membe
 
             async with httpx.AsyncClient(timeout=10.0) as client:
                 try:
-                    response = await client.post(api_endpoint, headers=self.headers, json=mailbox_data)
+                    response = await client.post(
+                        api_endpoint,
+                        headers=self.headers,
+                        json=mailbox_data,
+                    )
                     if response.status_code == 200:
                         result = response.json()
                         logger.info(f"Response JSON: {result}")
@@ -93,7 +103,8 @@ async def register(self, interaction: discord.Interaction, member: discord.Membe
                                     return
 
                         await interaction.response.send_message(
-                            f"Successfully registered {mailbox_info} for mail.", ephemeral=True
+                            f"Successfully registered {mailbox_info} for mail.",
+                            ephemeral=True,
                         )
 
                         dm_message = f"""
@@ -123,7 +134,8 @@ async def register(self, interaction: discord.Interaction, member: discord.Membe
 
                     elif response.status_code == 401:
                         await interaction.response.send_message(
-                            "Unauthorized. Check your API credentials.", ephemeral=True
+                            "Unauthorized. Check your API credentials.",
+                            ephemeral=True,
                         )
                     else:
                         await interaction.response.send_message(
@@ -132,12 +144,14 @@ async def register(self, interaction: discord.Interaction, member: discord.Membe
                         )
                 except httpx.RequestError as exc:
                     await interaction.response.send_message(
-                        f"An error occurred while requesting {exc.request.url!r}.", ephemeral=True
+                        f"An error occurred while requesting {exc.request.url!r}.",
+                        ephemeral=True,
                     )
                     logger.error(f"An error occurred while requesting, {exc}")
         else:
             await interaction.response.send_message(
-                "This command can only be used in a guild (server).", ephemeral=True
+                "This command can only be used in a guild (server).",
+                ephemeral=True,
             )
 
 

tux/cogs/fun/random.py

@@ -27,7 +27,9 @@ async def coinflip(self, ctx: commands.Context[commands.Bot]) -> None:
             The context object for the command.
         """
 
-        await ctx.send(content="You got heads!" if random.choice([True, False]) else "You got tails!")
+        await ctx.send(
+            content="You got heads!" if random.choice([True, False]) else "You got tails!",
+        )
 
     @random.command(name="8ball", description="Ask the magic 8ball a question.")
     @app_commands.describe(question="The question to ask the 8ball.")
@@ -123,7 +125,12 @@ async def dice(self, ctx: commands.Context[commands.Bot], sides: int = 6) -> Non
         minimum="The minimum value of the random number. (default: 0)",
         maximum="The maximum value of the random number. (default: 100)",
     )
-    async def random_number(self, ctx: commands.Context[commands.Bot], minimum: int = 0, maximum: int = 100) -> None:
+    async def random_number(
+        self,
+        ctx: commands.Context[commands.Bot],
+        minimum: int = 0,
+        maximum: int = 100,
+    ) -> None:
         """
         Generate a random number.
 
@@ -138,7 +145,10 @@ async def random_number(self, ctx: commands.Context[commands.Bot], minimum: int
         """
 
         if minimum > maximum:
-            await ctx.reply(content="The minimum value must be less than the maximum value.", ephemeral=True)
+            await ctx.reply(
+                content="The minimum value must be less than the maximum value.",
+                ephemeral=True,
+            )
             return
 
         await ctx.reply(content=f"Your random number is: {random.randint(minimum, maximum)}")

tux/cogs/fun/xkcd.py

@@ -11,18 +11,10 @@ class XkcdLinkButtons(discord.ui.View):
     def __init__(self, explain_url: str, webpage_url: str) -> None:
         super().__init__()
         self.add_item(
-            discord.ui.Button(
-                style=discord.ButtonStyle.link,
-                label="Explainxkcd",
-                url=explain_url,
-            )
+            discord.ui.Button(style=discord.ButtonStyle.link, label="Explainxkcd", url=explain_url),
         )
         self.add_item(
-            discord.ui.Button(
-                style=discord.ButtonStyle.link,
-                label="Webpage",
-                url=webpage_url,
-            )
+            discord.ui.Button(style=discord.ButtonStyle.link, label="Webpage", url=webpage_url),
         )
 
 
@@ -61,7 +53,9 @@ async def specific(self, interaction: discord.Interaction, comic_id: int) -> Non
             await interaction.response.send_message(embed=embed, ephemeral=ephemeral)
 
     async def get_comic_and_embed(
-        self, latest: bool = False, number: int | None = None
+        self,
+        latest: bool = False,
+        number: int | None = None,
     ) -> tuple[discord.Embed, discord.ui.View | None, bool]:
         """
         Get the xkcd comic and create an embed.