DiscordBotLinuxMonitor 1.6.1__tar.gz → 1.6.3__tar.gz

{discordbotlinuxmonitor-1.6.1 → discordbotlinuxmonitor-1.6.3}/DiscordBotLinuxMonitor.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: DiscordBotLinuxMonitor
-Version: 1.6.1
+Version: 1.6.3
 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
@@ -98,6 +98,8 @@ Displayed infos are not the same if you do the command in private or public chan
 
  - `/list_commands`: 📋 List all available commands 📋
 
+ - `/version`: 🤖 Show current bot version 🤖
+
  - `/execute_command {command_name} [parameters]`: 🚀 Execute a command (optional parameters, only for commands with `accept_parameters` or a `{arg1}`/`{args}` placeholder) 🚀
 
  - `/execute_all_commands`: 🚀 Execute all commands 🚀
@@ -121,6 +123,8 @@ Displayed infos are not the same if you do the command in private or public chan
  - `/kill_process`: 🚫 Stop a process by PID 🚫
  <img src="https://raw.githubusercontent.com/QuentinCG/Discord-Bot-Linux-Monitor-Python-Library/master/example/kill_process.jpg" height="200">
 
+ - `/clear_channel_messages {channel}`: 🧹 Remove all messages from a target channel (can clean any channel, command itself is 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.1 → discordbotlinuxmonitor-1.6.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: DiscordBotLinuxMonitor
-Version: 1.6.1
+Version: 1.6.3
 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
@@ -98,6 +98,8 @@ Displayed infos are not the same if you do the command in private or public chan
 
  - `/list_commands`: 📋 List all available commands 📋
 
+ - `/version`: 🤖 Show current bot version 🤖
+
  - `/execute_command {command_name} [parameters]`: 🚀 Execute a command (optional parameters, only for commands with `accept_parameters` or a `{arg1}`/`{args}` placeholder) 🚀
 
  - `/execute_all_commands`: 🚀 Execute all commands 🚀
@@ -121,6 +123,8 @@ Displayed infos are not the same if you do the command in private or public chan
  - `/kill_process`: 🚫 Stop a process by PID 🚫
  <img src="https://raw.githubusercontent.com/QuentinCG/Discord-Bot-Linux-Monitor-Python-Library/master/example/kill_process.jpg" height="200">
 
+ - `/clear_channel_messages {channel}`: 🧹 Remove all messages from a target channel (can clean any channel, command itself is 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.1 → discordbotlinuxmonitor-1.6.3}/README.md

@@ -56,6 +56,8 @@ Displayed infos are not the same if you do the command in private or public chan
 
  - `/list_commands`: 📋 List all available commands 📋
 
+ - `/version`: 🤖 Show current bot version 🤖
+
  - `/execute_command {command_name} [parameters]`: 🚀 Execute a command (optional parameters, only for commands with `accept_parameters` or a `{arg1}`/`{args}` placeholder) 🚀
 
  - `/execute_all_commands`: 🚀 Execute all commands 🚀
@@ -79,6 +81,8 @@ Displayed infos are not the same if you do the command in private or public chan
  - `/kill_process`: 🚫 Stop a process by PID 🚫
  <img src="https://raw.githubusercontent.com/QuentinCG/Discord-Bot-Linux-Monitor-Python-Library/master/example/kill_process.jpg" height="200">
 
+ - `/clear_channel_messages {channel}`: 🧹 Remove all messages from a target channel (can clean any channel, command itself is 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.1 → discordbotlinuxmonitor-1.6.3}/discordbotlinuxmonitor/__main__.py

@@ -54,6 +54,10 @@ def main() -> None:
     async def force_sync(interaction: discord.Interaction) -> None: # type: ignore
         await discord_bot_linux_monitor.force_sync(interaction)
 
+    @discord_bot.tree.command(name="version", description="🤖 Show bot version 🤖")
+    async def version(interaction: discord.Interaction) -> None: # type: ignore
+        await discord_bot_linux_monitor.version(interaction)
+
     @discord_bot.tree.command(name="usage", description="📊 View disk space, CPU, RAM, ... 📊")
     async def usage(interaction: discord.Interaction) -> None: # type: ignore
         await discord_bot_linux_monitor.usage(interaction)
@@ -122,6 +126,10 @@ def main() -> None:
     async def kill_process(interaction: discord.Interaction, pid: int) -> None: # type: ignore
         await discord_bot_linux_monitor.kill_process(interaction, pid)
 
+    @discord_bot.tree.command(name="clear_channel_messages", description="[Private] 🧹 Remove all messages from a channel 🧹")
+    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_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.1 → discordbotlinuxmonitor-1.6.3}/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.1 (2026/08/22)"
+__version__ = "1.6.3 (2026/08/24)"
 __status__ = "Usable for any Linux project"
 
 # pyright: reportMissingTypeStubs=false
