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
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
|
# -*- 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 gettext
import stock
import Object
_ = gettext.gettext
class GroupManager(Object.Object):
'''this class represent an abstract class that provide methods
to interact with groups, implementing this class with the
undeliying protocol library let the upper layer use the services
of the protocol implementation independently of the api, in this
way, the protocol library can be modified (or replaced)
without effect on the clients'''
def __init__(self, dialog, protocol):
'''initialize the object, dialog is a implementation
of abstract.dialog, it's used to interact with the user'''
Object.Object.__init__(self)
self.dialog = dialog
self.protocol = protocol
self.groups = {}
# emitted when some attribute of the group changes
# the first argument is the group object, the second
# is a string representing the attribute that changed
# the third is the old value of the attr
self.signal_add('group-changed', 3)
self.signal_add('group-name-changed', 2)
self.signal_add('group-added', 1)
self.signal_add('group-removed', 1)
# contact account (not the object), group
self.signal_add('contact-added-to-group', 2)
# contact account (not the object), group
self.signal_add('contact-removed-from-group', 2)
def register(self, group):
'''add a group object to the list'''
if not self.exists(group.name):
self.groups[group.name] = group
else:
debug("group %s already in groups" % (group.name,))
# utility methods
def exists(self, group_name):
'''check if the group is on self.groups, return True if exists'''
if group_name in self.groups:
return True
else:
return False
# this are the base callbacks, you should inherit from this class
# and make methods to be notified on this events and then call this
# methods, they do all the work, you just need to addapt the parameters
def _on_group_added(self, name, identifier=None, contacts=None):
'''method called when a new group is created'''
if self.exists(name):
debug("group %s already in groups" % (name,))
else:
group = Group(name, identifier, contacts)
self.groups[name] = group
self.signal_emit('group-added', group)
def _on_group_removed(self, name):
'''method called when a group is removed'''
if self.exists(name):
group = self.groups[name]
del self.groups[name]
self.signal_emit('group-removed', group)
else:
debug("group %s not in groups" % (name,))
def _on_group_renamed(self, old_name, new_name):
'''method called when the name of the group is changed'''
if self.exists(old_name):
group = self.groups[old_name]
group.name = new_name
self.groups[group.name] = group
self.signal_emit('group-name-changed', group, old_name)
self.signal_emit('group-changed', group, 'name', old_name)
else:
debug("group %s not in groups" % (old_name,))
def _on_contact_added_to_group(self, account, group_name):
'''callback called when an account is added to a group'''
if self.exists(group_name):
if account not in self.groups[group_name].contacts:
self.groups[group_name].contacts.append(account)
self.signal_emit('contact-added-to-group',
account, self.groups[group_name])
else:
debug("account %s already in group %s" % (account,
group_name))
else:
debug("group %s not in self.groups" % (group_name,))
def _on_contact_removed_from_group(self, account, group_name):
'''callback called when an account is removed from a group'''
if self.exists(group_name):
if account in self.groups[group_name].contacts:
self.groups[group_name].contacts.remove(account)
self.signal_emit('contact-removed-from-group',
account, self.groups[group_name])
else:
debug("account %s not in group %s" % (account,
group_name))
else:
debug("group %s not in self.groups" % (group_name,))
# protocol actions on groups
def add(self, name):
'''add a group'''
pass
def rename(self, name, new_name):
'''rename a group'''
pass
def remove(self, name):
'''remove a group'''
pass
# dialog
def add_dialog(self):
'''show a dialog to add a group'''
self.dialog.add_group(self.add_cb)
def rename_dialog(self, old_name):
'''show a dialog showing the actual name of a group
and asking for the new one'''
self.dialog.rename_group(old_name, self.rename_cb)
def remove_dialog(self, name):
'''ask for confirmation on group deletion, it can be used the method
directly, but it's good to ask :P'''
self.dialog.yes_no(_(
_("Are you sure you want to delete the %s group?") % (name, )),
self.remove_cb, name)
# callbacks (the values are set to '' because when the window get closed
# presing the x the values should not be sent)
def add_cb(self, response, group_name=''):
'''callback for the dialog.add_group method'''
if response == stock.ACCEPT:
if group_name:
self.add(group_name)
def rename_cb(self, response, old_name='', new_name=''):
'''callback called by dialog.rename_group'''
if response == stock.ACCEPT:
if old_name == new_name:
self.dialog.warning(_("Old and new name are the same"))
elif new_name:
self.rename(old_name, new_name)
else:
self.dialog.warning(_("new name not valid"))
def remove_cb(self, response, group_name=''):
'''callback for the dialog.yes_no method, asking for
confirmation un group delete'''
if response == stock.YES:
self.remove(group_name)
class Group(object):
'''a class representing a group'''
def __init__(self, name, identifier=None, contacts=None):
'''class constructor'''
self.name = name
self.identifier = identifier or '0'
self.contacts = contacts or []
def _on_contact_added(self, account):
'''callback called when a contact is added to this group'''
self.contacts.append(account)
def _on_contact_removed(self, account):
'''callback called when a contact is removed from this group'''
if account in self.contacts:
del self.contacts[account]
def __repr__(self):
'''return a string representation of the object'''
return "<group name='%s'>" % (self.name,)
def debug(msg):
'''debug method, the module send the debug here, it can be changed
to use another debugging method'''
return
print('GroupManager.py: ', msg)
|
