refactor: tweak descriptions

Debug messages shouldn't be printed in the first place if debug isn't on.

.gitignore

@@ -1,2 +1,3 @@
 .env
+.venv
 __pycache__

Dockerfile

@@ -1,10 +1,10 @@
 FROM python:3.13-alpine
 
-RUN apk --no-cache add ffmpeg opus
+RUN apk --no-cache add ffmpeg gcc linux-headers musl-dev opus python3-dev
 
 WORKDIR /bot
 COPY . .
 
 RUN pip install -r requirements.txt
 
-CMD ["python", "-OO", "main.py"]
+CMD ["python", "main.py"]

arguments.py

@@ -8,7 +8,9 @@ import utils
 class ArgumentParser:
     def __init__(self, command, description):
         self.parser = argparse.ArgumentParser(
-            command, description=description, exit_on_error=False
+            command,
+            description=description,
+            exit_on_error=False,
         )
 
     def print_help(self):
@@ -26,21 +28,20 @@ class ArgumentParser:
     async def parse_args(self, message, tokens) -> argparse.Namespace | None:
         try:
             with contextlib.redirect_stdout(io.StringIO()):
-                args = self.parser.parse_args(tokens[1:])
-            return args
+                return self.parser.parse_args(tokens[1:])
         except SystemExit:
             await utils.reply(message, f"```\n{self.print_help()}```")
         except Exception as e:
             await utils.reply(message, f"`{e}`")
 
 
-def range_type(string, min=0, max=100):
+def range_type(string: str, lower=0, upper=100) -> int:
     try:
         value = int(string)
-    except ValueError:
-        raise argparse.ArgumentTypeError("value is not a valid integer")
+    except ValueError as e:
+        raise argparse.ArgumentTypeError("value is not a valid integer") from e
 
-    if min <= value <= max:
+    if lower <= value <= upper:
         return value
-    else:
-        raise argparse.ArgumentTypeError(f"value is not in range {min}-{max}")
+
+    raise argparse.ArgumentTypeError(f"value is not in range {lower}-{upper}")

audio/__init__.py

@@ -0,0 +1,8 @@
+from . import discord, queue, utils, youtubedl
+
+__all__ = [
+    "discord",
+    "queue",
+    "utils",
+    "youtubedl",
+]

audio/discord.py

@@ -0,0 +1,39 @@
+import audioop
+
+import disnake
+
+
+class TrackedAudioSource(disnake.AudioSource):
+    def __init__(self, source):
+        self._source = source
+        self.read_count = 0
+
+    def read(self) -> bytes:
+        data = self._source.read()
+        if data:
+            self.read_count += 1
+        return data
+
+    def fast_forward(self, seconds: int):
+        for _ in range(int(seconds / 0.02)):
+            self.read()
+
+    @property
+    def progress(self) -> float:
+        return self.read_count * 0.02
+
+
+class PCMVolumeTransformer(disnake.AudioSource):
+    def __init__(self, original: TrackedAudioSource, volume: float = 1.0) -> None:
+        if original.is_opus():
+            raise disnake.ClientException("AudioSource must not be Opus encoded")
+
+        self.original = original
+        self.volume = volume
+
+    def cleanup(self) -> None:
+        self.original.cleanup()
+
+    def read(self) -> bytes:
+        ret = self.original.read()
+        return audioop.mul(ret, 2, self.volume)

audio/queue.py

@@ -0,0 +1,112 @@
+import collections
+from dataclasses import dataclass
+from typing import ClassVar, Optional
+
+import disnake
+
+from constants import BAR_LENGTH, EMBED_COLOR
+
+from .utils import format_duration
+from .youtubedl import YTDLSource
+
+
+@dataclass
+class Song:
+    player: YTDLSource
+    trigger_message: disnake.Message
+
+    def format(self, show_queuer=False, hide_preview=False, multiline=False) -> str:
+        title = f"[`{self.player.title}`]({'<' if hide_preview else ''}{self.player.original_url}{'>' if hide_preview else ''})"
+        duration = (
+            format_duration(self.player.duration) if self.player.duration else "stream"
+        )
+        if multiline:
+            queue_time = (
+                self.trigger_message.edited_at or self.trigger_message.created_at
+            )
+            return f"{title}\n**duration:** {duration}" + (
+                f", **queued by:** <@{self.trigger_message.author.id}> <t:{round(queue_time.timestamp())}:R>"
+                if show_queuer
+                else ""
+            )
+        return f"{title} [**{duration}**]" + (
+            f" (<@{self.trigger_message.author.id}>)" if show_queuer else ""
+        )
+
+    def embed(self, is_paused=False):
+        progress = 0
+        if self.player.duration:
+            progress = self.player.original.progress / self.player.duration
+
+        embed = disnake.Embed(
+            color=EMBED_COLOR,
+            title=self.player.title,
+            url=self.player.original_url,
+            description=(
+                f"{'⏸️ ' if is_paused else ''}"
+                f"`[{'#' * int(progress * BAR_LENGTH)}{'-' * int((1 - progress) * BAR_LENGTH)}]` "
+                + (
+                    f"**{format_duration(int(self.player.original.progress))}** / **{format_duration(self.player.duration)}** (**{round(progress * 100)}%**)"
+                    if self.player.duration
+                    else "[**stream**]"
+                )
+            ),
+            timestamp=self.trigger_message.edited_at or self.trigger_message.created_at,
+        )
+
+        uploader_value = None
+        if self.player.uploader_url:
+            if self.player.uploader:
+                uploader_value = f"[{self.player.uploader}]({self.player.uploader_url})"
+            else:
+                uploader_value = self.player.uploader_url
+        elif self.player.uploader:
+            uploader_value = self.player.uploader
+
+        if uploader_value:
+            embed.add_field(name="Uploader", value=uploader_value)
+        if self.player.like_count:
+            embed.add_field(name="Likes", value=f"{self.player.like_count:,}")
+        if self.player.view_count:
+            embed.add_field(name="Views", value=f"{self.player.view_count:,}")
+        if self.player.timestamp:
+            embed.add_field(name="Published", value=f"<t:{int(self.player.timestamp)}>")
+        if self.player.volume:
+            embed.add_field(name="Volume", value=f"{int(self.player.volume * 100)}%")
+
+        if self.player.thumbnail_url:
+            embed.set_image(self.player.thumbnail_url)
+
+        embed.set_footer(
+            text=f"Queued by {self.trigger_message.author.name}",
+            icon_url=(
+                self.trigger_message.author.avatar.url
+                if self.trigger_message.author.avatar
+                else None
+            ),
+        )
+
+        return embed
+
+    def __str__(self):
+        return self.__repr__()
+
+
+@dataclass
+class Player:
+    queue: ClassVar = collections.deque()
+    current: Optional[Song] = None
+
+    def queue_pop(self):
+        popped = self.queue.popleft()
+        self.current = popped
+        return popped
+
+    def queue_push(self, item):
+        self.queue.append(item)
+
+    def queue_push_front(self, item):
+        self.queue.appendleft(item)
+
+    def __str__(self):
+        return self.__repr__()

audio/utils.py

@@ -0,0 +1,7 @@
+def format_duration(duration: int | float) -> str:
+    hours, duration = divmod(int(duration), 3600)
+    minutes, duration = divmod(duration, 60)
+    segments = [hours, minutes, duration]
+    if len(segments) == 3 and segments[0] == 0:
+        del segments[0]
+    return f"{':'.join(f'{s:0>2}' for s in segments)}"

audio/youtubedl.py

@@ -0,0 +1,76 @@
+import asyncio
+from typing import Any, Optional
+
+import disnake
+import yt_dlp
+
+from constants import YTDL_OPTIONS
+
+from .discord import PCMVolumeTransformer, TrackedAudioSource
+
+ytdl = yt_dlp.YoutubeDL(YTDL_OPTIONS)
+
+
+class YTDLSource(PCMVolumeTransformer):
+    def __init__(
+        self,
+        source: TrackedAudioSource,
+        *,
+        data: dict[str, Any],
+        volume: float = 0.5,
+    ):
+        super().__init__(source, volume)
+
+        self.description = data.get("description")
+        self.duration = data.get("duration")
+        self.id = data.get("id")
+        self.like_count = data.get("like_count")
+        self.original_url = data.get("original_url")
+        self.thumbnail_url = data.get("thumbnail")
+        self.timestamp = data.get("timestamp")
+        self.title = data.get("title")
+        self.uploader = data.get("uploader")
+        self.uploader_url = data.get("uploader_url")
+        self.view_count = data.get("view_count")
+
+    @classmethod
+    async def from_url(
+        cls,
+        url,
+        *,
+        loop: Optional[asyncio.AbstractEventLoop] = None,
+        stream: bool = False,
+    ):
+        loop = loop or asyncio.get_event_loop()
+        data: Any = await loop.run_in_executor(
+            None,
+            lambda: ytdl.extract_info(url, download=not stream),
+        )
+
+        if "entries" in data:
+            if not data["entries"]:
+                raise Exception("no results found!")
+            data = data["entries"][0]
+            if "url" not in data:
+                raise Exception("no url returned!")
+
+        return cls(
+            TrackedAudioSource(
+                disnake.FFmpegPCMAudio(
+                    data["url"] if stream else ytdl.prepare_filename(data),
+                    before_options="-vn -reconnect 1",
+                ),
+            ),
+            data=data,
+        )
+
+    def __repr__(self):
+        return f"<YTDLSource title={self.title} original_url={self.original_url} duration={self.duration}>"
+
+    def __str__(self):
+        return self.__repr__()
+
+
+def __reload_module__():
+    global ytdl
+    ytdl = yt_dlp.YoutubeDL(YTDL_OPTIONS)

