feat: Add bot logging for debugging.

MusicBot/cogs/voice.py

@@ -1,3 +1,4 @@
+import logging
 from typing import cast
 
 import discord
@@ -5,9 +6,10 @@ from discord.ext.commands import Cog
 
 from yandex_music import Track, ClientAsync
 
-from MusicBot.cogs.utils.voice_extension import VoiceExtension, generate_player_embed
+from MusicBot.cogs.utils.voice_extension import VoiceExtension
 from MusicBot.cogs.utils.player import Player
-from MusicBot.cogs.utils.misc import QueueView, generate_queue_embed
+from MusicBot.cogs.utils.misc import generate_queue_embed, generate_track_embed
+from MusicBot.cogs.utils.views import QueueView
 
 def setup(bot: discord.Bot):
     bot.add_cog(Voice(bot))
@@ -24,23 +26,27 @@ class Voice(Cog, VoiceExtension):
 
     @Cog.listener()
     async def on_voice_state_update(self, member: discord.Member, before: discord.VoiceState, after: discord.VoiceState) -> None:
+        logging.debug(f"Voice state update for member {member.id} in guild {member.guild.id}")
         gid = member.guild.id
         guild = self.db.get_guild(gid)
 
         channel = after.channel or before.channel
         if not channel:
+            logging.debug(f"No channel found for member {member.id}")
             return
 
         discord_guild = await self.bot.fetch_guild(gid)
         vc = cast(discord.VoiceClient | None, discord.utils.get(self.bot.voice_clients, guild=discord_guild))
 
         if len(channel.members) == 1 and vc:
+            logging.debug(f"Clearing history and stopping playback for guild {gid}")
             self.db.clear_history(gid)
             self.db.update(gid, {'current_track': None, 'is_stopped': True})
             vc.stop()
         elif len(channel.members) > 2 and not guild['always_allow_menu']:
             current_player = self.db.get_current_player(gid)
             if current_player:
+                logging.debug(f"Disabling current player for guild {gid} due to multiple members")
                 self.db.update(gid, {'current_player': None, 'repeat': False, 'shuffle': False})
                 try:
                     message = await channel.fetch_message(current_player)
@@ -51,6 +57,7 @@ class Voice(Cog, VoiceExtension):
 
     @Cog.listener()
     async def on_raw_reaction_add(self, payload: discord.RawReactionActionEvent) -> None:
+        logging.debug(f"Reaction added by user {payload.user_id} in channel {payload.channel_id}")
         if not self.bot.user or not payload.member:
             return
         
@@ -79,23 +86,29 @@ class Voice(Cog, VoiceExtension):
 
         vote_data = votes[str(payload.message_id)]
         if payload.emoji.name == '✅':
+            logging.debug(f"User {payload.user_id} voted positively for message {payload.message_id}")
             vote_data['positive_votes'].append(payload.user_id)
         elif payload.emoji.name == '❌':
+            logging.debug(f"User {payload.user_id} voted negatively for message {payload.message_id}")
             vote_data['negative_votes'].append(payload.user_id)
 
         total_members = len(channel.members)
         required_votes = 2 if total_members <= 5 else 4 if total_members <= 10 else 6 if total_members <= 15 else 9
         if len(vote_data['positive_votes']) >= required_votes:
+            logging.debug(f"Enough positive votes for message {payload.message_id}")
             if vote_data['action'] == 'next':
+                logging.debug(f"Skipping track for message {payload.message_id}")
                 self.db.update(guild_id, {'is_stopped': False})
                 title = await self.next_track(payload)
                 await message.clear_reactions()
                 await message.edit(content=f"Сейчас играет: **{title}**!", delete_after=15)
                 del votes[str(payload.message_id)]
             elif vote_data['action'] == 'add_track':
+                logging.debug(f"Adding track for message {payload.message_id}")
                 await message.clear_reactions()
                 track = vote_data['vote_content']
                 if not track:
+                    logging.debug(f"Recieved empty vote context for message {payload.message_id}")
                     return
                 self.db.update(guild_id, {'is_stopped': False})
                 self.db.modify_track(guild_id, track, 'next', 'append')
@@ -106,9 +119,11 @@ class Voice(Cog, VoiceExtension):
                     await message.edit(content=f"Сейчас играет: **{title}**!", delete_after=15)
                 del votes[str(payload.message_id)]
             elif vote_data['action'] in ('add_album', 'add_artist', 'add_playlist'):