@@ -43,7 +43,8 @@ import discord
 from discord.app_commands.models import AppCommand
 from discord.ext import commands
 import json
-from typing import List, Union, Awaitable, Callable
+from typing import List, Union, Awaitable, Callable, Any, Dict, Optional
+from datetime import datetime, timedelta, timezone
 
 import asyncio
 
@@ -285,6 +286,77 @@ class DiscordBotLinuxMonitor:
             logging.exception(msg=out_msg)
             return out_msg
 
+    def _welcome_message_with_version(self, welcome_message: str) -> str:
+        return f"{welcome_message}\n\n🤖 Bot version: {__version__}"
+
+    def _get_rate_limit_wait_seconds(self, error: discord.HTTPException, fallback_seconds: float = 1.5) -> float:
+        retry_after = getattr(error, "retry_after", None)
+        if isinstance(retry_after, (int, float)) and retry_after > 0:
+            return float(retry_after)
+
+        response = getattr(error, "response", None)
+        if response is not None:
+            headers = getattr(response, "headers", None)
+            if headers is not None:
+                header_retry_after = headers.get("Retry-After")
+                if header_retry_after is not None:
+                    try:
+                        parsed_retry_after = float(header_retry_after)
+                        if parsed_retry_after > 0:
+                            return parsed_retry_after
+                    except (ValueError, TypeError):
+                        pass
+
+        return fallback_seconds
+
+    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:
+                try:
+                    await message.delete(reason=reason)
+                except TypeError:
+                    # Some discord.py objects (e.g. PartialMessage) do not accept `reason`.
+                    await message.delete()
+                return
+            except discord.NotFound:
+                return
+            except discord.HTTPException as e:
+                if e.status == 429 and attempt < max_retries:
+                    if on_rate_limit is not None:
+                        on_rate_limit()
+                    wait_seconds = self._get_rate_limit_wait_seconds(error=e)
+                    logging.warning(msg=f"Rate limited while deleting message {message.id}, waiting {wait_seconds:.2f}s before retry...")
+                    await asyncio.sleep(wait_seconds)
+                    continue
+                raise
+
+    async def _bulk_delete_messages_with_rate_limit_retry(self, channel: discord.TextChannel, messages: List[discord.Message], reason: str, max_retries: int = 10, on_rate_limit: Optional[Callable[[], None]] = None) -> None:
+        if len(messages) == 0:
+            return
+
+        for attempt in range(max_retries + 1):
+            try:
+                if len(messages) == 1:
+                    try:
+                        await messages[0].delete(reason=reason)
+                    except TypeError:
+                        # Some discord.py objects (e.g. PartialMessage) do not accept `reason`.
+                        await messages[0].delete()
+                else:
+                    await channel.delete_messages(messages, reason=reason)
+                return
+            except discord.NotFound:
+                return
+            except discord.HTTPException as e:
+                if e.status == 429 and attempt < max_retries:
+                    if on_rate_limit is not None:
+                        on_rate_limit()
+                    wait_seconds = self._get_rate_limit_wait_seconds(error=e)
+                    logging.warning(msg=f"Rate limited while bulk deleting {len(messages)} messages in '{channel.name}', waiting {wait_seconds:.2f}s before retry...")
+                    await asyncio.sleep(wait_seconds)
+                    continue
+                raise
+
     #endregion
 
     #region BOT COMMANDS AND EVENTS DEFINITIONS
@@ -309,20 +381,20 @@ class DiscordBotLinuxMonitor:
                         logging.info(msg="Found the public channel, it will be possible to do public commands.")
                         public_channel_cmd_ready = True
                         if self.welcome_message_for_public_commands != "":