commands/__init__.py

@@ -3,15 +3,11 @@ from .utils import Command, match, match_token, tokenize
 
 __all__ = [
     "bot",
-    "tools",
-    "utils",
-    "voice",
     "Command",
     "match",
     "match_token",
     "tokenize",
+    "tools",
+    "utils",
+    "voice",
 ]
-
-
-def __reload_module__():
-    globals().update({k: v for k, v in vars(utils).items() if not k.startswith("_")})

commands/bot.py

@@ -4,12 +4,13 @@ import time
 
 import disnake
 import psutil
+from yt_dlp import version
 
 import arguments
 import commands
-import utils
 from constants import EMBED_COLOR
 from state import client, start_time
+from utils import format_duration, reply, surround
 
 
 async def status(message):
@@ -24,41 +25,41 @@ async def status(message):
     embed = disnake.Embed(color=EMBED_COLOR)
     embed.add_field(
         name="Latency",
-        value=f"```{round(client.latency * 1000, 1)} ms```",
+        value=surround(f"{round(client.latency * 1000, 1)} ms"),
     )
     embed.add_field(
-        name="RSS",
-        value=f"```{round(memory_usage, 1)} MiB```",
+        name="Memory",
+        value=surround(f"{round(memory_usage, 1)} MiB"),
     )
     embed.add_field(
         name="Threads",
-        value=f"```{threading.active_count()}```",
+        value=surround(threading.active_count()),
     )
     embed.add_field(
         name="Guilds",
-        value=f"```{len(client.guilds)}```",
+        value=surround(len(client.guilds)),
     )
     embed.add_field(
         name="Members",
-        value=f"```{member_count}```",
+        value=surround(member_count),
     )
     embed.add_field(
         name="Channels",
-        value=f"```{channel_count}```",
-    )
-    embed.add_field(
-        name="Commands",
-        value=f"```{len(commands.Command.__members__)}```",
+        value=surround(channel_count),
     )
     embed.add_field(
         name="Disnake",
-        value=f"```{disnake.__version__}```",
+        value=surround(disnake.__version__),
+    )
+    embed.add_field(
+        name="yt-dlp",
+        value=surround(version.__version__),
     )
     embed.add_field(
         name="Uptime",
-        value=f"```{utils.format_duration(int(time.time() - start_time), short=True)}```",
+        value=surround(format_duration(int(time.time() - start_time), short=True)),
     )
-    await utils.reply(message, embed=embed)
+    await reply(message, embed=embed)
 
 
 async def uptime(message):
@@ -77,17 +78,26 @@ async def uptime(message):
         return
 
     if args.since:
-        await utils.reply(message, f"{round(start_time)}")
+        await reply(message, f"{round(start_time)}")
     else:
-        await utils.reply(
-            message, f"up {utils.format_duration(int(time.time() - start_time))}"
-        )
+        await reply(message, f"up {format_duration(int(time.time() - start_time))}")
+
+
+async def ping(message):
+    await reply(
+        message,
+        embed=disnake.Embed(
+            title="Pong :ping_pong:",
+            description=f"Latency: **{round(client.latency * 1000, 1)} ms**",
+            color=EMBED_COLOR,
+        ),
+    )
 
 
 async def help(message):
-    await utils.reply(
+    await reply(
         message,
         ", ".join(
-            [f"`{command.value}`" for command in commands.Command.__members__.values()]
+            [f"`{command.value}`" for command in commands.Command.__members__.values()],
         ),
     )

commands/tools.py

@@ -1,19 +1,175 @@
 import re
 
+import aiohttp
+import disnake
+
 import arguments
 import commands
 import utils
+from constants import APPLICATION_FLAGS, BADGE_EMOJIS, EMBED_COLOR, PUBLIC_FLAGS
+from state import client
+
+
+async def lookup(message):
+    tokens = commands.tokenize(message.content)
+    parser = arguments.ArgumentParser(
+        tokens[0],
+        "look up a discord user or application by ID",
+    )
+    parser.add_argument(
+        "-a",
+        "--application",
+        action="store_true",
+        help="look up applications instead of users",
+    )
+    parser.add_argument(
+        "id",
+        type=int,
+        help="the ID to perform a search for",
+    )
+    if not (args := await parser.parse_args(message, tokens)):
+        return
+
+    if args.application:
+        session = aiohttp.ClientSession()
+        response = await (
+            await session.get(f"https://discord.com/api/v9/applications/{args.id}/rpc")
+        ).json()
+        if "code" in response.keys():
+            await utils.reply(message, "application not found!")
+            return
+
+        embed = disnake.Embed(description=response["description"], color=EMBED_COLOR)
+        embed.set_thumbnail(
+            url=f"https://cdn.discordapp.com/app-icons/{response['id']}/{response['icon']}.webp",
+        )
+        embed.add_field(name="Application Name", value=response["name"])
+        embed.add_field(name="Application ID", value="`" + response["id"] + "`")
+        embed.add_field(
+            name="Public Bot",
+            value=f"{'`' + str(response['bot_public']) + '`' if 'bot_public' in response else 'No bot'}",
+        )
+        embed.add_field(name="Public Flags", value="`" + str(response["flags"]) + "`")
+        embed.add_field(
+            name="Terms of Service",
+            value=(
+                "None"
+                if "terms_of_service_url" not in response.keys()
+                else f"[Link]({response['terms_of_service_url']})"
+            ),
+        )
+        embed.add_field(
+            name="Privacy Policy",
+            value=(
+                "None"
+                if "privacy_policy_url" not in response.keys()
+                else f"[Link]({response['privacy_policy_url']})"
+            ),
+        )
+        embed.add_field(
+            name="Creation Time",
+            value=f"<t:{utils.snowflake_timestamp(int(response['id']))}:R>",
+        )
+        embed.add_field(
+            name="Default Invite URL",
+            value=(
+                "None"
+                if "install_params" not in response.keys()
+                else f"[Link](https://discord.com/oauth2/authorize?client_id={response['id']}&permissions={response['install_params']['permissions']}&scope={'%20'.join(response['install_params']['scopes'])})"
+            ),
+        )
+        embed.add_field(
+            name="Custom Invite URL",
+            value=(
+                "None"
+                if "custom_install_url" not in response.keys()
+                else f"[Link]({response['custom_install_url']})"
+            ),
+        )
+
+        bot_intents = []
+        for application_flag, intent_name in APPLICATION_FLAGS.items():
+            if response["flags"] & application_flag == application_flag:
+                if intent_name.replace(" (unverified)", "") not in bot_intents:
+                    bot_intents.append(intent_name)
+        embed.add_field(
+            name="Application Flags",
+            value=", ".join(bot_intents) if bot_intents else "None",
+        )
+
+        bot_tags = ""
+        if "tags" in response.keys():
+            for tag in response["tags"]:
+                bot_tags += tag + ", "
+        embed.add_field(
+            name="Tags",
+            value="None" if bot_tags == "" else bot_tags[:-2],
+            inline=False,
+        )
+    else:
+        try:
+            user = await client.fetch_user(args.id)
+        except Exception:
+            await utils.reply(message, "user not found!")
+            return
+
+        badges = ""
+        for flag, flag_name in PUBLIC_FLAGS.items():
+            if user.public_flags.value & flag == flag:
+                if flag_name != "None":
+                    try:
+                        badges += BADGE_EMOJIS[PUBLIC_FLAGS[flag]]
+                    except Exception as e:
+                        raise Exception(
+                            f"unable to find badge: {PUBLIC_FLAGS[flag]}"
+                        ) from e
+
+        user_object = await client.fetch_user(user.id)
+        accent_color = 0x000000
+        if user_object.accent_color is not None:
+            accent_color = user_object.accent_color
+
+        embed = disnake.Embed(color=accent_color)
+        embed.add_field(
+            name="User ID",
+            value=f"`{user.id}`",
+        )
+        embed.add_field(
+            name="Discriminator",
+            value=f"`{user.name}#{user.discriminator}`",
+        )
+        embed.add_field(
+            name="Creation Time",
+            value=f"<t:{utils.snowflake_timestamp(int(user.id))}:R>",
+        )
+        embed.add_field(
+            name="Public Flags",
+            value=f"`{user.public_flags.value}` {badges}",
+        )
+        embed.add_field(
+            name="Bot User",
+            value=f"`{user.bot}`",
+        )
+        embed.add_field(
+            name="System User",
+            value=f"`{user.system}`",
+        )
+        embed.set_thumbnail(url=user.avatar if user.avatar else user.default_avatar)
+        if user_object.banner:
+            embed.set_image(url=user_object.banner)
+
+    await utils.reply(message, embed=embed)
 
 
 async def clear(message):
     tokens = commands.tokenize(message.content)
     parser = arguments.ArgumentParser(
         tokens[0],
-        "bulk delete messages in the current channel matching certain criteria",
+        "bulk delete messages in the current channel matching specified criteria",
     )
     parser.add_argument(
         "count",
-        type=lambda c: arguments.range_type(c, min=1, max=1000),
+        type=lambda c: arguments.range_type(c, lower=1, upper=1000),
         help="amount of messages to delete",
     )
     group = parser.add_mutually_exclusive_group()
@@ -54,12 +210,25 @@ async def clear(message):
         action="store_true",
         help="delete messages with reactions",
     )