+                logging.debug(f"Performing '{vote_data['action']}' action for message {payload.message_id}")
                 tracks = vote_data['vote_content']
                 await message.clear_reactions()
                 if not tracks:
+                    logging.debug(f"Recieved empty vote context for message {payload.message_id}")
                     return
                 self.db.update(guild_id, {'is_stopped': False})
                 self.db.modify_track(guild_id, tracks, 'next', 'extend')
@@ -119,6 +134,7 @@ class Voice(Cog, VoiceExtension):
                     await message.edit(content=f"Сейчас играет: **{title}**!", delete_after=15)
                 del votes[str(payload.message_id)]
         elif len(vote_data['negative_votes']) >= required_votes:
+            logging.debug(f"Enough negative votes for message {payload.message_id}")
             await message.clear_reactions()
             await message.edit(content='Запрос был отклонён.', delete_after=15)
             del votes[str(payload.message_id)]
@@ -127,6 +143,7 @@ class Voice(Cog, VoiceExtension):
 
     @Cog.listener()
     async def on_raw_reaction_remove(self, payload: discord.RawReactionActionEvent) -> None:
+        logging.debug(f"Reaction removed by user {payload.user_id} in channel {payload.channel_id}")
         if not self.bot.user:
             return
         
@@ -146,14 +163,17 @@ class Voice(Cog, VoiceExtension):
 
         vote_data = votes[str(payload.message_id)]
         if payload.emoji.name == '✔️':
+            logging.debug(f"User {payload.user_id} removed positive vote for message {payload.message_id}")
             del vote_data['positive_votes'][payload.user_id]
         elif payload.emoji.name == '❌':
+            logging.debug(f"User {payload.user_id} removed negative vote for message {payload.message_id}")
             del vote_data['negative_votes'][payload.user_id]
         
         self.db.update(guild_id, {'votes': votes})
     
     @voice.command(name="menu", description="Создать меню проигрывателя. Доступно только если вы единственный в голосовом канале.")
     async def menu(self, ctx: discord.ApplicationContext) -> None:
+        logging.debug(f"Menu command invoked by user {ctx.author.id} in guild {ctx.guild.id}")
         if not await self.voice_check(ctx):
             return
 
@@ -162,11 +182,12 @@ class Voice(Cog, VoiceExtension):
         embed = None
 
         if len(channel.members) > 2 and not guild['always_allow_menu']:
+            logging.debug(f"Action declined: other members are present in the voice channel")
             await ctx.respond("❌ Вы не единственный в голосовом канале.", ephemeral=True)
             return
 
         if guild['current_track']:
