muc.py

#!/usr/bin/env python
# -*- coding: utf-8 -*-

"""
    SleekXMPP: The Sleek XMPP Library
    Copyright (C) 2010  Nathanael C. Fritz
    This file is part of SleekXMPP.

    See the file LICENSE for copying permission.
"""

import sys
import traceback
import sleekxmpp


# Python versions before 3.0 do not use UTF-8 encoding
# by default. To ensure that Unicode is handled properly
# throughout SleekXMPP, we will set the default encoding
# ourselves to UTF-8.
if sys.version_info < (3, 0):
    from sleekxmpp.util.misc_ops import setdefaultencoding
    setdefaultencoding('utf8')
else:
    raw_input = input


class MUCBot(sleekxmpp.ClientXMPP):

    """
    A simple SleekXMPP bot that adds conference rooms.
    """

    def __init__(self, jid, password, room, nick):
        sleekxmpp.ClientXMPP.__init__(self, jid, password)

        self.room = room
        self.nick = nick

        # The session_start event will be triggered when
        # the bot establishes its connection with the server
        # and the XML streams are ready for use. We want to
        # listen for this event so that we we can initialize
        # our roster.
        self.add_event_handler("session_start", self.start)

        # The groupchat_message event is triggered whenever a message
        # stanza is received from any chat room. If you also also
        # register a handler for the 'message' event, MUC messages
        # will be processed by both handlers.
        self.add_event_handler("groupchat_message", self.muc_message)

        # The groupchat_presence event is triggered whenever a
        # presence stanza is received from any chat room, including
        # 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.
        self.add_event_handler("muc::%s::got_online" % self.room,
                               self.muc_online)


    def start(self, event):
        """
        Process the session_start event.

        Typical actions for the session_start event are
        requesting the roster and broadcasting an initial
        presence stanza.

        Arguments:
            event -- An empty dictionary. The session_start
                     event does not provide any additional
                     data.
        """
        self.get_roster()
        self.send_presence()
        self.plugin['xep_0045'].joinMUC(self.room,
                                        self.nick,
                                        # If a room password is needed, use:
                                        # password=the_room_password,
                                        wait=True)

    def muc_message(self, msg):
        """
        Process incoming message stanzas from any chat room. Be aware
        that if you also have any handlers for the 'message' event,
        message stanzas may be processed by both handlers, so check
        the 'type' attribute when using a 'message' event handler.

        Whenever the bot's nickname is mentioned, respond to
        the message.

        IMPORTANT: Always check that a message is not from yourself,
                   otherwise you will create an infinite loop responding
                   to your own messages.

        This handler will reply to messages that mention
        the bot's nickname.

        Arguments:
            msg -- The received message stanza. See the documentation
                   for stanza objects and the Message stanza to see
                   how it may be used.
        """
        if msg['mucnick'] != self.nick and self.nick in msg['body']:
            if msg['body'].startswith('!xbot'):
                ret = self.action_cmd(msg['body'], msg['mucnick'])
                self.send_message(mto=msg['from'].bare,
                                  mbody="-> %s." % ret,
                                  mtype='groupchat')


    def action_cmd(self, msg, user):
        #!xbot groupchat add [email protected] joel@localhost
        ret = None
        valid_cmds = ['groupchat']
        try:
            (_, cmd, args) = msg.split(' ', 2)
            cmd = cmd.strip()
            if cmd in valid_cmds:
                if cmd == 'groupchat':
                    ret = self.cmd_groupchat(args, user)
        except:
            ret =  str(( sys.exc_info(), traceback.print_tb(sys.exc_info()[2])))
            pass

        return ret

    def cmd_groupchat(self, args, user):

        valid_params = ['add', 'owner']
        (action, params) = args.split(' ', 1)

        '''
        ('muc#roomconfig_persistentroom',
         <field xmlns="jabber:x:data"
                var="muc#roomconfig_persistentroom"
                type="boolean"
                label="Make room persistent">
                <value>0</value></field>)
        '''

        if action == 'add' and params:
            (room, owner) = params.split()
            #1. join the requested muc
            self.plugin['xep_0045'].joinMUC(room, self.nick)

            #2. get the room config as a data form
            roomform = self.plugin['xep_0045'].getRoomConfig(room)

            #3. update the form to make the room persistent
            roomform.set_values({
                                 'muc#roomconfig_persistentroom': 1,
                                 'muc#roomconfig_roomdesc': 'Like WOAH!'})

            #4. submit the form
            self.plugin['xep_0045'].configureRoom(room, form=roomform)

            out = self.plugin['xep_0045'].setAffiliation( room,
                                                    jid="%s" % (owner),
                                                    affiliation='owner')

            self.plugin['xep_0045'].invite( room,
                                            owner,
                                            reason='Requested room created.')

            return str(out)

        else:
            return "groupchat add requires params - e.g [email protected] bar@localhost"

        return "cmd_groupchat - %s" % params



    def muc_online(self, presence):
        """
        Process a presence stanza from a chat room. In this case,
        presences from users that have just come online are
        handled by sending a welcome message that includes
        the user's nickname and role in the room.

        Arguments:
            presence -- The received presence stanza. See the
                        documentation for the Presence stanza
                        to see how else it may be used.
        """
        if presence['muc']['nick'] != self.nick:
            self.send_message(mto=presence['from'].bare,
                              mbody="Hello, %s %s" % (presence['muc']['role'],
                                                      presence['muc']['nick']),
                              mtype='groupchat')


if __name__ == '__main__':
    # Setup the MUCBot and register plugins. Note that while plugins may
    # have interdependencies, the order in which you register them does
    # not matter.
    xmpp = MUCBot('xbot@localhost', 'xbot', '[email protected]', 'xbot')
    xmpp.register_plugin('xep_0030') # Service Discovery
    xmpp.register_plugin('xep_0045') # Multi-User Chat
    xmpp.register_plugin('xep_0199') # XMPP Ping

    # Connect to the XMPP server and start processing XMPP stanzas.
    if xmpp.connect():
        # If you do not have the dnspython library installed, you will need
        # to manually specify the name of the server if it does not match
        # the one in the JID. For example, to use Google Talk you would
        # need to use:
        #
        # if xmpp.connect(('talk.google.com', 5222)):
        #     ...
        xmpp.process(block=True)
        print("Done")
    else:
        print("Unable to connect.")