first commit

1 files changed, 134 insertions, 0 deletions

diff --git a/src/handler.py b/src/handler.py
new file mode 100644
index 00000000..b08280a0
--- /dev/null
+++ b/src/handler.py
@@ -0,0 +1,134 @@
+# -*- coding: utf-8 -*-
+
+# Copyright 2009, 2010 Erwan Briand
+# Copyright 2010, Florent Le Coz <louizatakk@fedoraproject.org>
+
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation version 3 of the License.
+
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+
+# You should have received a copy of the GNU General Public License
+# along with this program.  If not, see <http://www.gnu.org/licenses/>.
+
+from singleton import Singleton
+
+class Handler(Singleton):
+    """This class is the global handler for the software's signals."""
+    __is_first_instance = True
+
+    def __init__(self):
+        if Handler.__is_first_instance:
+            Handler.__is_first_instance = False
+
+            self.__signals__ = {
+                # - XMPP's core handlers (don't use outside of src/jabber/*.py)
+
+                'xmpp-presence-handler': list(),
+                # A presence is received
+                # Args: the stanza object
+
+                'xmpp-iq-handler': list(),
+                # An iq is received
+                # Args: the stanza object
+
+                'xmpp-message-handler': list(),
+                # A message is received
+                # Args: the stanza object
+
+                # - GUI event
+
+                'on-quit': list(),
+                # When the user wants to quit.
+
+                # - Roster and presence
+
+                'on-connected': list(),
+                # At the end of a successful connection process.
+
+                'on-disconnected': list(),
+                # When the user is disconnected from the server.
+
+                'on-message-received': list(),
+                # When a message is received.
+                # Args: jid, msg, subject, typ
+
+                'send-message': list(),
+                # Send a message to someone.
+                # Args: jid, msg, subj, typ
+
+                # - vCard (XEP-0054)
+
+                'vcard-request': list(),
+                # Request a vcard.
+                # Args: jid
+
+                'on-vcard-received': list(),
+                # When a vcard is received.
+                # Args: jid, vcard
+
+                # - Multi-User Chat (XEP-0045)
+
+                'gui-join-room': list(),
+                # Join a room inside the GUI (call `join-room`).
+                # Args: room, nickname
+
+                'join-room': list(),
+                # Join a room.
+                # Args: room, nick
+
+                'quit-room': list(),
+                # Quit a room.
+                # Args: room, nick
+
+                'on-muc-message-received': list(),
+                # When a message is received.
+                # Args: jid, msg, subject, typ, stanza
+
+                'on-muc-presence-changed': list(),
+                # When someone in the roster changes his presence.
+                # Args: jid, priority, show, status, stanza
+
+                'on-muc-error': list(),
+                # When the MUC composant sends an error
+                # Args: room, code, msg
+
+                'eject-user': list(),
+                # When the user try to eject another one.
+                # Args: room, action, nick, reason
+
+                'change-user-role': list(),
+                # When the user try to change the role of someone.
+                # Args: room, nick, role
+
+                'change-user-affiliation': list(),
+                # When the user try to change the affiliation of someone.
+                # Args: room, jid, aff
+
+                'change-subject': list(),
+                # When the user try to change the topic.
+                # Args: room, subject
+
+                'change-nick': list()
+                # When the user try to change his nick.
+                # Args: room, nick
+            }
+
+    def connect(self, signal, func):
+        """Connect a function to a signal."""
+        if func not in self.__signals__[signal]:
+            self.__signals__[signal].append(func)
+        else:
+            print "%s doesn't exist." % signal
+
+    def emit(self, signal, **kwargs):
+        """Emit a signal."""
+        if self.__signals__.has_key(signal):
+            for func in self.__signals__[signal]:
+                func(**kwargs)
+        else:
+            print "%s doesn't exist." % signal