1
# -*- coding: utf-8 -*-
3
# Copyright (C) 2006 Ali Sabil <ali.sabil@gmail.com>
5
# This program is free software; you can redistribute it and/or modify
6
# it under the terms of the GNU General Public License as published by
7
# the Free Software Foundation; either version 2 of the License, or
8
# (at your option) any later version.
10
# This program is distributed in the hope that it will be useful,
11
# but WITHOUT ANY WARRANTY; without even the implied warranty of
12
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13
# GNU General Public License for more details.
15
# You should have received a copy of the GNU General Public License
16
# along with this program; if not, write to the Free Software
17
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
20
"""pymsn event interfaces.
22
Defines the interfaces that the client can implement to benefit from the
23
client event notifications."""
25
from pymsn.util.weak import WeakSet
27
class EventsDispatcher(object):
28
"""Abstract object from which all the objects generating events inherit"""
31
self._events_handlers = WeakSet()
34
def register_events_handler(self, events_handler):
35
"""Registers an event handler with this dispatcher
36
@param events_handler: an instance with methods as code of callbacks
37
@type events_handler: L{pymsn.event.BaseEventInterface}
39
self._events_handlers.add(events_handler)
41
def _dispatch(self, name, *args):
43
for event_handler in list(self._events_handlers):
44
if event_handler._dispatch_event(name, *args):
49
class BaseEventInterface(object):
50
"""Event handler interface, implemented by all the event handlers"""
52
def __init__(self, client):
54
@param client: the client we want to be notified for its events
55
@type client: an object implementing L{EventsDispatcher}"""
56
self._client = weakref.proxy(client)
57
client.register_events_handler(self)
59
def _dispatch_event(self, event_name, *params):
61
handler = getattr(self, event_name)
69
from conversation import *
71
from address_book import *
72
from offline_messages import *