Mercurial > libervia-backend
annotate src/plugins/plugin_misc_invitations.py @ 2228:cf6c539672c7
tools (common/data_objects): comments items can now be chained to their parent
| author | Goffi <goffi@goffi.org> |
|---|---|
| date | Mon, 17 Apr 2017 20:34:43 +0200 |
| parents | c6c9a97ffebf |
| children | ebc0c1701811 |
| rev | line source |
|---|---|
| 2184 | 1 #!/usr/bin/env python2 |
| 2 # -*- coding: utf-8 -*- | |
| 3 | |
| 4 # SAT plugin for file tansfer | |
| 5 # Copyright (C) 2009-2016 Jérôme Poisson (goffi@goffi.org) | |
| 6 | |
| 7 # This program is free software: you can redistribute it and/or modify | |
| 8 # it under the terms of the GNU Affero General Public License as published by | |
| 9 # the Free Software Foundation, either version 3 of the License, or | |
| 10 # (at your option) any later version. | |
| 11 | |
| 12 # This program is distributed in the hope that it will be useful, | |
| 13 # but WITHOUT ANY WARRANTY; without even the implied warranty of | |
| 14 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
| 15 # GNU Affero General Public License for more details. | |
| 16 | |
| 17 # You should have received a copy of the GNU Affero General Public License | |
| 18 # along with this program. If not, see <http://www.gnu.org/licenses/>. | |
| 19 | |
| 20 from sat.core.i18n import _, D_ | |
| 21 from sat.core.constants import Const as C | |
| 22 from sat.core import exceptions | |
| 23 from sat.core.log import getLogger | |
| 24 log = getLogger(__name__) | |
| 25 import shortuuid | |
| 26 from sat.tools import utils | |
| 27 from twisted.internet import defer | |
| 28 from twisted.words.protocols.jabber import jid | |
| 29 from twisted.words.protocols.jabber import error | |
| 30 from sat.memory import persistent | |
| 31 from sat.tools import email as sat_email | |
| 32 | |
| 33 | |
| 34 PLUGIN_INFO = { | |
| 35 C.PI_NAME: "Invitations", | |
| 36 C.PI_IMPORT_NAME: "INVITATIONS", | |
| 37 C.PI_TYPE: C.PLUG_TYPE_MISC, | |
| 38 C.PI_DEPENDENCIES: ['XEP-0077'], | |
| 39 C.PI_MAIN: "InvitationsPlugin", | |
| 40 C.PI_HANDLER: "no", | |
| 41 C.PI_DESCRIPTION: _(u"""invitation of people without XMPP account""") | |
| 42 } | |
| 43 | |
| 44 | |
| 45 SUFFIX_MAX = 5 | |
| 46 INVITEE_PROFILE_TPL = u"guest@@{uuid}" | |
|
2211
df115e4a36c7
plugin invitations: invitation id and invitee jid are now added to return dict in invitationCreate, bridge signature has changed too
Goffi <goffi@goffi.org>
parents:
2210
diff
changeset
|
47 KEY_ID = u'id' |
|
df115e4a36c7
plugin invitations: invitation id and invitee jid are now added to return dict in invitationCreate, bridge signature has changed too
Goffi <goffi@goffi.org>
parents:
2210
diff
changeset
|
48 KEY_JID = u'jid' |
| 2184 | 49 KEY_CREATED = u'created' |
| 50 KEY_LAST_CONNECTION = u'last_connection' | |
|
2219
77a3d0a28642
plugin invitations: added modify method (+ bridge) and fixed email setting in extra
Goffi <goffi@goffi.org>
parents:
2212
diff
changeset
|
51 KEY_GUEST_PROFILE = u'guest_profile' |
|
77a3d0a28642
plugin invitations: added modify method (+ bridge) and fixed email setting in extra
Goffi <goffi@goffi.org>
parents:
2212
diff
changeset
|
52 KEY_PASSWORD = u'password' |
|
77a3d0a28642
plugin invitations: added modify method (+ bridge) and fixed email setting in extra
Goffi <goffi@goffi.org>
parents:
2212
diff
changeset
|
53 EXTRA_RESERVED = {KEY_ID, KEY_JID, KEY_CREATED, u'jid_', u'jid', KEY_LAST_CONNECTION, KEY_GUEST_PROFILE, KEY_PASSWORD} |
| 2184 | 54 DEFAULT_SUBJECT = D_(u"You have been invited by {host_name} to {app_name}") |
| 55 DEFAULT_BODY = D_(u"""Hello {name}! | |
| 56 | |
| 57 You have received an invitation from {host_name} to participate to "{app_name}". | |
| 58 To join, you just have to click on the following URL: | |
| 59 {url} | |
| 60 | |
| 61 Please note that this URL should not be shared with anybody! | |
| 62 If you want more details on {app_name}, you can check {app_url}. | |
| 63 | |
| 64 Welcome! | |
| 65 """) | |
| 66 | |
| 67 | |
| 68 class InvitationsPlugin(object): | |
| 69 | |
| 70 def __init__(self, host): | |
| 71 log.info(_(u"plugin Invitations initialization")) | |
| 72 self.host = host | |
| 73 self.invitations = persistent.LazyPersistentBinaryDict(u'invitations') | |
|
2211
df115e4a36c7
plugin invitations: invitation id and invitee jid are now added to return dict in invitationCreate, bridge signature has changed too
Goffi <goffi@goffi.org>
parents:
2210
diff
changeset
|
74 host.bridge.addMethod("invitationCreate", ".plugin", in_sign='sssssssssa{ss}s', out_sign='a{ss}', |
|
2219
77a3d0a28642
plugin invitations: added modify method (+ bridge) and fixed email setting in extra
Goffi <goffi@goffi.org>
parents:
2212
diff
changeset
|
75 method=self._create, |
| 2184 | 76 async=True) |
|
2212
eaf2467d19ce
plugin invitations: added getInvitation method, it return invitation data and raise an error if it is not found
Goffi <goffi@goffi.org>
parents:
2211
diff
changeset
|
77 host.bridge.addMethod("invitationGet", ".plugin", in_sign='s', out_sign='a{ss}', |
|
2219
77a3d0a28642
plugin invitations: added modify method (+ bridge) and fixed email setting in extra
Goffi <goffi@goffi.org>
parents:
2212
diff
changeset
|
78 method=self.get, |
|
77a3d0a28642
plugin invitations: added modify method (+ bridge) and fixed email setting in extra
Goffi <goffi@goffi.org>
parents:
2212
diff
changeset
|
79 async=True) |
|
77a3d0a28642
plugin invitations: added modify method (+ bridge) and fixed email setting in extra
Goffi <goffi@goffi.org>
parents:
2212
diff
changeset
|
80 host.bridge.addMethod("invitationModify", ".plugin", in_sign='sa{ss}b', out_sign='', |
|
77a3d0a28642
plugin invitations: added modify method (+ bridge) and fixed email setting in extra
Goffi <goffi@goffi.org>
parents:
2212
diff
changeset
|
81 method=self._modify, |
|
2212
eaf2467d19ce
plugin invitations: added getInvitation method, it return invitation data and raise an error if it is not found
Goffi <goffi@goffi.org>
parents:
2211
diff
changeset
|
82 async=True) |
|
eaf2467d19ce
plugin invitations: added getInvitation method, it return invitation data and raise an error if it is not found
Goffi <goffi@goffi.org>
parents:
2211
diff
changeset
|
83 |
|
2219
77a3d0a28642
plugin invitations: added modify method (+ bridge) and fixed email setting in extra
Goffi <goffi@goffi.org>
parents:
2212
diff
changeset
|
84 def checkExtra(self, extra): |
|
77a3d0a28642
plugin invitations: added modify method (+ bridge) and fixed email setting in extra
Goffi <goffi@goffi.org>
parents:
2212
diff
changeset
|
85 if EXTRA_RESERVED.intersection(extra): |
|
77a3d0a28642
plugin invitations: added modify method (+ bridge) and fixed email setting in extra
Goffi <goffi@goffi.org>
parents:
2212
diff
changeset
|
86 raise ValueError(_(u"You can't use following key(s) in extra, they are reserved: {}").format( |
|
77a3d0a28642
plugin invitations: added modify method (+ bridge) and fixed email setting in extra
Goffi <goffi@goffi.org>
parents:
2212
diff
changeset
|
87 u', '.join(EXTRA_RESERVED.intersection(extra)))) |
|
77a3d0a28642
plugin invitations: added modify method (+ bridge) and fixed email setting in extra
Goffi <goffi@goffi.org>
parents:
2212
diff
changeset
|
88 |
|
77a3d0a28642
plugin invitations: added modify method (+ bridge) and fixed email setting in extra
Goffi <goffi@goffi.org>
parents:
2212
diff
changeset
|
89 def _create(self, jid_=u'', password=u'', name=u'', host_name=u'', email=u'', language=u'', url_template=u'', message_subject=u'', message_body=u'', extra=None, profile=u''): |
| 2184 | 90 # XXX: we don't use **kwargs here to keep arguments name for introspection with D-Bus bridge |
| 91 | |
| 92 if extra is None: | |
| 93 extra = {} | |
| 94 else: | |
| 95 extra = {unicode(k): unicode(v) for k,v in extra.iteritems()} | |
| 96 | |
| 97 # we need to be sure that values are unicode, else they won't be pickled correctly with D-Bus | |
| 98 kwargs = {"extra": extra} | |
| 99 for key in ("jid_", "password", "name", "host_name", "email", "language", "url_template", "message_subject", "message_body", "profile"): | |
| 100 value = locals()[key] | |
| 101 if value: | |
| 102 kwargs[key] = unicode(value) | |
|
2219
77a3d0a28642
plugin invitations: added modify method (+ bridge) and fixed email setting in extra
Goffi <goffi@goffi.org>
parents:
2212
diff
changeset
|
103 d = self.create(**kwargs) |
|
2211
df115e4a36c7
plugin invitations: invitation id and invitee jid are now added to return dict in invitationCreate, bridge signature has changed too
Goffi <goffi@goffi.org>
parents:
2210
diff
changeset
|
104 def serialize(data): |
|
df115e4a36c7
plugin invitations: invitation id and invitee jid are now added to return dict in invitationCreate, bridge signature has changed too
Goffi <goffi@goffi.org>
parents:
2210
diff
changeset
|
105 data[KEY_JID] = data[KEY_JID].full() |
|
df115e4a36c7
plugin invitations: invitation id and invitee jid are now added to return dict in invitationCreate, bridge signature has changed too
Goffi <goffi@goffi.org>
parents:
2210
diff
changeset
|
106 d.addCallback(serialize) |
|
df115e4a36c7
plugin invitations: invitation id and invitee jid are now added to return dict in invitationCreate, bridge signature has changed too
Goffi <goffi@goffi.org>
parents:
2210
diff
changeset
|
107 return d |
| 2184 | 108 |
| 109 @defer.inlineCallbacks | |
|
2219
77a3d0a28642
plugin invitations: added modify method (+ bridge) and fixed email setting in extra
Goffi <goffi@goffi.org>
parents:
2212
diff
changeset
|
110 def create(self, **kwargs): |
| 2184 | 111 ur"""create an invitation |
| 112 | |
| 113 this will create an XMPP account and a profile, and use a UUID to retrieve them. | |
| 114 the profile is automatically generated in the form guest@@[UUID], this way they can be retrieved easily | |
| 115 **kwargs: keywords arguments which can have the following keys, unset values are equivalent to None: | |
| 116 jid_(jid.JID, None): jid to use for invitation, the jid will be created using XEP-0077 | |
| 117 if the jid has no user part, an anonymous account will be used (no XMPP account created in this case) | |
|
2208
c316c6f6a737
plugin invitations: fixed leak of uuid in jid
Goffi <goffi@goffi.org>
parents:
2185
diff
changeset
|
118 if None, automatically generate an account name (in the form "invitation-[random UUID]@domain.tld") (note that this UUID is not the |
|
c316c6f6a737
plugin invitations: fixed leak of uuid in jid
Goffi <goffi@goffi.org>
parents:
2185
diff
changeset
|
119 same as the invitation one, as jid can be used publicly (leaking the UUID), and invitation UUID give access to account. |
| 2184 | 120 in case of conflict, a suffix number is added to the account until a free one if found (with a failure if SUFFIX_MAX is reached) |
| 121 password(unicode, None): password to use (will be used for XMPP account and profile) | |
| 122 None to automatically generate one | |
| 123 name(unicode, None): name of the invitee | |
| 124 host_name(unicode, None): name of the host | |
| 125 email(unicode, None): email to send the invitation to | |
| 126 if None, no invitation email is sent, you can still associate email using extra | |
| 127 if email is used, extra can't have "email" key | |
| 128 language(unicode): language of the invitee (used notabily to translate the invitation) | |
| 129 TODO: not used yet | |
| 130 url_template(unicode, None): template to use to construct the invitation URL | |
| 131 use {uuid} as a placeholder for identifier | |
| 132 use None if you don't want to include URL (or if it is already specified in custom message) | |
| 133 /!\ you must put full URL, don't forget https:// | |
| 134 /!\ the URL will give access to the invitee account, you should warn in message to not publish it publicly | |
|
2210
f8d61592f1fc
plugin invitations: raise ValueError if url_template and message_body are both not specified
Goffi <goffi@goffi.org>
parents:
2208
diff
changeset
|
135 message_subject(unicode, None): customised message body for the invitation email |
| 2184 | 136 None to use default subject |
| 137 uses the same substitution as for message_body | |
| 138 message_body(unicode, None): customised message body for the invitation email | |
| 139 None to use default body | |
| 140 use {name} as a place holder for invitee name | |
| 141 use {url} as a placeholder for the invitation url | |
| 142 use {uuid} as a placeholder for the identifier | |
| 143 use {app_name} as a placeholder for this software name | |
| 144 use {app_url} as a placeholder for this software official website | |
| 145 use {profile} as a placeholder for host's profile | |
| 146 use {host_name} as a placeholder for host's name | |
| 147 extra(dict, None): extra data to associate with the invitee | |
| 148 some keys are reserved: | |
| 149 - created (creation date) | |
| 150 if email argument is used, "email" key can't be used | |
| 151 profile(unicode, None): profile of the host (person who is inviting) | |
|
2211
df115e4a36c7
plugin invitations: invitation id and invitee jid are now added to return dict in invitationCreate, bridge signature has changed too
Goffi <goffi@goffi.org>
parents:
2210
diff
changeset
|
152 @return (dict[unicode, unicode]): dictionary with: |
|
df115e4a36c7
plugin invitations: invitation id and invitee jid are now added to return dict in invitationCreate, bridge signature has changed too
Goffi <goffi@goffi.org>
parents:
2210
diff
changeset
|
153 - UUID associated with the invitee (key: id) |
| 2184 | 154 - filled extra dictionary, as saved in the databae |
| 155 """ | |
| 156 ## initial checks | |
| 157 extra = kwargs.pop('extra', {}) | |
| 158 if set(kwargs).intersection(extra): | |
|
2219
77a3d0a28642
plugin invitations: added modify method (+ bridge) and fixed email setting in extra
Goffi <goffi@goffi.org>
parents:
2212
diff
changeset
|
159 raise ValueError(_(u"You can't use following key(s) in both args and extra: {}").format( |
| 2184 | 160 u', '.join(set(kwargs).intersection(extra)))) |
| 161 | |
|
2219
77a3d0a28642
plugin invitations: added modify method (+ bridge) and fixed email setting in extra
Goffi <goffi@goffi.org>
parents:
2212
diff
changeset
|
162 self.checkExtra(extra) |
| 2184 | 163 |
|
2223
c6c9a97ffebf
plugin invitations: fixed url_template check
Goffi <goffi@goffi.org>
parents:
2219
diff
changeset
|
164 if not 'url_template' in kwargs and not 'message_body' in kwargs: |
|
2210
f8d61592f1fc
plugin invitations: raise ValueError if url_template and message_body are both not specified
Goffi <goffi@goffi.org>
parents:
2208
diff
changeset
|
165 raise ValueError(_(u"You need to provide url_template if you use default message body")) |
|
f8d61592f1fc
plugin invitations: raise ValueError if url_template and message_body are both not specified
Goffi <goffi@goffi.org>
parents:
2208
diff
changeset
|
166 |
|
f8d61592f1fc
plugin invitations: raise ValueError if url_template and message_body are both not specified
Goffi <goffi@goffi.org>
parents:
2208
diff
changeset
|
167 |
| 2184 | 168 ## uuid |
| 169 log.info(_(u"creating an invitation")) | |
| 170 id_ = unicode(shortuuid.uuid()) | |
| 171 | |
| 172 ## XMPP account creation | |
| 173 password = kwargs.pop(u'password', None) | |
| 174 if password is None: | |
| 175 password = utils.generatePassword() | |
| 176 assert password | |
| 177 # XXX: password is here saved in clear in database | |
| 178 # it is needed for invitation as the same password is used for profile | |
| 179 # and SàT need to be able to automatically open the profile with the uuid | |
| 180 # FIXME: we could add an extra encryption key which would be used with the uuid | |
| 181 # when the invitee is connecting (e.g. with URL). This key would not be saved | |
| 182 # and could be used to encrypt profile password. | |
|
2219
77a3d0a28642
plugin invitations: added modify method (+ bridge) and fixed email setting in extra
Goffi <goffi@goffi.org>
parents:
2212
diff
changeset
|
183 extra[KEY_PASSWORD] = password |
| 2184 | 184 |
| 185 jid_ = kwargs.pop(u'jid_', None) | |
| 186 if not jid_: | |
| 187 domain = self.host.memory.getConfig(None, 'xmpp_domain') | |
| 188 if not domain: | |
| 189 # TODO: fallback to profile's domain | |
| 190 raise ValueError(_(u"You need to specify xmpp_domain in sat.conf")) | |
|
2208
c316c6f6a737
plugin invitations: fixed leak of uuid in jid
Goffi <goffi@goffi.org>
parents:
2185
diff
changeset
|
191 jid_ = u"invitation-{uuid}@{domain}".format(uuid=shortuuid.uuid(), domain=domain) |
| 2184 | 192 jid_ = jid.JID(jid_) |
| 193 if jid_.user: | |
| 194 # we don't register account if there is no user as anonymous login is then used | |
| 195 try: | |
| 196 yield self.host.plugins['XEP-0077'].registerNewAccount(jid_, password) | |
| 197 except error.StanzaError as e: | |
| 198 prefix = jid_.user | |
| 199 idx = 0 | |
| 200 while e.condition == u'conflict': | |
| 201 if idx >= SUFFIX_MAX: | |
| 202 raise exceptions.ConflictError(_(u"Can't create XMPP account")) | |
| 203 jid_.user = prefix + '_' + unicode(idx) | |
| 204 log.info(_(u"requested jid already exists, trying with {}".format(jid_.full()))) | |
| 205 try: | |
| 206 yield self.host.plugins['XEP-0077'].registerNewAccount(jid_, password) | |
| 207 except error.StanzaError as e: | |
| 208 idx += 1 | |
| 209 else: | |
| 210 break | |
| 211 if e.condition != u'conflict': | |
| 212 raise e | |
| 213 | |
| 214 log.info(_(u"account {jid_} created").format(jid_=jid_.full())) | |
| 215 | |
| 216 ## profile creation | |
|
2219
77a3d0a28642
plugin invitations: added modify method (+ bridge) and fixed email setting in extra
Goffi <goffi@goffi.org>
parents:
2212
diff
changeset
|
217 extra[KEY_GUEST_PROFILE] = guest_profile = INVITEE_PROFILE_TPL.format(uuid=id_) |
| 2184 | 218 # profile creation should not fail as we generate unique name ourselves |
| 219 yield self.host.memory.createProfile(guest_profile, password) | |
| 220 yield self.host.memory.startSession(password, guest_profile) | |
| 221 yield self.host.memory.setParam("JabberID", jid_.full(), "Connection", profile_key=guest_profile) | |
| 222 yield self.host.memory.setParam("Password", password, "Connection", profile_key=guest_profile) | |
| 223 | |
| 224 ## email | |
| 225 language = kwargs.pop(u'language', None) | |
| 226 if language is not None: | |
| 227 extra[u'language'] = language | |
| 228 email = kwargs.pop(u'email', None) | |
| 229 | |
| 230 if email is not None: | |
|
2219
77a3d0a28642
plugin invitations: added modify method (+ bridge) and fixed email setting in extra
Goffi <goffi@goffi.org>
parents:
2212
diff
changeset
|
231 extra[u'email'] = email |
| 2184 | 232 url_template = kwargs.pop(u'url_template', '') |
| 233 format_args = { | |
| 234 u'uuid': id_, | |
| 235 u'app_name': C.APP_NAME, | |
| 236 u'app_url': C.APP_URL} | |
| 237 | |
| 238 name = kwargs.pop(u'name', None) | |
| 239 if name is None: | |
| 240 format_args[u'name'] = email | |
| 241 else: | |
| 242 format_args[u'name'] = extra[u'name'] = name | |
| 243 | |
| 244 profile = kwargs.pop(u'profile', None) | |
| 245 if profile is None: | |
| 246 format_args[u'profile'] = u'' | |
| 247 else: | |
| 248 format_args[u'profile'] = extra[u'profile'] = profile | |
| 249 | |
| 250 host_name = kwargs.pop(u'host_name', None) | |
| 251 if host_name is None: | |
| 252 format_args[u'host_name'] = profile or _(u"somebody") | |
| 253 else: | |
| 254 format_args[u'host_name'] = extra[u'host_name'] = host_name | |
| 255 | |
| 256 invite_url = url_template.format(**format_args) | |
| 257 format_args[u'url'] = invite_url | |
| 258 | |
| 259 yield sat_email.sendEmail( | |
| 260 self.host, | |
| 261 [email], | |
| 262 (kwargs.pop(u'message_subject', None) or DEFAULT_SUBJECT).format(**format_args), | |
| 263 (kwargs.pop(u'message_body', None) or DEFAULT_BODY).format(**format_args), | |
| 264 ) | |
| 265 | |
| 266 ## extra data saving | |
| 267 self.invitations[id_] = extra | |
| 268 | |
| 269 if kwargs: | |
| 270 log.warning(_(u"Not all arguments have been consumed: {}").format(kwargs)) | |
| 271 | |
|
2211
df115e4a36c7
plugin invitations: invitation id and invitee jid are now added to return dict in invitationCreate, bridge signature has changed too
Goffi <goffi@goffi.org>
parents:
2210
diff
changeset
|
272 extra[KEY_ID] = id_ |
|
df115e4a36c7
plugin invitations: invitation id and invitee jid are now added to return dict in invitationCreate, bridge signature has changed too
Goffi <goffi@goffi.org>
parents:
2210
diff
changeset
|
273 extra[KEY_JID] = jid |
|
df115e4a36c7
plugin invitations: invitation id and invitee jid are now added to return dict in invitationCreate, bridge signature has changed too
Goffi <goffi@goffi.org>
parents:
2210
diff
changeset
|
274 defer.returnValue(extra) |
|
2212
eaf2467d19ce
plugin invitations: added getInvitation method, it return invitation data and raise an error if it is not found
Goffi <goffi@goffi.org>
parents:
2211
diff
changeset
|
275 |
|
2219
77a3d0a28642
plugin invitations: added modify method (+ bridge) and fixed email setting in extra
Goffi <goffi@goffi.org>
parents:
2212
diff
changeset
|
276 def get(self, id_): |
|
2212
eaf2467d19ce
plugin invitations: added getInvitation method, it return invitation data and raise an error if it is not found
Goffi <goffi@goffi.org>
parents:
2211
diff
changeset
|
277 """Retrieve invitation linked to uuid if it exists |
|
eaf2467d19ce
plugin invitations: added getInvitation method, it return invitation data and raise an error if it is not found
Goffi <goffi@goffi.org>
parents:
2211
diff
changeset
|
278 |
|
eaf2467d19ce
plugin invitations: added getInvitation method, it return invitation data and raise an error if it is not found
Goffi <goffi@goffi.org>
parents:
2211
diff
changeset
|
279 @param id_(unicode): UUID linked to an invitation |
|
2219
77a3d0a28642
plugin invitations: added modify method (+ bridge) and fixed email setting in extra
Goffi <goffi@goffi.org>
parents:
2212
diff
changeset
|
280 @return (dict[unicode, unicode]): data associated to the invitation |
|
2212
eaf2467d19ce
plugin invitations: added getInvitation method, it return invitation data and raise an error if it is not found
Goffi <goffi@goffi.org>
parents:
2211
diff
changeset
|
281 @raise KeyError: there is not invitation with this id_ |
|
eaf2467d19ce
plugin invitations: added getInvitation method, it return invitation data and raise an error if it is not found
Goffi <goffi@goffi.org>
parents:
2211
diff
changeset
|
282 """ |
|
eaf2467d19ce
plugin invitations: added getInvitation method, it return invitation data and raise an error if it is not found
Goffi <goffi@goffi.org>
parents:
2211
diff
changeset
|
283 return self.invitations[id_] |
|
2219
77a3d0a28642
plugin invitations: added modify method (+ bridge) and fixed email setting in extra
Goffi <goffi@goffi.org>
parents:
2212
diff
changeset
|
284 |
|
77a3d0a28642
plugin invitations: added modify method (+ bridge) and fixed email setting in extra
Goffi <goffi@goffi.org>
parents:
2212
diff
changeset
|
285 def _modify(self, id_, new_extra, replace): |
|
77a3d0a28642
plugin invitations: added modify method (+ bridge) and fixed email setting in extra
Goffi <goffi@goffi.org>
parents:
2212
diff
changeset
|
286 return self.modify(id_, {unicode(k): unicode(v) for k,v in new_extra.iteritems()}, replace) |
|
77a3d0a28642
plugin invitations: added modify method (+ bridge) and fixed email setting in extra
Goffi <goffi@goffi.org>
parents:
2212
diff
changeset
|
287 |
|
77a3d0a28642
plugin invitations: added modify method (+ bridge) and fixed email setting in extra
Goffi <goffi@goffi.org>
parents:
2212
diff
changeset
|
288 def modify(self, id_, new_extra, replace=False): |
|
77a3d0a28642
plugin invitations: added modify method (+ bridge) and fixed email setting in extra
Goffi <goffi@goffi.org>
parents:
2212
diff
changeset
|
289 """Modify invitation data |
|
77a3d0a28642
plugin invitations: added modify method (+ bridge) and fixed email setting in extra
Goffi <goffi@goffi.org>
parents:
2212
diff
changeset
|
290 |
|
77a3d0a28642
plugin invitations: added modify method (+ bridge) and fixed email setting in extra
Goffi <goffi@goffi.org>
parents:
2212
diff
changeset
|
291 @param id_(unicode): UUID linked to an invitation |
|
77a3d0a28642
plugin invitations: added modify method (+ bridge) and fixed email setting in extra
Goffi <goffi@goffi.org>
parents:
2212
diff
changeset
|
292 @param new_extra(dict[unicode, unicode]): data to update |
|
77a3d0a28642
plugin invitations: added modify method (+ bridge) and fixed email setting in extra
Goffi <goffi@goffi.org>
parents:
2212
diff
changeset
|
293 @param replace(bool): if True replace the data |
|
77a3d0a28642
plugin invitations: added modify method (+ bridge) and fixed email setting in extra
Goffi <goffi@goffi.org>
parents:
2212
diff
changeset
|
294 else update them |
|
77a3d0a28642
plugin invitations: added modify method (+ bridge) and fixed email setting in extra
Goffi <goffi@goffi.org>
parents:
2212
diff
changeset
|
295 @raise KeyError: there is not invitation with this id_ |
|
77a3d0a28642
plugin invitations: added modify method (+ bridge) and fixed email setting in extra
Goffi <goffi@goffi.org>
parents:
2212
diff
changeset
|
296 """ |
|
77a3d0a28642
plugin invitations: added modify method (+ bridge) and fixed email setting in extra
Goffi <goffi@goffi.org>
parents:
2212
diff
changeset
|
297 self.checkExtra(new_extra) |
|
77a3d0a28642
plugin invitations: added modify method (+ bridge) and fixed email setting in extra
Goffi <goffi@goffi.org>
parents:
2212
diff
changeset
|
298 def gotCurrentData(current_data): |
|
77a3d0a28642
plugin invitations: added modify method (+ bridge) and fixed email setting in extra
Goffi <goffi@goffi.org>
parents:
2212
diff
changeset
|
299 if replace: |
|
77a3d0a28642
plugin invitations: added modify method (+ bridge) and fixed email setting in extra
Goffi <goffi@goffi.org>
parents:
2212
diff
changeset
|
300 new_data = new_extra |
|
77a3d0a28642
plugin invitations: added modify method (+ bridge) and fixed email setting in extra
Goffi <goffi@goffi.org>
parents:
2212
diff
changeset
|
301 for k in EXTRA_RESERVED: |
|
77a3d0a28642
plugin invitations: added modify method (+ bridge) and fixed email setting in extra
Goffi <goffi@goffi.org>
parents:
2212
diff
changeset
|
302 try: |
|
77a3d0a28642
plugin invitations: added modify method (+ bridge) and fixed email setting in extra
Goffi <goffi@goffi.org>
parents:
2212
diff
changeset
|
303 new_data[k] = current_data[k] |
|
77a3d0a28642
plugin invitations: added modify method (+ bridge) and fixed email setting in extra
Goffi <goffi@goffi.org>
parents:
2212
diff
changeset
|
304 except KeyError: |
|
77a3d0a28642
plugin invitations: added modify method (+ bridge) and fixed email setting in extra
Goffi <goffi@goffi.org>
parents:
2212
diff
changeset
|
305 continue |
|
77a3d0a28642
plugin invitations: added modify method (+ bridge) and fixed email setting in extra
Goffi <goffi@goffi.org>
parents:
2212
diff
changeset
|
306 else: |
|
77a3d0a28642
plugin invitations: added modify method (+ bridge) and fixed email setting in extra
Goffi <goffi@goffi.org>
parents:
2212
diff
changeset
|
307 new_data = current_data |
|
77a3d0a28642
plugin invitations: added modify method (+ bridge) and fixed email setting in extra
Goffi <goffi@goffi.org>
parents:
2212
diff
changeset
|
308 for k,v in new_extra.iteritems(): |
|
77a3d0a28642
plugin invitations: added modify method (+ bridge) and fixed email setting in extra
Goffi <goffi@goffi.org>
parents:
2212
diff
changeset
|
309 new_data[k] = v |
|
77a3d0a28642
plugin invitations: added modify method (+ bridge) and fixed email setting in extra
Goffi <goffi@goffi.org>
parents:
2212
diff
changeset
|
310 |
|
77a3d0a28642
plugin invitations: added modify method (+ bridge) and fixed email setting in extra
Goffi <goffi@goffi.org>
parents:
2212
diff
changeset
|
311 self.invitations[id_] = new_data |
|
77a3d0a28642
plugin invitations: added modify method (+ bridge) and fixed email setting in extra
Goffi <goffi@goffi.org>
parents:
2212
diff
changeset
|
312 |
|
77a3d0a28642
plugin invitations: added modify method (+ bridge) and fixed email setting in extra
Goffi <goffi@goffi.org>
parents:
2212
diff
changeset
|
313 d = self.invitations[id_] |
|
77a3d0a28642
plugin invitations: added modify method (+ bridge) and fixed email setting in extra
Goffi <goffi@goffi.org>
parents:
2212
diff
changeset
|
314 d.addCallback(gotCurrentData) |
|
77a3d0a28642
plugin invitations: added modify method (+ bridge) and fixed email setting in extra
Goffi <goffi@goffi.org>
parents:
2212
diff
changeset
|
315 return d |