Files
meshcore-bot/modules/commands/ping_command.py
agessaman cc3fffeb54 feat: Add command enable/disable configuration for various commands
- Implemented a configuration option for enabling or disabling commands across multiple command classes.
- Each command now checks its enabled state before execution, improving control over command availability.
- Updated the configuration loading mechanism to retrieve the enabled state from the config file for commands like Advert, AQI, Catfact, and others.
2026-01-10 09:33:15 -08:00

76 lines
2.3 KiB
Python

#!/usr/bin/env python3
"""
Ping command for the MeshCore Bot
Handles the 'ping' keyword response
"""
from typing import Optional
from .base_command import BaseCommand
from ..models import MeshMessage
class PingCommand(BaseCommand):
"""Handles the ping command.
A simple diagnostic command that responds with 'Pong!' or a custom configured response
to verify bot connectivity and responsiveness.
"""
# Plugin metadata
name = "ping"
keywords = ['ping']
description = "Responds to 'ping' with 'Pong!'"
category = "basic"
def __init__(self, bot):
"""Initialize the ping command.
Args:
bot: The bot instance.
"""
super().__init__(bot)
self.ping_enabled = self.get_config_value('Ping_Command', 'enabled', fallback=True, value_type='bool')
def can_execute(self, message: MeshMessage) -> bool:
"""Check if this command can be executed with the given message.
Args:
message: The message triggering the command.
Returns:
bool: True if command is enabled and checks pass, False otherwise.
"""
if not self.ping_enabled:
return False
return super().can_execute(message)
def get_help_text(self) -> str:
"""Get help text for the ping command.
Returns:
str: The help text for this command.
"""
return self.translate('commands.ping.description')
def get_response_format(self) -> Optional[str]:
"""Get the response format from config.
Returns:
Optional[str]: The format string for the response, or None if not configured.
"""
if self.bot.config.has_section('Keywords'):
format_str = self.bot.config.get('Keywords', 'ping', fallback=None)
return self._strip_quotes_from_config(format_str) if format_str else None
return None
async def execute(self, message: MeshMessage) -> bool:
"""Execute the ping command.
Args:
message: The message that triggered the command.
Returns:
bool: True if the response was sent successfully, False otherwise.
"""
return await self.handle_keyword_match(message)