+    parser.add_argument(
+        "-A",
+        "--attachments",
+        action="store_true",
+        help="delete messages with attachments",
+    )
     parser.add_argument(
         "-d",
         "--delete-command",
         action="store_true",
         help="delete the command message as well",
     )
+    parser.add_argument(
+        "-I",
+        "--ignore-ids",
+        type=int,
+        action="append",
+        help="ignore messages with this id",
+    )
     if not (args := await parser.parse_args(message, tokens)):
         return
 
@@ -74,6 +243,8 @@ async def clear(message):
         regex = re.compile(r, re.IGNORECASE if args.case_insensitive else 0)
 
     def check(m):
+        if (ids := args.ignore_ids) and m.id in ids:
+            return False
         c = []
         if regex:
             c.append(regex.search(m.content))
@@ -86,12 +257,16 @@ async def clear(message):
             c.append(m.author.id in i)
         if args.reactions:
             c.append(len(m.reactions) > 0)
+        if args.attachments:
+            c.append(len(m.attachments) > 0)
         return all(c)
 
     messages = len(
         await message.channel.purge(
-            limit=args.count, check=check, oldest_first=args.oldest_first
-        )
+            limit=args.count,
+            check=check,
+            oldest_first=args.oldest_first,
+        ),
     )
 
     if not args.delete_command:

commands/utils.py

@@ -12,7 +12,9 @@ class Command(Enum):
     HELP = "help"
     JOIN = "join"
     LEAVE = "leave"
+    LOOKUP = "lookup"
     PAUSE = "pause"
+    PING = "ping"
     PLAY = "play"
     PLAYING = "playing"
     PURGE = "purge"
@@ -20,6 +22,7 @@ class Command(Enum):
     RELOAD = "reload"
     RESUME = "resume"
     SKIP = "skip"
+    SPONSORBLOCK = "sponsorblock"
     STATUS = "status"
     UPTIME = "uptime"
     VOLUME = "volume"
@@ -27,14 +30,19 @@ class Command(Enum):
 
 @lru_cache
 def match_token(token: str) -> list[Command]:
-    if token.lower() == "r":
-        return [Command.RELOAD]
+    match token.lower():
+        case "r":
+            return [Command.RELOAD]
+        case "s":
+            return [Command.SKIP]
+        case "c":
+            return [Command.CURRENT]
 
     if exact_match := list(
         filter(
             lambda command: command.value == token.lower(),
             Command.__members__.values(),
-        )
+        ),
     ):
         return exact_match
 
@@ -42,7 +50,7 @@ def match_token(token: str) -> list[Command]:
         filter(
             lambda command: command.value.startswith(token.lower()),
             Command.__members__.values(),
-        )
+        ),
     )
 
 
@@ -53,14 +61,17 @@ def match(command: str) -> list[Command] | None:
 
 
 @lru_cache
-def tokenize(string: str) -> list[str]:
+def tokenize(string: str, remove_prefix: bool = True) -> list[str]:
     tokens = []
     token = ""
     in_quotes = False
     quote_char = None
     escape = False
 
-    for char in string[len(constants.PREFIX) :]:
+    if remove_prefix:
+        string = string[len(constants.PREFIX) :]
+
+    for char in string:
         if escape:
             token += char
             escape = False

commands/voice/__init__.py

@@ -1,18 +1,20 @@
 from .channel import join, leave
 from .playback import fast_forward, pause, playing, resume, volume
 from .queue import queue_or_play, skip
+from .sponsorblock import sponsorblock_command
 from .utils import remove_queued
 
 __all__ = [
+    "fast_forward",
     "join",
     "leave",
-    "fast_forward",
+    "pause",
     "playing",
     "queue_or_play",
-    "skip",
-    "resume",
-    "pause",
-    "skip",
     "remove_queued",
+    "resume",
+    "skip",
+    "skip",
+    "sponsorblock_command",
     "volume",
 ]

commands/voice/channel.py

@@ -4,10 +4,15 @@ from .utils import command_allowed
 
 
 async def join(message):
-    if message.guild.voice_client:
-        return await message.guild.voice_client.move_to(message.channel)
+    if message.author.voice:
+        if message.guild.voice_client:
+            await message.guild.voice_client.move_to(message.channel)
+        else:
+            await message.author.voice.channel.connect()
+    else:
+        await utils.reply(message, "you are not connected to a voice channel!")
+        return
 
-    await message.channel.connect()
     await utils.add_check_reaction(message)
 
 

commands/voice/playback.py

@@ -2,6 +2,7 @@ import disnake_paginator
 
 import arguments
 import commands
+import sponsorblock
 import utils
 from constants import EMBED_COLOR
 from state import players
