DiscordBotLinuxMonitor 1.6.4__tar.gz → 1.6.6__tar.gz

{discordbotlinuxmonitor-1.6.4 → discordbotlinuxmonitor-1.6.6}/DiscordBotLinuxMonitor.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: DiscordBotLinuxMonitor
-Version: 1.6.4
+Version: 1.6.6
 Summary: From discord channels: Get information and warning status of Linux server like service, port, ping, ssl certificate, disk/folder/cpu/ram/swap usage, ip connection, ... (Python and shell library, Linux ONLY)
 Home-page: https://github.com/QuentinCG/Discord-Bot-Linux-Monitor-Python-Library
 Author: Quentin Comte-Gaz
@@ -125,6 +125,8 @@ Displayed infos are not the same if you do the command in private or public chan
 
  - `/clear_channel_messages {channel}`: 🧹 Remove all messages from a target channel (can clean any channel, command itself is private-only) 🧹
 
+ - `/list_clearable_channels`: 🧹 List text channels and whether the bot can clear them (View + Read History + Manage Messages), private-only 🧹
+
 ## How to install (for first launch)
 
   - Install package calling `python -m pip install discordbotlinuxmonitor` (or `python setup.py install` from the root of this repository)

{discordbotlinuxmonitor-1.6.4 → discordbotlinuxmonitor-1.6.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: DiscordBotLinuxMonitor
-Version: 1.6.4
+Version: 1.6.6
 Summary: From discord channels: Get information and warning status of Linux server like service, port, ping, ssl certificate, disk/folder/cpu/ram/swap usage, ip connection, ... (Python and shell library, Linux ONLY)
 Home-page: https://github.com/QuentinCG/Discord-Bot-Linux-Monitor-Python-Library
 Author: Quentin Comte-Gaz
@@ -125,6 +125,8 @@ Displayed infos are not the same if you do the command in private or public chan
 
  - `/clear_channel_messages {channel}`: 🧹 Remove all messages from a target channel (can clean any channel, command itself is private-only) 🧹
 
+ - `/list_clearable_channels`: 🧹 List text channels and whether the bot can clear them (View + Read History + Manage Messages), private-only 🧹
+
 ## How to install (for first launch)
 
   - Install package calling `python -m pip install discordbotlinuxmonitor` (or `python setup.py install` from the root of this repository)

{discordbotlinuxmonitor-1.6.4 → discordbotlinuxmonitor-1.6.6}/README.md

@@ -83,6 +83,8 @@ Displayed infos are not the same if you do the command in private or public chan
 
  - `/clear_channel_messages {channel}`: 🧹 Remove all messages from a target channel (can clean any channel, command itself is private-only) 🧹
 
+ - `/list_clearable_channels`: 🧹 List text channels and whether the bot can clear them (View + Read History + Manage Messages), private-only 🧹
+
 ## How to install (for first launch)
 
   - Install package calling `python -m pip install discordbotlinuxmonitor` (or `python setup.py install` from the root of this repository)

{discordbotlinuxmonitor-1.6.4 → discordbotlinuxmonitor-1.6.6}/discordbotlinuxmonitor/__main__.py

@@ -130,6 +130,10 @@ def main() -> None:
     async def clear_channel_messages(interaction: discord.Interaction, channel: discord.TextChannel) -> None: # type: ignore
         await discord_bot_linux_monitor.clear_channel_messages(interaction, channel)
 
+    @discord_bot.tree.command(name="list_clearable_channels", description="[Private] 🧹 List text channels and bot clear permissions 🧹")
+    async def list_clearable_channels(interaction: discord.Interaction) -> None: # type: ignore
+        await discord_bot_linux_monitor.list_clearable_channels(interaction)
+
     @discord_bot.tree.command(name="list_commands", description="📋 List all available commands 📋")
     async def list_commands(interaction: discord.Interaction) -> None: # type: ignore
         await discord_bot_linux_monitor.list_commands(interaction)

{discordbotlinuxmonitor-1.6.4 → discordbotlinuxmonitor-1.6.6}/discordbotlinuxmonitor/discordbotlinuxmonitor.py

@@ -33,7 +33,7 @@ __email__ = "quentin@comte-gaz.com"
 __license__ = "MIT License"
 __copyright__ = "Copyright Quentin Comte-Gaz (2026)"
 __python_version__ = "3.+"
-__version__ = "1.6.4 (2026/08/24)"
+__version__ = "1.6.6 (2026/08/24)"
 __status__ = "Usable for any Linux project"
 
 # pyright: reportMissingTypeStubs=false
@@ -328,6 +328,68 @@ class DiscordBotLinuxMonitor:
 
         return " ".join(parts)
 
+    def _get_message_preview(self, message: discord.Message, max_length: int = 80) -> str:
+        content: str = str(getattr(message, "content", "") or "").strip()
+
+        if content == "":
+            attachments = getattr(message, "attachments", [])
+            embeds = getattr(message, "embeds", [])
+            if len(attachments) > 0:
+                content = f"[{len(attachments)} attachment(s)]"
+            elif len(embeds) > 0:
+                content = f"[{len(embeds)} embed(s)]"
+            else:
+                content = "[no text]"
+
+        content = content.replace("\n", " ").replace("\r", " ")
+        created_at = getattr(message, "created_at", None)
+        if created_at is not None:
+            try:
+                timestamp = created_at.astimezone(timezone.utc).strftime("%Y-%m-%d %H:%M:%S UTC")
+            except Exception:
+                timestamp = str(created_at)
+        else:
+            timestamp = "unknown-time"
+
+        if len(content) > max_length:
+            content = content[:max_length - 3] + "..."
+
+        return f"[{timestamp}] {content}"
+
+    def _build_cleanup_embed(self, channel_name: str, state: str, deleted_count: int, rate_limit_retries: int, elapsed_seconds: float, last_deleted_preview: str, spinner_frame: str = "", scanned_count: Optional[int] = None, error_text: str = "") -> "discord.Embed":
+        # state is one of: "running", "done", "error".
+        if state == "done":
+            color = discord.Color.green()
+            title = "🧹 Channel Cleanup — Completed"
+            status_value = "✅ Completed"
+        elif state == "error":
+            color = discord.Color.red()
+            title = "🧹 Channel Cleanup — Failed"
+            status_value = "❌ Failed"
+        else:
+            color = discord.Color.blurple()
+            title = "🧹 Channel Cleanup — In progress"
+            status_value = f"{spinner_frame} Working…".strip()
+
+        embed = discord.Embed(title=title, color=color)
+        embed.description = f"Target channel: **#{channel_name}**"
+
+        embed.add_field(name="Status", value=status_value, inline=True)
+        embed.add_field(name="🗑️ Deleted", value=f"**{deleted_count}** message(s)", inline=True)
+        embed.add_field(name="⏳ Elapsed", value=self._format_duration(elapsed_seconds), inline=True)
+
+        if scanned_count is not None:
+            embed.add_field(name="🔎 Scanned", value=f"{scanned_count} message(s)", inline=True)
+        embed.add_field(name="🚦 Rate-limit waits", value=str(rate_limit_retries), inline=True)
+
+        if error_text != "":
+            embed.add_field(name="⚠️ Error", value=f"```sh\n{error_text[:1000]}\n```", inline=False)
+
+        embed.add_field(name="🕗 Last deleted message", value=(last_deleted_preview if last_deleted_preview != "" else "N/A")[:1024], inline=False)
+
+        embed.set_footer(text=f"Bot v{__version__} • Last update: {datetime.now().strftime('%Y-%m-%d %H:%M:%S')}")
+        return embed
+
     async def _delete_message_with_rate_limit_retry(self, message: discord.Message, reason: str, max_retries: int = 10, on_rate_limit: Optional[Callable[[], None]] = None) -> None:
         for attempt in range(max_retries + 1):
             try:
@@ -922,10 +984,12 @@ class DiscordBotLinuxMonitor:
         started_monotonic: float = asyncio.get_running_loop().time()
         last_progress_monotonic: float = started_monotonic
         last_reported_deleted_count: int = 0
-        heartbeat_frames: List[str] = ["|", "/", "-", "\\"]
+        heartbeat_frames: List[str] = ["◐", "◓", "◑", "◒"]
         heartbeat_index: int = 0
         heartbeat_stop_event = asyncio.Event()
         heartbeat_task: Optional[asyncio.Task] = None
+        last_deleted_message_preview: str = "N/A"
+        scanned_count: int = 0
 
         def _on_rate_limit_hit() -> None:
             nonlocal rate_limit_retries
@@ -946,21 +1010,21 @@ class DiscordBotLinuxMonitor:
             if not should_update:
                 return
 
-            elapsed_duration = self._format_duration(now - started_monotonic)
-            last_update = datetime.now().strftime("%Y-%m-%d %H:%M:%S")
             heartbeat_frame = heartbeat_frames[heartbeat_index % len(heartbeat_frames)]
             heartbeat_index += 1
-            progress_msg = (
-                f"🧹 Cleaning channel '{channel.name}'...\n"
-                f" - Status: {heartbeat_frame} Working...\n"
-                f" - Deleted messages: {deleted_count}\n"
-                f" - Rate-limit waits: {rate_limit_retries}\n"
-                f" - Elapsed: {elapsed_duration}\n"
-                f" - Last update: {last_update}"
+            embed = self._build_cleanup_embed(
+                channel_name=channel.name,
+                state="running",
+                deleted_count=deleted_count,
+                rate_limit_retries=rate_limit_retries,
+                elapsed_seconds=now - started_monotonic,
+                last_deleted_preview=last_deleted_message_preview,
+                spinner_frame=heartbeat_frame,
+                scanned_count=scanned_count,
             )
 
             try:
-                await interaction.edit_original_response(content=progress_msg)
+                await interaction.edit_original_response(content=None, embed=embed)
                 last_progress_monotonic = now
                 last_reported_deleted_count = deleted_count
             except discord.HTTPException as e:
@@ -984,46 +1048,67 @@ class DiscordBotLinuxMonitor:
             recent_batch: List[discord.Message] = []
 
             async for message in channel.history(limit=None, oldest_first=False):
+                scanned_count += 1
                 if message.created_at >= two_weeks_ago:
                     recent_batch.append(message)
 
                     # Bulk delete by chunks of 100 to reduce API calls and rate-limit pressure.
                     if len(recent_batch) == 100:
+                        last_deleted_message_preview = self._get_message_preview(recent_batch[-1])
                         await self._bulk_delete_messages_with_rate_limit_retry(channel=channel, messages=recent_batch, reason=delete_reason, on_rate_limit=_on_rate_limit_hit)
                         deleted_count += len(recent_batch)
                         recent_batch = []
                         await _update_progress()
                 else:
+                    last_deleted_message_preview = self._get_message_preview(message)
                     await self._delete_message_with_rate_limit_retry(message=message, reason=delete_reason, on_rate_limit=_on_rate_limit_hit)
                     deleted_count += 1
                     await _update_progress()
 
             if len(recent_batch) > 0:
+                last_deleted_message_preview = self._get_message_preview(recent_batch[-1])
                 await self._bulk_delete_messages_with_rate_limit_retry(channel=channel, messages=recent_batch, reason=delete_reason, on_rate_limit=_on_rate_limit_hit)
                 deleted_count += len(recent_batch)
                 await _update_progress()
 
-            elapsed_duration = self._format_duration(asyncio.get_running_loop().time() - started_monotonic)
-            last_update = datetime.now().strftime("%Y-%m-%d %H:%M:%S")
-            out_msg = (
-                f"✅ Cleared channel '{channel.name}'.\n"
-                f" - Status: Completed\n"
-                f" - Deleted messages: {deleted_count}\n"
-                f" - Rate-limit waits: {rate_limit_retries}\n"
-                f" - Elapsed: {elapsed_duration}\n"
-                f" - Last update: {last_update}"
+            embed = self._build_cleanup_embed(
+                channel_name=channel.name,
+                state="done",
+                deleted_count=deleted_count,
+                rate_limit_retries=rate_limit_retries,
+                elapsed_seconds=asyncio.get_running_loop().time() - started_monotonic,
+                last_deleted_preview=last_deleted_message_preview,
+                scanned_count=scanned_count,
             )
-            await interaction.edit_original_response(content=out_msg)
+            await interaction.edit_original_response(content=None, embed=embed)
         except discord.HTTPException as e:
             if e.status == 429:
                 _on_rate_limit_hit()
-            out_msg = f"**Discord API error while clearing messages in channel '{channel.name}'** (status {e.status}, retries: {rate_limit_retries}):\n```sh\n{e}\n```"
-            logging.exception(msg=out_msg)
-            await interaction.edit_original_response(content=out_msg)
+            embed = self._build_cleanup_embed(
+                channel_name=channel.name,
+                state="error",
+                deleted_count=deleted_count,
+                rate_limit_retries=rate_limit_retries,
+                elapsed_seconds=asyncio.get_running_loop().time() - started_monotonic,
+                last_deleted_preview=last_deleted_message_preview,
+                scanned_count=scanned_count,
+                error_text=f"Discord API error (status {e.status}): {e}",
+            )
+            logging.exception(msg=f"Discord API error while clearing messages in channel '{channel.name}': {e}")
+            await interaction.edit_original_response(content=None, embed=embed)
         except Exception as e:
-            out_msg = f"**Internal error while clearing messages in channel '{channel.name}'**:\n```sh\n{e}\n```"
-            logging.exception(msg=out_msg)
-            await interaction.edit_original_response(content=out_msg)
+            embed = self._build_cleanup_embed(
+                channel_name=channel.name,
+                state="error",
+                deleted_count=deleted_count,
+                rate_limit_retries=rate_limit_retries,
+                elapsed_seconds=asyncio.get_running_loop().time() - started_monotonic,
+                last_deleted_preview=last_deleted_message_preview,
+                scanned_count=scanned_count,
+                error_text=str(e),
+            )
+            logging.exception(msg=f"Internal error while clearing messages in channel '{channel.name}': {e}")
+            await interaction.edit_original_response(content=None, embed=embed)
         finally:
             heartbeat_stop_event.set()
             if heartbeat_task is not None and not heartbeat_task.done():
@@ -1033,6 +1118,55 @@ class DiscordBotLinuxMonitor:
                 except asyncio.CancelledError:
                     pass
 
+    async def list_clearable_channels(self, interaction: discord.Interaction) -> None:
+        if not self._check_if_valid_guild(guild=interaction.guild):
+            return
+        if not (await self._is_bot_channel_interaction(interaction=interaction, send_message_if_not_bot=True)):
+            return
+        if not self._is_private_channel(channel=interaction.channel): # type: ignore
+            await interaction.response.send_message(content="❌ Public channels do not allow this command.", ephemeral=True)
+            return
+
+        await interaction.response.defer(ephemeral=True)
+
+        guild = interaction.guild
+        bot_member = guild.me if guild is not None else None # type: ignore
+        if guild is None or bot_member is None:
+            await interaction.followup.send(content="❌ Unable to resolve the guild or bot member.", ephemeral=True)
+            return
+
+        try:
+            clearable_lines: List[str] = []
+            blocked_lines: List[str] = []
+
+            for text_channel in guild.text_channels:
+                perms = text_channel.permissions_for(bot_member)
+                can_view: bool = perms.view_channel
+                can_read_history: bool = perms.read_message_history
+                can_manage: bool = perms.manage_messages
+                is_clearable: bool = can_view and can_read_history and can_manage
+
+                line = (
+                    f"{'✅' if is_clearable else '❌'} #{text_channel.name} "
+                    f"(View: {'✔' if can_view else '✘'}, "
+                    f"History: {'✔' if can_read_history else '✘'}, "
+                    f"Manage: {'✔' if can_manage else '✘'})"
+                )
+                if is_clearable:
+                    clearable_lines.append(line)
+                else:
+                    blocked_lines.append(line)
+
+            out_msg = f"🧹 **Clearable channels report** ({len(clearable_lines)} clearable / {len(guild.text_channels)} text channels)\n\n"
+            out_msg += "**✅ Clearable:**\n" + ("\n".join(clearable_lines) if clearable_lines else "None") + "\n\n"
+            out_msg += "**❌ Blocked (missing bot permission):**\n" + ("\n".join(blocked_lines) if blocked_lines else "None")
+
+            await self._interaction_followup_send_no_limit(interaction=interaction, msg=out_msg)
+        except Exception as e:
+            out_msg = f"**Internal error listing clearable channels**:\n```sh\n{e}\n```"
+            logging.exception(msg=out_msg)
+            await self._interaction_followup_send_no_limit(interaction=interaction, msg=out_msg)
+
     async def list_commands(self, interaction: discord.Interaction) -> None:
         if not self._check_if_valid_guild(guild=interaction.guild):
             return

{discordbotlinuxmonitor-1.6.4 → discordbotlinuxmonitor-1.6.6}/setup.py

@@ -6,7 +6,7 @@ with io.open(file='README.md', mode='r', encoding='utf-8') as readme_file:
 
 setup(
     name="DiscordBotLinuxMonitor",
-    version="1.6.4",
+    version="1.6.6",
     description="From discord channels: Get information and warning status of Linux server like service, port, ping, ssl certificate, disk/folder/cpu/ram/swap usage, ip connection, ... (Python and shell library, Linux ONLY)",
     long_description=readme,
     long_description_content_type="text/markdown",