-                            await self._channel_send_no_limit(channel=channel, msg=self.welcome_message_for_public_commands)
+                            await self._channel_send_no_limit(channel=channel, msg=self._welcome_message_with_version(self.welcome_message_for_public_commands))
 
                     if self.channel_name_for_private_commands != "" and channel.name == self.channel_name_for_private_commands:
                         logging.info(msg="Found the private channel, it will be possible to do private commands.")
                         private_channel_cmd_ready = True
                         if self.welcome_message_for_private_commands != "":
-                            await self._channel_send_no_limit(channel=channel, msg=self.welcome_message_for_private_commands)
+                            await self._channel_send_no_limit(channel=channel, msg=self._welcome_message_with_version(self.welcome_message_for_private_commands))
 
                     if self.channel_name_for_public_error_tasks != "" and channel.name == self.channel_name_for_public_error_tasks:
                         logging.info(msg="Found the public channel for error task, it will be possible to show public status issues if found periodically.")
                         public_channel_error_task_ready = True
 
                         if self.welcome_message_for_public_error_tasks != "":
-                            await self._channel_send_no_limit(channel=channel, msg=self.welcome_message_for_public_error_tasks)
+                            await self._channel_send_no_limit(channel=channel, msg=self._welcome_message_with_version(self.welcome_message_for_public_error_tasks))
 
                         logging.info(msg=f"Activating automatic public follow and public service restart if down with '{self.bot.user}' and guild '{guild.name}' (id: '{guild.id}') on channel '{channel.name}' (id '{channel.id}').")
                         public_channel_for_error_task: discord.TextChannel = channel
@@ -336,7 +408,7 @@ class DiscordBotLinuxMonitor:
                         public_channel_info_task_ready = True
 
                         if self.welcome_message_for_public_infos_tasks != "":
-                            await self._channel_send_no_limit(channel=channel, msg=self.welcome_message_for_public_infos_tasks)
+                            await self._channel_send_no_limit(channel=channel, msg=self._welcome_message_with_version(self.welcome_message_for_public_infos_tasks))
 
                         logging.info(msg=f"Activating automatic public follow info with '{self.bot.user}' and guild '{guild.name}' (id: '{guild.id}') on channel '{channel.name}' (id '{channel.id}').")
                         public_channel_for_info_task: discord.TextChannel = channel
@@ -350,7 +422,7 @@ class DiscordBotLinuxMonitor:
                         private_channel_error_task_ready = True
 
                         if self.welcome_message_for_private_error_tasks != "":
-                            await self._channel_send_no_limit(channel=channel, msg=self.welcome_message_for_private_error_tasks)
+                            await self._channel_send_no_limit(channel=channel, msg=self._welcome_message_with_version(self.welcome_message_for_private_error_tasks))
 
                         logging.info(msg=f"Activating automatic private follow and public service restart if down with '{self.bot.user}' and guild '{guild.name}' (id: '{guild.id}') on channel '{channel.name}' (id '{channel.id}').")
                         private_channel_for_error_task: discord.TextChannel = channel
@@ -364,7 +436,7 @@ class DiscordBotLinuxMonitor:
                         private_channel_info_task_ready = True
 
                         if self.welcome_message_for_private_infos_tasks != "":
-                            await self._channel_send_no_limit(channel=channel, msg=self.welcome_message_for_private_infos_tasks)
+                            await self._channel_send_no_limit(channel=channel, msg=self._welcome_message_with_version(self.welcome_message_for_private_infos_tasks))
 
                         logging.info(msg=f"Activating automatic private follow info with '{self.bot.user}' and guild '{guild.name}' (id: '{guild.id}') on channel '{channel.name}' (id '{channel.id}').")
                         private_channel_for_info_task: discord.TextChannel = channel
@@ -425,6 +497,18 @@ class DiscordBotLinuxMonitor:
         # Respond to the user
         await self._interaction_followup_send_no_limit(interaction=interaction, msg=out_msg)
 