@@ -12,7 +13,8 @@ from .utils import command_allowed
 async def playing(message):
     tokens = commands.tokenize(message.content)
     parser = arguments.ArgumentParser(
-        tokens[0], "get information about the currently playing song"
+        tokens[0],
+        "get information about the currently playing song",
     )
     parser.add_argument(
         "-d",
@@ -48,7 +50,7 @@ async def playing(message):
         await utils.reply(
             message,
             embed=players[message.guild.id].current.embed(
-                is_paused=message.guild.voice_client.is_paused()
+                is_paused=message.guild.voice_client.is_paused(),
             ),
         )
     else:
@@ -88,11 +90,13 @@ async def pause(message):
 
 async def fast_forward(message):
     tokens = commands.tokenize(message.content)
-    parser = arguments.ArgumentParser(tokens[0], "fast forward audio playback")
+    parser = arguments.ArgumentParser(tokens[0], "skip the current sponsorblock segment")
     parser.add_argument(
-        "seconds",
-        type=lambda v: arguments.range_type(v, min=0, max=300),
-        help="the amount of seconds to fast forward",
+        "-s",
+        "--seconds",
+        nargs="?",
+        type=lambda v: arguments.range_type(v, lower=0, upper=300),
+        help="the number of seconds to fast forward instead",
     )
     if not (args := await parser.parse_args(message, tokens)):
         return
@@ -104,8 +108,29 @@ async def fast_forward(message):
         await utils.reply(message, "nothing is playing!")
         return
 
+    seconds = args.seconds
+    if not seconds:
+        video = await sponsorblock.get_segments(
+            players[message.guild.id].current.player.id,
+        )
+        if not video:
+            await utils.reply(
+                message,
+                "no sponsorblock segments were found for this video!",
+            )
+            return
+
+        progress = message.guild.voice_client.source.original.progress
+        for segment in video["segments"]:
+            begin, end = map(float, segment["segment"])
+            if progress >= begin and progress < end:
+                seconds = end - message.guild.voice_client.source.original.progress
+        if not seconds:
+            await utils.reply(message, "no sponsorblock segment is currently playing!")
+            return
+
     message.guild.voice_client.pause()
-    message.guild.voice_client.source.original.fast_forward(args.seconds)
+    message.guild.voice_client.source.original.fast_forward(seconds)
     message.guild.voice_client.resume()
 
     await utils.add_check_reaction(message)
@@ -117,7 +142,7 @@ async def volume(message):
     parser.add_argument(
         "volume",
         nargs="?",
-        type=lambda v: arguments.range_type(v, min=0, max=150),
+        type=lambda v: arguments.range_type(v, lower=0, upper=150),
         help="the volume level (0 - 150)",
     )
     if not (args := await parser.parse_args(message, tokens)):

commands/voice/queue.py

@@ -4,30 +4,28 @@ import disnake
 import disnake_paginator
 
 import arguments
+import audio
 import commands
 import utils
-import youtubedl
 from constants import EMBED_COLOR
-from state import client, players
+from state import client, players, trusted_users
 
 from .playback import resume
 from .utils import command_allowed, ensure_joined, play_next
 
 
 async def queue_or_play(message, edited=False):
-    if message.guild.id not in players:
-        players[message.guild.id] = youtubedl.QueuedPlayer()
-
     tokens = commands.tokenize(message.content)
     parser = arguments.ArgumentParser(
-        tokens[0], "queue a song, list the queue, or resume playback"
+        tokens[0],
+        "queue a song, list the queue, or resume playback",
     )
-    parser.add_argument("query", nargs="?", help="yt-dlp URL or query to get song")
+    parser.add_argument("query", nargs="*", help="yt-dlp URL or query to get song")
     parser.add_argument(
         "-v",
         "--volume",
         default=50,
-        type=lambda v: arguments.range_type(v, min=0, max=150),
+        type=lambda v: arguments.range_type(v, lower=0, upper=150),
         help="the volume level (0 - 150) for the specified song",
     )
     parser.add_argument(
@@ -80,19 +78,23 @@ async def queue_or_play(message, edited=False):
     elif not command_allowed(message):
         return
 
+    if message.guild.id not in players:
+        players[message.guild.id] = audio.queue.Player()
+
     if edited:
-        found = None
-        for queued in players[message.guild.id].queue:
-            if queued.trigger_message.id == message.id:
-                found = queued
-                break
+        found = next(
+            filter(
+                lambda queued: queued.trigger_message.id == message.id,
+                players[message.guild.id].queue,
+            ),
+            None,
+        )
         if found:
             players[message.guild.id].queue.remove(found)
 
     if args.clear:
         players[message.guild.id].queue.clear()
         await utils.add_check_reaction(message)
-        return
     elif indices := args.remove_index:
         targets = []
         for i in indices:
@@ -113,15 +115,15 @@ async def queue_or_play(message, edited=False):
                 f"removed **{len(targets)}** queued {'song' if len(targets) == 1 else 'songs'}",
             )
     elif args.remove_title or args.remove_queuer:
-        targets = []
+        targets = set()
         for queued in players[message.guild.id].queue:
             if t := args.remove_title:
                 if t in queued.player.title:
-                    targets.append(queued)
-                    continue
+                    targets.add(queued)
             if q := args.remove_queuer:
                 if q == queued.trigger_message.author.id:
-                    targets.append(queued)
+                    targets.add(queued)
+        targets = list(targets)
         if not args.match_multiple:
             targets = targets[:1]
 
@@ -140,11 +142,12 @@ async def queue_or_play(message, edited=False):
                         lambda queued: queued.trigger_message.author.id
                         == message.author.id,
                         players[message.guild.id].queue,
-                    )
-                )
+                    ),
+                ),
             )
             >= 5
             and not len(message.guild.voice_client.channel.members) == 2
+            and message.author.id not in trusted_users
         ):
             await utils.reply(
                 message,
@@ -154,34 +157,37 @@ async def queue_or_play(message, edited=False):
 
         try:
             async with message.channel.typing():
-                player = await youtubedl.YTDLSource.from_url(
-                    query, loop=client.loop, stream=True
+                player = await audio.youtubedl.YTDLSource.from_url(
+                    " ".join(query),
+                    loop=client.loop,
+                    stream=True,
                 )
                 player.volume = float(args.volume) / 100.0
         except Exception as e:
-            await utils.reply(
-                message, f"**failed to queue:** `{e}`", suppress_embeds=True
-            )
+            await utils.reply(message, f"failed to queue: `{e}`")
             return
 
-        queued = youtubedl.QueuedSong(player, message)
+        queued = audio.queue.Song(player, message)
 
         if args.now or args.next:
-            players[message.guild.id].queue_add_front(queued)
+            players[message.guild.id].queue_push_front(queued)
         else:
-            players[message.guild.id].queue_add(queued)
+            players[message.guild.id].queue_push(queued)
 
-        if not message.guild.voice_client.source:
+        if not message.guild.voice_client:
+            await utils.reply(message, "unexpected disconnect from voice channel!")
+            return
+        elif not message.guild.voice_client.source:
             play_next(message, first=True)
         elif args.now:
             message.guild.voice_client.stop()
         else:
             await utils.reply(
                 message,
-                f"**{len(players[message.guild.id].queue)}.** {queued.format()}",
+                f"**{1 if args.next else len(players[message.guild.id].queue)}.** {queued.format()}",
             )
 
-        utils.cooldown(message, 3)
+        utils.cooldown(message, 2)
     elif tokens[0].lower() == "play":
         await resume(message)
     else:
@@ -191,7 +197,7 @@ async def queue_or_play(message, edited=False):
                     [
                         queued.player.duration if queued.player.duration else 0
                         for queued in players[message.guild.id].queue
-                    ]
+                    ],
                 ),
                 natural=True,
             )
@@ -216,13 +222,14 @@ async def queue_or_play(message, edited=False):
                                 [
                                     f"**{i + 1}.** {queued.format(show_queuer=True, hide_preview=True, multiline=True)}"
                                     for i, queued in batch
-                                ]
+                                ],
                             )
                             for batch in itertools.batched(
-                                enumerate(players[message.guild.id].queue), 10
+                                enumerate(players[message.guild.id].queue),
+                                10,
                             )
                         ],
-                    )
+                    ),
                 ),
             ).start(utils.MessageInteractionWrapper(message))
         else:
@@ -234,7 +241,7 @@ async def queue_or_play(message, edited=False):
 
 async def skip(message):
     tokens = commands.tokenize(message.content)
