~ubuntu-branches/ubuntu/hardy/emesene/hardy-backports

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
# -*- coding: utf-8 -*-
'''a module to handle groups'''

#   This file is part of emesene.
#
#    Emesene 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; either version 2 of the License, or
#    (at your option) any later version.
#
#    emesene 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 emesene; if not, write to the Free Software
#    Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA

import abstract.GroupManager

class GroupManager(abstract.GroupManager.GroupManager):
    '''implementation of asbtract.GroupManager.GroupManager
    using emesenelib'''

    def __init__(self, dialog, protocol):
        '''initialize the object, dialog is a implementation
        of abstract.dialog, it's used to interact with the user'''
        abstract.GroupManager.GroupManager.__init__(self, 
            dialog, protocol)

        if protocol:
            self._connect_signals()
        else:
            debug('Protocol is None')

    def _connect_signals(self):
        '''connect the protocol signals'''
        # connect the signals to the private methods, and call
        # the methods on the abstract class with the correct
        # attributes (see the __ on the methods)
        self.protocol.connect('group-added', self.__on_group_added)
        self.protocol.connect('group-removed', self.__on_group_removed)
        self.protocol.connect('group-renamed', self.__on_group_renamed)

        self.protocol.connect('contact-added-to-group', 
            self.__on_contact_added_to_group)
        self.protocol.connect('contact-removed-from-group', 
            self.__on_contact_removed_from_group)

    def __on_group_added(self, protocol, name, identifier):
        '''method called when a new group is created'''
        self._on_group_added(name, identifier)

    def __on_group_removed(self, protocol, name):
        '''method called when a group is removed'''
        self._on_group_removed(name)

    def __on_group_renamed(self, protocol, old_name, new_name):
        '''method called when the name of the group is changed'''
        self._on_group_renamed(old_name, new_name)

    def __on_contact_added_to_group(self, protocol, account, group_name):
        '''callback called when an account is added to a group'''
        self._on_contact_added_to_group(account, group_name)
            
    def __on_contact_removed_from_group(self, protocol, account, group_name):
        '''callback called when an account is removed from a group'''
        self._on_contact_removed_from_group(account, group_name)

    # public API

    def add(self, name):
        '''add a group'''
        if name:
            if self.protocol:
                self.protocol.addGroup(name)
        else:
            debug("invalid group name '%s'" % (name,))

    def rename(self, name, new_name):
        '''rename a group'''
        if new_name and name != new_name:
            if self.protocol:
                self.protocol.renameGroup(name, new_name)
        else:
            debug("invalid group name '%s'" % (new_name,))

    def remove(self, name):
        '''remove a group'''
        if self.protocol:
            self.protocol.removeGroup(name)

def debug(msg):
    '''debug method, the module send the debug here, it can be changed
    to use another debugging method'''
    return
    print('ContactManager.py: ', msg)