DiscordBotLinuxMonitor 1.6.5__tar.gz → 1.6.6__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: DiscordBotLinuxMonitor
-Version: 1.6.5
+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.5 → discordbotlinuxmonitor-1.6.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: DiscordBotLinuxMonitor
-Version: 1.6.5
+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.5 → 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.5 → 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.5 → 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.5 (2026/08/24)"
+__version__ = "1.6.6 (2026/08/24)"
 __status__ = "Usable for any Linux project"
 
 # pyright: reportMissingTypeStubs=false
@@ -1118,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.5 → 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.5",
+    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",