-            embed = await generate_player_embed(
+            embed = await generate_track_embed(
                 Track.de_json(
                     guild['current_track'],
                     client=ClientAsync()  # type: ignore  # Async client can be used here.
@@ -179,6 +200,7 @@ class Voice(Cog, VoiceExtension):
                 embed.remove_footer()
 
         if guild['current_player']:
+            logging.debug(f"Deleteing old player menu {guild['current_player']} in guild {ctx.guild.id}")
             message = await ctx.fetch_message(guild['current_player'])
             await message.delete()
 
@@ -188,11 +210,12 @@ class Voice(Cog, VoiceExtension):
 
     @voice.command(name="join", description="Подключиться к голосовому каналу, в котором вы сейчас находитесь.")
     async def join(self, ctx: discord.ApplicationContext) -> None:
+        logging.debug(f"Join command invoked by user {ctx.author.id} in guild {ctx.guild.id}")
         member = cast(discord.Member, ctx.author)
         vc = await self.get_voice_client(ctx)
         if not member.guild_permissions.manage_channels:
             response_message = "❌ У вас нет прав для выполнения этой команды."
-        elif vc and vc.is_playing():
+        elif vc and vc.is_connected():
             response_message = "❌ Бот уже находится в голосовом канале. Выключите его с помощью команды /voice leave."
         elif isinstance(ctx.channel, discord.VoiceChannel):
             await ctx.channel.connect(timeout=15)
@@ -204,6 +227,7 @@ class Voice(Cog, VoiceExtension):
 
     @voice.command(description="Заставить бота покинуть голосовой канал.")
     async def leave(self, ctx: discord.ApplicationContext) -> None:
+        logging.debug(f"Leave command invoked by user {ctx.author.id} in guild {ctx.guild.id}")
         member = cast(discord.Member, ctx.author)
         if not member.guild_permissions.manage_channels:
             await ctx.respond("❌ У вас нет прав для выполнения этой команды.", delete_after=15, ephemeral=True)
@@ -211,13 +235,15 @@ class Voice(Cog, VoiceExtension):
         
         vc = await self.get_voice_client(ctx)
         if await self.voice_check(ctx) and vc:
-            await self.stop_playing(ctx)
+            self.db.update(ctx.guild.id, {'current_track': None, 'is_stopped': True})
             self.db.clear_history(ctx.guild.id)
+            vc.stop()
             await vc.disconnect(force=True)
             await ctx.respond("Отключение успешно!", delete_after=15, ephemeral=True)
 
     @queue.command(description="Очистить очередь треков и историю прослушивания.")
     async def clear(self, ctx: discord.ApplicationContext) -> None:
+        logging.debug(f"Clear queue command invoked by user {ctx.author.id} in guild {ctx.guild.id}")
         member = cast(discord.Member, ctx.author)
         channel = cast(discord.VoiceChannel, ctx.channel)
         if len(channel.members) > 2 and not member.guild_permissions.manage_channels:
@@ -228,6 +254,7 @@ class Voice(Cog, VoiceExtension):
 
     @queue.command(description="Получить очередь треков.")
     async def get(self, ctx: discord.ApplicationContext) -> None:
+        logging.debug(f"Get queue command invoked by user {ctx.author.id} in guild {ctx.guild.id}")
         if not await self.voice_check(ctx):
             return
         tracks = self.db.get_tracks_list(ctx.guild.id, 'next')
@@ -237,6 +264,7 @@ class Voice(Cog, VoiceExtension):
 
     @track.command(description="Приостановить текущий трек.")
     async def pause(self, ctx: discord.ApplicationContext) -> None:
+        logging.debug(f"Pause command invoked by user {ctx.author.id} in guild {ctx.guild.id}")
         member = cast(discord.Member, ctx.author)
         channel = cast(discord.VoiceChannel, ctx.channel)
         if len(channel.members) > 2 and not member.guild_permissions.manage_channels:
@@ -253,6 +281,7 @@ class Voice(Cog, VoiceExtension):
 
     @track.command(description="Возобновить текущий трек.")
     async def resume(self, ctx: discord.ApplicationContext) -> None:
+        logging.debug(f"Resume command invoked by user {ctx.author.id} in guild {ctx.guild.id}")
         member = cast(discord.Member, ctx.author)
         channel = cast(discord.VoiceChannel, ctx.channel)
         if len(channel.members) > 2 and not member.guild_permissions.manage_channels:
@@ -269,6 +298,7 @@ class Voice(Cog, VoiceExtension):
 
     @track.command(description="Прервать проигрывание, удалить историю, очередь и текущий плеер.")
     async def stop(self, ctx: discord.ApplicationContext) -> None:
+        logging.debug(f"Stop command invoked by user {ctx.author.id} in guild {ctx.guild.id}")
         member = cast(discord.Member, ctx.author)
         channel = cast(discord.VoiceChannel, ctx.channel)
         if len(channel.members) > 2 and not member.guild_permissions.manage_channels:
@@ -288,6 +318,7 @@ class Voice(Cog, VoiceExtension):
 
     @track.command(description="Переключиться на следующую песню в очереди.")
     async def next(self, ctx: discord.ApplicationContext) -> None:
+        logging.debug(f"Next command invoked by user {ctx.author.id} in guild {ctx.guild.id}")
         if not await self.voice_check(ctx):
             return
         gid = ctx.guild.id
@@ -321,10 +352,13 @@ class Voice(Cog, VoiceExtension):
 
     @track.command(description="Добавить трек в избранное или убрать, если он уже там.")
     async def like(self, ctx: discord.ApplicationContext) -> None:
+        logging.debug(f"Like command invoked by user {ctx.author.id} in guild {ctx.guild.id}")
         if await self.voice_check(ctx):
             vc = await self.get_voice_client(ctx)
             if not vc or not vc.is_playing:
+                logging.debug(f"No current track in {ctx.guild.id}")
                 await ctx.respond("Нет воспроизводимого трека.", delete_after=15, ephemeral=True)
+                return
             result = await self.like_track(ctx)
             if not result:
                 await ctx.respond("❌ Операция не удалась.", delete_after=15, ephemeral=True)