+    async def version(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
+
+        out_msg: str = (
+            f"🤖 Bot version: {__version__}\n"
+            f"🐍 Python compatibility: {__python_version__}"
+        )
+        await interaction.response.send_message(content=out_msg, ephemeral=True)
+
     async def usage(self, interaction: discord.Interaction) -> None:
         if not self._check_if_valid_guild(guild=interaction.guild):
             return
@@ -783,6 +867,124 @@ class DiscordBotLinuxMonitor:
             logging.exception(msg=out_msg)
             await self._interaction_followup_send_no_limit(interaction=interaction, msg=out_msg)
 
+    async def clear_channel_messages(self, interaction: discord.Interaction, channel: discord.TextChannel) -> 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
+
+        # Make sure only authorized users can trigger a destructive command.
+        permissions = channel.permissions_for(interaction.user) # type: ignore
+        if not permissions.manage_messages:
+            await interaction.response.send_message(content=f"❌ You need 'Manage Messages' permission on channel '{channel.name}' to clear it.", ephemeral=True)
+            return
+
+        bot_member = interaction.guild.me if interaction.guild is not None else None # type: ignore
+        if bot_member is None:
+            await interaction.response.send_message(content="❌ Unable to resolve bot permissions.", ephemeral=True)
+            return
+
+        bot_permissions = channel.permissions_for(bot_member)
+        if not bot_permissions.manage_messages or not bot_permissions.read_message_history:
+            await interaction.response.send_message(content=f"❌ Bot is missing required permissions on channel '{channel.name}' (Manage Messages and Read Message History).", ephemeral=True)
+            return
+
+        await interaction.response.defer(ephemeral=True)
+
+        deleted_count: int = 0
+        rate_limit_retries: int = 0
+        delete_reason: str = f"Requested by {interaction.user} from private channel"
+        two_weeks_ago = datetime.now(timezone.utc) - timedelta(days=14)
+        progress_every_seconds: float = 2.5
+        progress_every_deleted_messages: int = 200
+        started_monotonic: float = asyncio.get_running_loop().time()
+        last_progress_monotonic: float = started_monotonic
+        last_reported_deleted_count: int = 0
+
+        def _on_rate_limit_hit() -> None:
+            nonlocal rate_limit_retries
+            rate_limit_retries += 1
+
+        async def _update_progress(force: bool = False) -> None:
+            nonlocal last_progress_monotonic
+            nonlocal last_reported_deleted_count
+
+            now = asyncio.get_running_loop().time()
+            should_update = force
+            if not should_update:
+                enough_time_elapsed = (now - last_progress_monotonic) >= progress_every_seconds
+                enough_messages_deleted = (deleted_count - last_reported_deleted_count) >= progress_every_deleted_messages
+                should_update = enough_time_elapsed or enough_messages_deleted
+
+            if not should_update:
+                return
+
+            elapsed_seconds = int(now - started_monotonic)
+            progress_msg = (
+                f"🧹 Cleaning channel '{channel.name}'...\n"
+                f"Deleted messages: {deleted_count}\n"
+                f"Rate-limit waits: {rate_limit_retries}\n"
+                f"Elapsed: {elapsed_seconds}s"
+            )
+
+            try:
+                await interaction.edit_original_response(content=progress_msg)
+                last_progress_monotonic = now
+                last_reported_deleted_count = deleted_count
+            except discord.HTTPException as e:
+                if e.status == 429:
+                    _on_rate_limit_hit()
+                    wait_seconds = self._get_rate_limit_wait_seconds(error=e)
+                    await asyncio.sleep(wait_seconds)
+                else:
+                    logging.warning(msg=f"Failed to update cleanup progress message: {e}")
+
+        try:
+            await _update_progress(force=True)
+            recent_batch: List[discord.Message] = []
+
+            async for message in channel.history(limit=None, oldest_first=False):
+                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:
+                        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:
+                    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:
+                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_seconds = int(asyncio.get_running_loop().time() - started_monotonic)
+            out_msg = (
+                f"✅ Cleared channel '{channel.name}'.\n"
+                f"Deleted messages: {deleted_count}\n"
+                f"Rate-limit waits: {rate_limit_retries}\n"
+                f"Elapsed: {elapsed_seconds}s"
+            )
+            await interaction.edit_original_response(content=out_msg)
+        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)
+        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)
+
     async def list_commands(self, interaction: discord.Interaction) -> None:
         if not self._check_if_valid_guild(guild=interaction.guild):
             return

{discordbotlinuxmonitor-1.6.1 → discordbotlinuxmonitor-1.6.3}/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.1",
+    version="1.6.3",
     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",