.. _fbf.plugs.core.remotecallbacks:

remotecallbacks
~~~~~~~~~~~~~~~

.. automodule:: fbf.plugs.core.remotecallbacks
        :show-inheritance:
        :members:
        :undoc-members:

CODE
----

    ::

        # fbf/plugs/core/remotecallbacks.py
        #
        #
        
        """ dispatch remote events. """
        
.. _fbf.plugs.core.remotecallbacks_fbf_imports:

fbf imports
--------------

    ::

        
        from fbf.utils.lazydict import LazyDict
        from fbf.utils.generic import fromenc
        from fbf.utils.exception import handle_exception
        from fbf.lib.callbacks import callbacks, remote_callbacks, first_callbacks
        from fbf.lib.container import Container
        from fbf.lib.eventbase import EventBase
        from fbf.lib.errors import NoProperDigest
        from fbf.lib.commands import cmnds
        from fbf.lib.examples import examples
        
.. _fbf.plugs.core.remotecallbacks_basic_imports:

basic imports
----------------

    ::

        
        import logging
        import copy
        import hmac
        import hashlib
        import cgi
        import xml
        
.. _fbf.plugs.core.remotecallbacks_defines_:

defines
----------

    ::

        
        XMLunescape = xml.sax.saxutils.unescape
        
        cpy = copy.deepcopy
        
.. _fbf.plugs.core.remotecallbacks_callback_:

callback
-----------

    ::

        
        def remotecb(bot, event):
            """ dispatch an event. """
            try: container = Container().load(event.txt)
            except TypeError:
                handle_exception()
                logging.warn("remotecallbacks - not a remote event - %s " % event.userhost)
                return
            logging.debug('doing REMOTE callback')
            try:
                digest = hmac.new(bytes(container.hashkey, "utf-8"), bytes(XMLunescape(container.payload), "utf-8"), hashlib.sha512).hexdigest()
                logging.debug("remotecallbacks - digest is %s" % digest)
            except TypeError:
                handle_exception()
                logging.error("remotecallbacks - can't load payload - %s" % container.payload)
                return
            if container.digest == digest: e = EventBase().load(XMLunescape(container.payload))
            else: raise NoProperDigest()
            e.txt = XMLunescape(e.txt)
            e.nodispatch = True
            e.forwarded = True
            e.dontbind = True
            bot.doevent(e)
            event.status = "done"  
            return
        
        remote_callbacks.add("MESSAGE", remotecb)