-    parser = arguments.ArgumentParser(tokens[0], "skip the currently playing song")
+    parser = arguments.ArgumentParser(tokens[0], "skip the song currently playing")
     parser.add_argument(
         "-n",
         "--next",

commands/voice/sponsorblock.py

@@ -0,0 +1,47 @@
+import disnake
+
+import audio
+import sponsorblock
+import utils
+from constants import EMBED_COLOR, SPONSORBLOCK_CATEGORY_NAMES
+from state import players
+
+from .utils import command_allowed
+
+
+async def sponsorblock_command(message):
+    if not command_allowed(message, immutable=True):
+        return
+
+    if not message.guild.voice_client.source:
+        await utils.reply(message, "nothing is playing!")
+        return
+
+    progress = message.guild.voice_client.source.original.progress
+    video = await sponsorblock.get_segments(players[message.guild.id].current.player.id)
+    if not video:
+        await utils.reply(
+            message,
+            "no sponsorblock segments were found for this video!",
+        )
+        return
+
+    text = []
+    for segment in video["segments"]:
+        begin, end = map(int, segment["segment"])
+        if (category := segment["category"]) in SPONSORBLOCK_CATEGORY_NAMES:
+            category = SPONSORBLOCK_CATEGORY_NAMES[category]
+
+        current = "**" if progress >= begin and progress < end else ""
+        text.append(
+            f"{current}`{audio.utils.format_duration(begin)}` - `{audio.utils.format_duration(end)}`: {category}{current}",
+        )
+
+    await utils.reply(
+        message,
+        embed=disnake.Embed(
+            title="Sponsorblock segments",
+            description="\n".join(text),
+            color=EMBED_COLOR,
+        ),
+    )

commands/voice/utils.py

@@ -16,19 +16,17 @@ def play_after_callback(e, message, once):
 def play_next(message, once=False, first=False):
     if not message.guild.voice_client:
         return
-
     message.guild.voice_client.stop()
+
+    if not disnake.opus.is_loaded():
+        utils.load_opus()
+
     if message.guild.id in players and players[message.guild.id].queue:
         queued = players[message.guild.id].queue_pop()
-        try:
-            message.guild.voice_client.play(
-                queued.player, after=lambda e: play_after_callback(e, message, once)
-            )
-        except disnake.opus.OpusNotLoaded:
-            utils.load_opus()
-            message.guild.voice_client.play(
-                queued.player, after=lambda e: play_after_callback(e, message, once)
-            )
+        message.guild.voice_client.play(
+            queued.player,
+            after=lambda e: play_after_callback(e, message, once),
+        )
 
         embed = queued.embed()
         if first and len(players[message.guild.id].queue) == 0:
@@ -63,10 +61,12 @@ async def ensure_joined(message):
 
 def command_allowed(message, immutable=False):
     if not message.guild.voice_client:
-        return
+        return False
+
     if immutable:
-        return message.channel.id == message.guild.voice_client.channel.id
-    else:
-        if not message.author.voice:
-            return False
-        return message.author.voice.channel.id == message.guild.voice_client.channel.id
+        return True
+
+    if not message.author.voice:
+        return False
+
+    return message.author.voice.channel.id == message.guild.voice_client.channel.id

constants.py

@@ -19,8 +19,24 @@ BAR_LENGTH = 35
 EMBED_COLOR = 0xFF6600
 OWNERS = [531392146767347712]
 PREFIX = "%"
+SPONSORBLOCK_CATEGORY_NAMES = {
+    "music_offtopic": "non-music",
+    "selfpromo": "self promotion",
+    "sponsor": "sponsored",
+}
+REACTIONS = {
+    "cat": ["🐈"],
+    "dog": ["🐕"],
+    "gn": ["💤", "😪", "😴", "🛌"],
+    "pizza": ["🍕"],
+}
 RELOADABLE_MODULES = [
     "arguments",
+    "audio",
+    "audio.discord",
+    "audio.queue",
+    "audio.utils",
+    "audio.youtubedl",
     "commands",
     "commands.bot",
     "commands.tools",
@@ -30,16 +46,66 @@ RELOADABLE_MODULES = [
     "commands.voice.playback",
     "commands.voice.playing",
     "commands.voice.queue",
+    "commands.voice.sponsorblock",
     "commands.voice.utils",
     "constants",
     "core",
     "events",
     "extra",
+    "fun",
+    "sponsorblock",
     "tasks",
     "utils",
+    "utils.common",
+    "utils.discord",
     "voice",
-    "youtubedl",
+    "yt_dlp",
+    "yt_dlp.version",
 ]
+PUBLIC_FLAGS = {
+    1 << 0: "Discord Employee",
+    1 << 1: "Discord Partner",
+    1 << 2: "HypeSquad Events",
+    1 << 3: "Bug Hunter Level 1",
+    1 << 6: "HypeSquad Bravery",
+    1 << 7: "HypeSquad Brilliance",
+    1 << 8: "HypeSquad Balance",
+    1 << 9: "Early Supporter",
+    1 << 10: "Team User",
+    1 << 14: "Bug Hunter Level 2",
+    1 << 16: "Verified Bot",
+    1 << 17: "Verified Bot Developer",
+    1 << 18: "Discord Certified Moderator",
+    1 << 19: "HTTP Interactions Only",
+    1 << 22: "Active Developer",
+}
+BADGE_EMOJIS = {
+    "Discord Employee": "<:DiscordStaff:879666899980546068>",
+    "Discord Partner": "<:DiscordPartner:879668340434534400>",
+    "HypeSquad Events": "<:HypeSquadEvents:879666970310606848>",
+    "Bug Hunter Level 1": "<:BugHunter1:879666851448234014>",
+    "HypeSquad Bravery": "<:HypeSquadBravery:879666945153175612>",
+    "HypeSquad Brilliance": "<:HypeSquadBrilliance:879666956884643861>",
+    "HypeSquad Balance": "<:HypeSquadBalance:879666934717771786>",
+    "Early Supporter": "<:EarlySupporter:879666916493496400>",
+    "Team User": "<:TeamUser:890866907996127305>",
+    "Bug Hunter Level 2": "<:BugHunter2:879666866971357224>",
+    "Verified Bot": "<:VerifiedBot:879670687554498591>",
+    "Verified Bot Developer": "<:VerifiedBotDeveloper:879669786550890507>",
+    "Discord Certified Moderator": "<:DiscordModerator:879666882976837654>",
+    "HTTP Interactions Only": "<:HTTPInteractionsOnly:1047141867806015559>",
+    "Active Developer": "<:ActiveDeveloper:1047141451244523592>",
+}
+APPLICATION_FLAGS = {
+    1 << 12: "Presence Intent",
+    1 << 13: "Presence Intent (unverified)",
+    1 << 14: "Guild Members Intent",
+    1 << 15: "Guild Members Intent (unverified)",
+    1 << 16: "Unusual Growth (verification suspended)",
+    1 << 18: "Message Content Intent",
+    1 << 19: "Message Content Intent (unverified)",
+    1 << 23: "Suports Application Commands",
+}
 
 SECRETS = {
     "TOKEN": os.getenv("BOT_TOKEN"),

core.py

@@ -3,6 +3,7 @@ import contextlib
 import importlib
 import inspect
 import io
+import signal
 import textwrap
 import time
 import traceback
@@ -47,63 +48,49 @@ async def on_message(message, edited=False):
     await command_locks[(message.guild.id, message.author.id)].acquire()
 
     try:
-        if cooldowns := command_cooldowns.get(message.author.id):
-            if (end_time := cooldowns.get(matched)) and int(time.time()) < int(
-                end_time
+        if (cooldowns := command_cooldowns.get(message.author.id)) and not edited:
+            if (end_time := cooldowns.get(matched)) and (
+                remaining_time := round(end_time - time.time()) > 0
             ):
                 await utils.reply(
                     message,
-                    f"please wait **{utils.format_duration(int(end_time - time.time()), natural=True)}** before using this command again!",
+                    f"please wait **{utils.format_duration(remaining_time, natural=True)}** before using this command again!",
                 )
                 return
 
         match matched:
             case C.RELOAD if message.author.id in OWNERS:
-                reloaded_modules = set()
                 start = time.time()
-
-                rreload(reloaded_modules, __import__("core"))
-                rreload(reloaded_modules, __import__("extra"))
-                for module in filter(
-                    lambda v: inspect.ismodule(v) and v.__name__ in RELOADABLE_MODULES,
-                    globals().values(),
-                ):
-                    rreload(reloaded_modules, module)
-
+                reloaded_modules = reload()
                 end = time.time()
-                if __debug__:
-                    debug(
-                        f"reloaded {len(reloaded_modules)} modules in {round(end-start, 2)}s"
-                    )
+                debug(
+                    f"reloaded {len(reloaded_modules)} modules in {round(end - start, 2)}s",
+                )
 
                 await utils.add_check_reaction(message)
+
             case C.EXECUTE if message.author.id in OWNERS:
                 code = message.content[len(tokens[0]) + 1 :].strip().strip("`")
                 for replacement in ["python", "py"]:
                     if code.startswith(replacement):
                         code = code[len(replacement) :]
 
-                stdout = io.StringIO()
                 try:
+                    stdout = io.StringIO()
                     with contextlib.redirect_stdout(stdout):
-                        if "#globals" in code:
-                            exec(
-                                f"async def run_code():\n{textwrap.indent(code, '   ')}",
-                                globals(),
-                            )
+                        wrapped_code = (
+                            f"async def run_code():\n{textwrap.indent(code, '   ')}"
+                        )
+                        if "# globals" in code:
+                            exec(wrapped_code, globals())
                             await globals()["run_code"]()
                         else:
                             dictionary = dict(locals(), **globals())
-                            exec(
-                                f"async def run_code():\n{textwrap.indent(code, '   ')}",
-                                dictionary,
-                                dictionary,
-                            )
+                            exec(wrapped_code, dictionary, dictionary)
                             await dictionary["run_code"]()
                         output = stdout.getvalue()
                 except Exception as e:
                     output = "`" + str(e) + "`"
-
                 output = utils.filter_secrets(output)
 
                 if len(output) > 2000:
@@ -119,6 +106,7 @@ async def on_message(message, edited=False):
                     await utils.add_check_reaction(message)
                 else:
                     await utils.reply(message, output)
+
             case C.CLEAR | C.PURGE if message.author.id in OWNERS:
                 await commands.tools.clear(message)
             case C.JOIN:
@@ -145,10 +133,16 @@ async def on_message(message, edited=False):
                 await commands.voice.fast_forward(message)
             case C.STATUS:
                 await commands.bot.status(message)
+            case C.PING:
+                await commands.bot.ping(message)
+            case C.LOOKUP:
+                await commands.tools.lookup(message)
+            case C.SPONSORBLOCK:
+                await commands.voice.sponsorblock_command(message)
     except Exception as e:
         await utils.reply(
             message,
-            f"exception occurred while processing command: ```\n{"".join(traceback.format_exception(e)).replace("`", "\\`")}```",
+            f"exception occurred while processing command: ```\n{''.join(traceback.format_exception(e)).replace('`', '\\`')}```",
         )
         raise e
     finally:
@@ -164,6 +158,7 @@ async def on_voice_state_update(_, before, after):
         channel = before.channel
     elif is_empty(after.channel):
         channel = after.channel
+
     if channel:
         await channel.guild.voice_client.disconnect()
 
@@ -172,9 +167,9 @@ def rreload(reloaded_modules, module):
     reloaded_modules.add(module.__name__)
 
     for submodule in filter(
-        lambda v: inspect.ismodule(v)
-        and v.__name__ in RELOADABLE_MODULES
-        and v.__name__ not in reloaded_modules,
+        lambda sm: inspect.ismodule(sm)
+        and sm.__name__ in RELOADABLE_MODULES
+        and sm.__name__ not in reloaded_modules,
         vars(module).values(),
     ):
         rreload(reloaded_modules, submodule)
@@ -183,3 +178,18 @@ def rreload(reloaded_modules, module):
 
     if "__reload_module__" in dir(module):
         module.__reload_module__()
+
+
+def reload(*_):
+    reloaded_modules = set()
+    rreload(reloaded_modules, __import__("core"))
+    rreload(reloaded_modules, __import__("extra"))
+    for module in filter(
+        lambda v: inspect.ismodule(v) and v.__name__ in RELOADABLE_MODULES,
+        globals().values(),
+    ):
+        rreload(reloaded_modules, module)
+    return reloaded_modules
+
+
+signal.signal(signal.SIGUSR1, reload)

events.py

@@ -1,12 +1,12 @@
 import asyncio
 import threading
-import time
-from logging import info
+from logging import debug, info, warning
 
 import commands
 import core
+import fun
 import tasks
-from state import client, start_time
+from state import client
 
 
 def prepare():
@@ -26,6 +26,7 @@ async def on_bulk_message_delete(messages):
 
 async def on_message(message):
     await core.on_message(message)
+    await fun.on_message(message)
 
 
 async def on_message_delete(message):
@@ -39,19 +40,29 @@ async def on_message_edit(before, after):
     await core.on_message(after, edited=True)
 
 
-async def on_ready():
-    info(f"logged in as {client.user} in {round(time.time() - start_time, 1)}s")
-
-
 async def on_voice_state_update(member, before, after):
     await core.on_voice_state_update(member, before, after)
 
 
+async def on_ready():
+    info(f"logged in as {client.user}")
+
+
+async def on_connect():
+    debug("connected to the gateway!")
+
+
+async def on_disconnect():
+    warning("disconnected from the gateway!")
+
+
 for event_type, handlers in client.get_listeners().items():
     for handler in handlers:
         client.remove_listener(handler, event_type)
 
 client.add_listener(on_bulk_message_delete, "on_bulk_message_delete")
+client.add_listener(on_connect, "on_connect")
+client.add_listener(on_disconnect, "on_disconnect")
 client.add_listener(on_message, "on_message")
 client.add_listener(on_message_delete, "on_message_delete")
 client.add_listener(on_message_edit, "on_message_edit")

extra.py

@@ -8,11 +8,15 @@ from state import client, kill, players
 
 
 async def transcript(
-    message, languages=["en"], max_messages=6, min_messages=3, upper=True
+    message,
+    languages=["en"],
+    max_messages=6,
+    min_messages=3,
+    upper=True,
 ):
     initial_id = message.guild.voice_client.source.id
     transcript_list = youtube_transcript_api.YouTubeTranscriptApi.list_transcripts(
-        initial_id
+        initial_id,
     )
     try:
         transcript = transcript_list.find_manually_created_transcript(languages).fetch()
@@ -39,17 +43,18 @@ async def transcript(
         )
         if len(messages) > max_messages:
             try:
-                count = max_messages - min_messages
+                count = min(min_messages, len(messages))
                 if count == 1:
                     await messages.pop().delete()
                 else:
                     await message.channel.delete_messages(
-                        [messages.pop() for _ in range(count)]
+                        [messages.pop() for _ in range(count)],
                     )
             except Exception:
                 pass
 
         if (message.guild.voice_client.source.id != initial_id) or kill["transcript"]:
+            kill["transcript"] = False
             break
 
 
@@ -76,19 +81,20 @@ def messages_per_second(limit=500):
         average = 1
     print(
         f"I am receiving **{average} {'message' if average == 1 else 'messages'} per second** "
-        f"from **{len(members)} {'member' if len(members) == 1 else 'members'}** across **{len(guilds)} {'guild' if len(guilds) == 1 else 'guilds'}**"
+        f"from **{len(members)} {'member' if len(members) == 1 else 'members'}** across **{len(guilds)} {'guild' if len(guilds) == 1 else 'guilds'}**",
     )
 
 
-async def auto_count(channel_id):
+async def auto_count(channel_id: int):
     if (channel := await client.fetch_channel(channel_id)) and isinstance(
-        channel, disnake.TextChannel
+        channel,
+        disnake.TextChannel,
     ):
         last_message = (await channel.history(limit=1).flatten())[0]
         try:
             result = str(
                 int("".join(filter(lambda d: d in string.digits, last_message.content)))
-                + 1
+                + 1,
             )
         except Exception:
             result = "where number"

fun.py

@@ -0,0 +1,13 @@
+import random
+
+import commands
+from constants import REACTIONS
+
+
+async def on_message(message):
+    if random.random() < 0.01:
+        tokens = commands.tokenize(message.content, remove_prefix=False)
+        for keyword, options in REACTIONS.items():
+            if keyword in tokens:
+                await message.add_reaction(random.choice(options))
+                break

main.py

@@ -7,12 +7,14 @@ from state import client
 if __name__ == "__main__":
     logging.basicConfig(
         format=(
-            "%(asctime)s %(levelname)s %(name):%(module)s %(message)s"
+            "%(asctime)s %(levelname)s %(name)s:%(module)s %(message)s"
             if __debug__
             else "%(asctime)s %(levelname)s %(message)s"
         ),
         datefmt="%Y-%m-%d %T",
         level=logging.DEBUG if __debug__ else logging.INFO,
     )
+    logging.getLogger("disnake").setLevel(logging.WARNING)
+
     events.prepare()
     client.run(constants.SECRETS["TOKEN"])

requirements.txt

@@ -1,6 +1,8 @@
+aiohttp
 audioop-lts
 disnake
 disnake_paginator
+psutil
 PyNaCl
 youtube_transcript_api
-yt-dlp
+yt-dlp[default] @ https://github.com/yt-dlp/yt-dlp/archive/master.tar.gz

sponsorblock.py

@@ -0,0 +1,37 @@
+import hashlib
+import json
+
+import aiohttp
+
+from state import sponsorblock_cache
+
+categories = json.dumps(
+    [
+        "interaction",
+        "intro",
+        "music_offtopic",
+        "outro",
+        "preview",
+        "selfpromo",
+        "sponsor",
+    ],
+)
+
+
+async def get_segments(video_id: str):
+    if video_id in sponsorblock_cache:
+        return sponsorblock_cache[video_id]
+
+    hash_prefix = hashlib.sha256(video_id.encode()).hexdigest()[:4]
+    session = aiohttp.ClientSession()
+    response = await session.get(
+        f"https://sponsor.ajay.app/api/skipSegments/{hash_prefix}",
+        params={"categories": categories},
+    )
+    if response.status == 200 and (
+        results := list(
+            filter(lambda v: video_id == v["videoID"], await response.json()),
+        )
+    ):
+        sponsorblock_cache[video_id] = results[0]
+        return results[0]

state.py

@@ -1,24 +1,8 @@
 import time
-from collections import OrderedDict
 
 import disnake
 
-
-class LimitedSizeDict(OrderedDict):
-    def __init__(self, *args, **kwargs):
-        self.size_limit = kwargs.pop("size_limit", 1000)
-        super().__init__(*args, **kwargs)
-        self._check_size_limit()
-
-    def __setitem__(self, key, value):
-        super().__setitem__(key, value)
-        self._check_size_limit()
-
-    def _check_size_limit(self):
-        if self.size_limit is not None:
-            while len(self) > self.size_limit:
-                self.popitem(last=False)
-
+from utils import LimitedSizeDict
 
 intents = disnake.Intents.default()
 intents.message_content = True
@@ -31,4 +15,6 @@ idle_tracker = {"is_idle": False, "last_used": time.time()}
 kill = {"transcript": False}
 message_responses = LimitedSizeDict()
 players = {}
+sponsorblock_cache = LimitedSizeDict()
 start_time = time.time()
+trusted_users = []

tasks.py

@@ -11,7 +11,7 @@ async def cleanup():
     debug("spawned cleanup thread")
 
     while True:
-        await asyncio.sleep(3600 * 12)
+        await asyncio.sleep(3600)
 
         targets = []
         for guild_id, player in players.items():
@@ -19,8 +19,7 @@ async def cleanup():
                 targets.append(guild_id)
         for target in targets:
             del players[target]
-        if __debug__:
-            debug(f"cleanup removed {len(targets)} empty players")
+        debug(f"cleanup thread removed {len(targets)} empty players")
 
         if (
             not idle_tracker["is_idle"]

tests/__init__.py

@@ -1,3 +1,3 @@
-from . import test_format_duration
+from . import test_filter_secrets, test_format_duration
 
-__all__ = ["test_format_duration"]
+__all__ = ["test_filter_secrets", "test_format_duration"]

tests/test_filter_secrets.py

@@ -0,0 +1,21 @@
+import unittest
+
+import utils
+
+
+class TestFilterSecrets(unittest.TestCase):
+    def test_filter_secrets(self):
+        secret = "PLACEHOLDER_TOKEN"
+        self.assertFalse(
+            secret in utils.filter_secrets(f"HELLO{secret}WORLD", {"TOKEN": secret}),
+        )
+        self.assertFalse(secret in utils.filter_secrets(secret, {"TOKEN": secret}))
+        self.assertFalse(
+            secret in utils.filter_secrets(f"123{secret}", {"TOKEN": secret}),
+        )
+        self.assertFalse(
+            secret in utils.filter_secrets(f"{secret}{secret}", {"TOKEN": secret}),
+        )
+        self.assertFalse(
+            secret in utils.filter_secrets(f"{secret}@#(*&*$)", {"TOKEN": secret}),
+        )

tests/test_format_duration.py

@@ -1,13 +1,13 @@
 import unittest
 
+import audio
 import utils
-import youtubedl
 
 
 class TestFormatDuration(unittest.TestCase):
-    def test_youtubedl(self):
+    def test_audio(self):
         def f(s):
-            return youtubedl.format_duration(s)
+            return audio.utils.format_duration(s)
 
         self.assertEqual(f(0), "00:00")
         self.assertEqual(f(0.5), "00:00")

utils.py

@@ -1,133 +0,0 @@
-import os
-import time
-from logging import error, info, warning
-
-import disnake
-
-import commands
-import constants
-from state import command_cooldowns, message_responses
-
-
-class ChannelResponseWrapper:
-    def __init__(self, message):
-        self.message = message
-        self.sent_message = None
-
-    async def send_message(self, **kwargs):
-        if "ephemeral" in kwargs:
-            del kwargs["ephemeral"]
-        self.sent_message = await reply(self.message, **kwargs)
-
-    async def edit_message(self, content=None, embed=None, view=None):
-        if self.sent_message:
-            content = content or self.sent_message.content
-            if not embed and len(self.sent_message.embeds) > 0:
-                embed = self.sent_message.embeds[0]
-            await self.sent_message.edit(content=content, embed=embed, view=view)
-
-
-class MessageInteractionWrapper:
-    def __init__(self, message):
-        self.message = message
-        self.author = message.author
-        self.response = ChannelResponseWrapper(message)
-
-    async def edit_original_message(self, content=None, embed=None, view=None):
-        await self.response.edit_message(content=content, embed=embed, view=view)
-
-
-def cooldown(message, cooldown_time: int):
-    possible_commands = commands.match(message.content)
-    if not possible_commands or len(possible_commands) > 1:
-        return
-    command = possible_commands[0]
-
-    end_time = time.time() + cooldown_time
-    if message.author.id in command_cooldowns:
-        command_cooldowns[message.author.id][command] = end_time
-    else:
-        command_cooldowns[message.author.id] = {command: end_time}
-
-
-def format_duration(duration: int, natural: bool = False, short: bool = False):
-    def format_plural(noun, count):
-        if short:
-            return noun[0]
-        return " " + (noun if count == 1 else noun + "s")
-
-    segments = []
-
-    weeks, duration = divmod(duration, 604800)
-    if weeks > 0:
-        segments.append(f"{weeks}{format_plural('week', weeks)}")
-
-    days, duration = divmod(duration, 86400)
-    if days > 0:
-        segments.append(f"{days}{format_plural('day', days)}")
-
-    hours, duration = divmod(duration, 3600)
-    if hours > 0:
-        segments.append(f"{hours}{format_plural('hour', hours)}")
-
-    minutes, duration = divmod(duration, 60)
-    if minutes > 0:
-        segments.append(f"{minutes}{format_plural('minute', minutes)}")
-
-    if duration > 0:
-        segments.append(f"{duration}{format_plural('second', duration)}")
-
-    separator = " " if short else ", "
-    if not natural or len(segments) <= 1:
-        return separator.join(segments)
-    return separator.join(segments[:-1]) + f" and {segments[-1]}"
-
-
-async def add_check_reaction(message):
-    await message.add_reaction("✅")
-
-
-async def reply(message, *args, **kwargs):
-    if message.id in message_responses:
-        await message_responses[message.id].edit(
-            *args, **kwargs, allowed_mentions=disnake.AllowedMentions.none()
-        )
-    else:
-        response = await message.reply(
-            *args, **kwargs, allowed_mentions=disnake.AllowedMentions.none()
-        )
-        message_responses[message.id] = response
-    return message_responses[message.id]
-
-
-async def channel_send(message, *args, **kwargs):
-    await message.channel.send(
-        *args, **kwargs, allowed_mentions=disnake.AllowedMentions.none()
-    )
-
-
-async def invalid_user_handler(interaction):
-    await interaction.response.send_message(
-        "you are not the intended receiver of this message!", ephemeral=True
-    )
-
-
-def filter_secrets(text: str) -> str:
-    for secret_name, secret in constants.SECRETS.items():
-        if not secret:
-            continue
-        text = text.replace(secret, f"<{secret_name}>")
-    return text
-
-
-def load_opus():
-    warning("opus wasn't automatically loaded! trying to load manually...")
-    for path in ["/usr/lib64/libopus.so.0", "/usr/lib/libopus.so.0"]:
-        if os.path.exists(path):
-            try:
-                disnake.opus.load_opus(path)
-                info(f"successfully loaded opus from {path}")
-                return
-            except Exception as e:
-                error(f"failed to load opus from {path}: {e}")
-    raise Exception("could not locate working opus library")

utils/__init__.py

@@ -0,0 +1,28 @@
+from .common import LimitedSizeDict, filter_secrets, format_duration, surround
+from .discord import (
+    ChannelResponseWrapper,
+    MessageInteractionWrapper,
+    add_check_reaction,
+    channel_send,
+    cooldown,
+    invalid_user_handler,
+    load_opus,
+    reply,
+    snowflake_timestamp,
+)
+
+__all__ = [
+    "add_check_reaction",
+    "channel_send",
+    "ChannelResponseWrapper",
+    "cooldown",
+    "filter_secrets",
+    "format_duration",
+    "invalid_user_handler",
+    "LimitedSizeDict",
+    "load_opus",
+    "MessageInteractionWrapper",
+    "reply",
+    "snowflake_timestamp",
+    "surround",
+]

utils/common.py

@@ -0,0 +1,64 @@
+from collections import OrderedDict
+
+from constants import SECRETS
+
+
+def surround(inner: str, outer="```") -> str:
+    return outer + str(inner) + outer
+
+
+def format_duration(duration: int, natural: bool = False, short: bool = False) -> str:
+    def format_plural(noun, count):
+        if short:
+            return noun[0]
+        return " " + (noun if count == 1 else noun + "s")
+
+    segments = []
+
+    weeks, duration = divmod(duration, 604800)
+    if weeks > 0:
+        segments.append(f"{weeks}{format_plural('week', weeks)}")
+
+    days, duration = divmod(duration, 86400)
+    if days > 0:
+        segments.append(f"{days}{format_plural('day', days)}")
+
+    hours, duration = divmod(duration, 3600)
+    if hours > 0:
+        segments.append(f"{hours}{format_plural('hour', hours)}")
+
+    minutes, duration = divmod(duration, 60)
+    if minutes > 0:
+        segments.append(f"{minutes}{format_plural('minute', minutes)}")
+
+    if duration > 0:
+        segments.append(f"{duration}{format_plural('second', duration)}")
+
+    separator = " " if short else ", "
+    if not natural or len(segments) <= 1:
+        return separator.join(segments)
+    return separator.join(segments[:-1]) + f" and {segments[-1]}"
+
+
+def filter_secrets(text: str, secrets=SECRETS) -> str:
+    for secret_name, secret in secrets.items():
+        if not secret:
+            continue
+        text = text.replace(secret, f"<{secret_name}>")
+    return text
+
+
+class LimitedSizeDict(OrderedDict):
+    def __init__(self, *args, **kwargs):
+        self.size_limit = kwargs.pop("size_limit", 100)
+        super().__init__(*args, **kwargs)
+        self._check_size_limit()
+
+    def __setitem__(self, key, value):
+        super().__setitem__(key, value)
+        self._check_size_limit()
+
+    def _check_size_limit(self):
+        if self.size_limit is not None:
+            while len(self) > self.size_limit:
+                self.popitem(last=False)

utils/discord.py

@@ -0,0 +1,118 @@
+import time
+from logging import error, info
+from pathlib import Path
+
+import disnake
+
+import commands
+from constants import OWNERS
+from state import command_cooldowns, message_responses
+
+
+def cooldown(message, cooldown_time: int):
+    if message.author.id in OWNERS:
+        return
+
+    possible_commands = commands.match(message.content)
+    if not possible_commands or len(possible_commands) > 1:
+        return
+    command = possible_commands[0]
+
+    end_time = time.time() + cooldown_time
+    if message.author.id in command_cooldowns:
+        command_cooldowns[message.author.id][command] = end_time
+    else:
+        command_cooldowns[message.author.id] = {command: end_time}
+
+
+async def reply(message, *args, **kwargs):
+    if message.id in message_responses:
+        if len(args) == 0:
+            kwargs["content"] = None
+        elif len(kwargs) == 0:
+            kwargs["embeds"] = []
+
+        try:
+            await message_responses[message.id].edit(
+                *args,
+                **kwargs,
+                allowed_mentions=disnake.AllowedMentions.none(),
+            )
+            return
+        except Exception:
+            pass
+
+    try:
+        response = await message.reply(
+            *args,
+            **kwargs,
+            allowed_mentions=disnake.AllowedMentions.none(),
+        )
+    except Exception:
+        response = await channel_send(message, *args, **kwargs)
+    message_responses[message.id] = response
+    return message_responses[message.id]
+
+
+async def channel_send(message, *args, **kwargs):
+    await message.channel.send(
+        *args,
+        **kwargs,
+        allowed_mentions=disnake.AllowedMentions.none(),
+    )
+
+
+def load_opus():
+    for path in filter(
+        lambda p: Path(p).exists(),
+        ["/usr/lib64/libopus.so.0", "/usr/lib/libopus.so.0"],
+    ):
+        try:
+            disnake.opus.load_opus(path)
+            info(f"successfully loaded opus from {path}")
+            return
+        except Exception as e:
+            error(f"failed to load opus from {path}: {e}")
+    raise Exception("could not locate working opus library")
+
+
+def snowflake_timestamp(snowflake) -> int:
+    return round(((snowflake >> 22) + 1420070400000) / 1000)
+
+
+async def add_check_reaction(message):
+    await message.add_reaction("✅")
+
+
+async def invalid_user_handler(interaction):
+    await interaction.response.send_message(
+        "you are not the intended receiver of this message!",
+        ephemeral=True,
+    )
+
+
+class ChannelResponseWrapper:
+    def __init__(self, message):
+        self.message = message
+        self.sent_message = None
+
+    async def send_message(self, **kwargs):
+        kwargs.pop("ephemeral", None)
+        self.sent_message = await reply(self.message, **kwargs)
+
+    async def edit_message(self, content=None, embed=None, view=None):
+        if self.sent_message:
+            content = content or self.sent_message.content
+            if not embed and len(self.sent_message.embeds) > 0:
+                embed = self.sent_message.embeds[0]
+            await self.sent_message.edit(content=content, embed=embed, view=view)
+
+
+class MessageInteractionWrapper:
+    def __init__(self, message):
+        self.message = message
+        self.author = message.author
+        self.response = ChannelResponseWrapper(message)
+
+    async def edit_original_message(self, content=None, embed=None, view=None):
+        await self.response.edit_message(content=content, embed=embed, view=view)

youtubedl.py

@@ -1,182 +0,0 @@
-import asyncio
-import collections
-from dataclasses import dataclass
-from typing import Any, Optional
-
-import disnake
-import yt_dlp
-
-from constants import BAR_LENGTH, EMBED_COLOR, YTDL_OPTIONS
-
-ytdl = yt_dlp.YoutubeDL(YTDL_OPTIONS)
-
-
-class CustomAudioSource(disnake.AudioSource):
-    def __init__(self, source):
-        self._source = source
-        self.read_count = 0
-
-    def read(self) -> bytes:
-        data = self._source.read()
-        if data:
-            self.read_count += 1
-        return data
-
-    def fast_forward(self, seconds: int):
-        for _ in range(int(seconds / 0.02)):
-            self.read()
-
-    @property
-    def progress(self) -> float:
-        return self.read_count * 0.02
-
-
-class YTDLSource(disnake.PCMVolumeTransformer):
-    def __init__(
-        self, source: CustomAudioSource, *, data: dict[str, Any], volume: float = 0.5
-    ):
-        super().__init__(source, volume)
-
-        self.description = data.get("description")
-        self.duration = data.get("duration")
-        self.id = data.get("id")
-        self.like_count = data.get("like_count")
-        self.original_url = data.get("original_url")
-        self.thumbnail_url = data.get("thumbnail")
-        self.timestamp = data.get("timestamp")
-        self.title = data.get("title")
-        self.uploader = data.get("uploader")
-        self.uploader_url = data.get("uploader_url")
-        self.view_count = data.get("view_count")
-
-    @classmethod
-    async def from_url(
-        cls,
-        url,
-        *,
-        loop: Optional[asyncio.AbstractEventLoop] = None,
-        stream: bool = False,
-    ):
-        loop = loop or asyncio.get_event_loop()
-        data: Any = await loop.run_in_executor(
-            None, lambda: ytdl.extract_info(url, download=not stream)
-        )
-
-        if "entries" in data:
-            data = data["entries"][0]
-
-        return cls(
-            CustomAudioSource(
-                disnake.FFmpegPCMAudio(
-                    data["url"] if stream else ytdl.prepare_filename(data),
-                    before_options="-vn -reconnect 1",
-                )
-            ),
-            data=data,
-        )
-
-    def __repr__(self):
-        return f"<YTDLSource title={self.title} original_url=<{self.original_url}> duration={self.duration}>"
-
-    def __str__(self):
-        return self.__repr__()
-
-
-@dataclass
-class QueuedSong:
-    player: YTDLSource
-    trigger_message: disnake.Message
-
-    def format(self, show_queuer=False, hide_preview=False, multiline=False) -> str:
-        if multiline:
-            return (
-                f"[`{self.player.title}`]({'<' if hide_preview else ''}{self.player.original_url}{'>' if hide_preview else ''})\n**duration:** {format_duration(self.player.duration) if self.player.duration else '[live]'}"
-                + (
-                    f", **queued by:** <@{self.trigger_message.author.id}>"
-                    if show_queuer
-                    else ""
-                )
-            )
-        else:
-            return (
-                f"[`{self.player.title}`]({'<' if hide_preview else ''}{self.player.original_url}{'>' if hide_preview else ''}) [**{format_duration(self.player.duration) if self.player.duration else 'live'}**]"
-                + (f" (<@{self.trigger_message.author.id}>)" if show_queuer else "")
-            )
-
-    def embed(self, is_paused=False):
-        progress = 0
-        if self.player.duration:
-            progress = self.player.original.progress / self.player.duration
-
-        embed = disnake.Embed(
-            color=EMBED_COLOR,
-            title=self.player.title,
-            url=self.player.original_url,
-            description=(
-                f"{'⏸️ ' if is_paused else ''}"
-                f"`[{'#'*int(progress * BAR_LENGTH)}{'-'*int((1 - progress) * BAR_LENGTH)}]` "
-                + (
-                    f"**{format_duration(int(self.player.original.progress))}** / **{format_duration(self.player.duration)}** (**{round(progress * 100)}%**)"
-                    if self.player.duration
-                    else "[**live**]"
-                )
-            ),
-        )
-
-        embed.add_field(
-            name="Uploader",
-            value=f"[{self.player.uploader}]({self.player.uploader_url})",
-        )
-        embed.add_field(name="Likes", value=f"{self.player.like_count:,}")
-        embed.add_field(name="Views", value=f"{self.player.view_count:,}")
-        embed.add_field(name="Published", value=f"<t:{self.player.timestamp}>")
-        embed.add_field(name="Volume", value=f"{int(self.player.volume*100)}%")
-
-        embed.set_image(self.player.thumbnail_url)
-        embed.set_footer(
-            text=f"queued by {self.trigger_message.author.name}",
-            icon_url=(
-                self.trigger_message.author.avatar.url
-                if self.trigger_message.author.avatar
-                else None
-            ),
-        )
-
-        return embed
-
-    def __str__(self):
-        return self.__repr__()
-
-
-@dataclass
-class QueuedPlayer:
-    queue = collections.deque()
-    current: Optional[QueuedSong] = None
-
-    def queue_pop(self):
-        popped = self.queue.popleft()
-        self.current = popped
-        return popped
-
-    def queue_add(self, item):
-        self.queue.append(item)
-
-    def queue_add_front(self, item):
-        self.queue.appendleft(item)
-
-    def __str__(self):
-        return self.__repr__()
-
-
-def format_duration(duration: int | float) -> str:
-    hours, duration = divmod(int(duration), 3600)
-    minutes, duration = divmod(duration, 60)
-    segments = [hours, minutes, duration]
-    if len(segments) == 3 and segments[0] == 0:
-        del segments[0]
-    return f"{':'.join(f'{s:0>2}' for s in segments)}"
-
-
-def __reload_module__():
-    global ytdl
-    ytdl = yt_dlp.YoutubeDL(YTDL_OPTIONS)