from .plugin import Plugin, botcmd
+
class Echo(Plugin):
- """Drop a message to be sent when someone gets online.
+ """Drops a message to be sent when someone gets online.
"""
def __init__(self, bot):
# any presences you send yourself. To limit event handling
# to a single room, use the events muc::room@server::presence,
# muc::room@server::got_online, or muc::room@server::got_offline.
- bot.add_event_handler("muc::%s::presence" % self.bot.room, self.log_presence)
+ bot.add_event_handler("muc::%s::presence" %
+ self.bot.room, self.log_presence)
def log_presence(self, pres):
- """Register presence"""
+ """Handler method registering MUC participants presence"""
self.log.debug('%s: %s', pres['muc']['nick'], pres['type'])
nick = pres['muc']['nick']
self.presence.update({nick: (pres['muc']['role'], pres['type'])})
@botcmd
def tell(self, message, args):
- """drop a message to be sent when someone gets online.
- !tell queue : messages in queue
- !tell <nick> <msg> : append <msg> to <nick> in queue"""
+ """
+ **commands**:
+
+ * ``!tell queue`` : messages in queue
+ * ``!tell <nick> <msg>`` : append <msg> to <nick> in queue"""
if not len(args):
msg = 'Missing arguments:\n{}'.format(self.tell.__doc__)
self.reply(message, msg)