feat(ping): add owner-only ping handler for debug checks

- Introduced a new handler to respond to owner pings with debug information, including bot status and uptime.
- Updated main application initialization to include the new ping handler.
- Added a response string for the ping command, providing relevant bot and environment details.

Author: MattiaFailla

src/python_italy_bot/handlers/ping.py

@@ -0,0 +1,55 @@
+"""Handler for owner-only ping/debug check."""
+
+import logging
+import sys
+from datetime import datetime, timezone
+
+from telegram import Update
+from telegram.ext import ContextTypes, MessageHandler, filters
+
+from .. import strings
+from ..config import Settings
+
+logger = logging.getLogger(__name__)
+
+
+async def _handle_ping(
+    update: Update,
+    context: ContextTypes.DEFAULT_TYPE,
+    settings: Settings,
+) -> None:
+    """Respond to owner ping with debug info."""
+    message = update.effective_message
+    user = update.effective_user
+
+    if not message or not user:
+        return
+
+    if settings.bot_owner_id is None or user.id != settings.bot_owner_id:
+        return
+
+    bot_info = await context.bot.get_me()
+    uptime_info = datetime.now(timezone.utc).isoformat()
+
+    debug_msg = strings.PING_RESPONSE.format(
+        bot_username=bot_info.username,
+        python_version=sys.version.split()[0],
+        timestamp=uptime_info,
+    )
+    await message.reply_text(debug_msg)
+
+
+def create_ping_handlers(settings: Settings) -> list[MessageHandler]:
+    """Create handlers for owner ping check."""
+
+    async def ping_wrapper(
+        update: Update, context: ContextTypes.DEFAULT_TYPE
+    ) -> None:
+        await _handle_ping(update, context, settings)
+
+    return [
+        MessageHandler(
+            filters.Regex(r"(?i)^electus ci sei\?$") & filters.TEXT,
+            ping_wrapper,
+        )
+    ]

src/python_italy_bot/main.py

@@ -9,6 +9,7 @@
 from .handlers.announce import create_announce_handlers
 from .handlers.id import create_id_handlers
 from .handlers.moderation import create_moderation_handlers
+from .handlers.ping import create_ping_handlers
 from .handlers.settings import create_settings_handlers
 from .handlers.spam import create_spam_handler
 from .handlers.welcome import create_welcome_handlers
@@ -52,6 +53,8 @@ async def _post_init(application) -> None:
         application.add_handler(handler)
     for handler in create_announce_handlers(moderation_service, settings):
         application.add_handler(handler)
+    for handler in create_ping_handlers(settings):
+        application.add_handler(handler)
     application.add_handler(create_spam_handler(spam_detector))
 
 

src/python_italy_bot/strings.py

@@ -156,3 +156,15 @@ def mute_success(duration: int | None, reason: str | None) -> str:
 def announce_result(success: int, failed: int) -> str:
     """Format announcement result message."""
     return f"Annuncio inviato: {success} ok, {failed} falliti."
+
+
+# =============================================================================
+# PING (Owner Debug)
+# =============================================================================
+
+PING_RESPONSE = (
+    "Sono online.\n\n"
+    "Bot: @{bot_username}\n"
+    "Python: {python_version}\n"
+    "Timestamp: {timestamp}"
+)