Mercurial > libervia-pubsub

annotate src/mam.py @ 375:9a787881b824

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
implemented Order-By ProtoXEP (MAM + PubSub)
author Goffi <goffi@goffi.org>
date Sun, 06 Jan 2019 17:29:50 +0100
parents dabee42494ac
children 66fbf026ed49
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
280
798cb8962c0b MAM (XEP-0313) support: first draft
souliane <souliane@mailoo.org>
parents:
diff changeset
1 #!/usr/bin/python
798cb8962c0b MAM (XEP-0313) support: first draft
souliane <souliane@mailoo.org>
parents:
diff changeset
2 #-*- coding: utf-8 -*-
798cb8962c0b MAM (XEP-0313) support: first draft
souliane <souliane@mailoo.org>
parents:
diff changeset
3
316
cca47e9977a5 mam: minor improvments (module import and some checks)
Goffi <goffi@goffi.org>
parents: 311
diff changeset
4 # Copyright (c) 2016 Jérôme Poisson
311
a776544d84e5 copyright update
Goffi <goffi@goffi.org>
parents: 282
diff changeset
5 # Copyright (c) 2015-2016 Adrien Cossa
a776544d84e5 copyright update
Goffi <goffi@goffi.org>
parents: 282
diff changeset
6 #
a776544d84e5 copyright update
Goffi <goffi@goffi.org>
parents: 282
diff changeset
7 # This program is free software: you can redistribute it and/or modify
a776544d84e5 copyright update
Goffi <goffi@goffi.org>
parents: 282
diff changeset
8 # it under the terms of the GNU Affero General Public License as published by
a776544d84e5 copyright update
Goffi <goffi@goffi.org>
parents: 282
diff changeset
9 # the Free Software Foundation, either version 3 of the License, or
a776544d84e5 copyright update
Goffi <goffi@goffi.org>
parents: 282
diff changeset
10 # (at your option) any later version.
a776544d84e5 copyright update
Goffi <goffi@goffi.org>
parents: 282
diff changeset
11 #
a776544d84e5 copyright update
Goffi <goffi@goffi.org>
parents: 282
diff changeset
12 # This program is distributed in the hope that it will be useful,
a776544d84e5 copyright update
Goffi <goffi@goffi.org>
parents: 282
diff changeset
13 # but WITHOUT ANY WARRANTY; without even the implied warranty of
a776544d84e5 copyright update
Goffi <goffi@goffi.org>
parents: 282
diff changeset
14 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
a776544d84e5 copyright update
Goffi <goffi@goffi.org>
parents: 282
diff changeset
15 # GNU Affero General Public License for more details.
a776544d84e5 copyright update
Goffi <goffi@goffi.org>
parents: 282
diff changeset
16 #
a776544d84e5 copyright update
Goffi <goffi@goffi.org>
parents: 282
diff changeset
17 # You should have received a copy of the GNU Affero General Public License
a776544d84e5 copyright update
Goffi <goffi@goffi.org>
parents: 282
diff changeset
18 # along with this program. If not, see <http://www.gnu.org/licenses/>.
a776544d84e5 copyright update
Goffi <goffi@goffi.org>
parents: 282
diff changeset
19
280
798cb8962c0b MAM (XEP-0313) support: first draft
souliane <souliane@mailoo.org>
parents:
diff changeset
20 """
798cb8962c0b MAM (XEP-0313) support: first draft
souliane <souliane@mailoo.org>
parents:
diff changeset
21 XMPP Message Archive Management protocol.
798cb8962c0b MAM (XEP-0313) support: first draft
souliane <souliane@mailoo.org>
parents:
diff changeset
22
798cb8962c0b MAM (XEP-0313) support: first draft
souliane <souliane@mailoo.org>
parents:
diff changeset
23 This protocol is specified in
798cb8962c0b MAM (XEP-0313) support: first draft
souliane <souliane@mailoo.org>
parents:
diff changeset
24 U{XEP-0313<http://xmpp.org/extensions/xep-0313.html>}.
798cb8962c0b MAM (XEP-0313) support: first draft
souliane <souliane@mailoo.org>
parents:
diff changeset
25 """
798cb8962c0b MAM (XEP-0313) support: first draft
souliane <souliane@mailoo.org>
parents:
diff changeset
26
311
a776544d84e5 copyright update
Goffi <goffi@goffi.org>
parents: 282
diff changeset
27
280
798cb8962c0b MAM (XEP-0313) support: first draft
souliane <souliane@mailoo.org>
parents:
diff changeset
28 from zope.interface import implements
281
30895c49ebd2 fixes the imports from sat.tmp
souliane <souliane@mailoo.org>
parents: 280
diff changeset
29
282
7d54ff2eeaf2 actually retrieve the MAM messages
souliane <souliane@mailoo.org>
parents: 281
diff changeset
30 from twisted.words.xish import domish
322
54d90c73b8b5 mam: various improvments:
Goffi <goffi@goffi.org>
parents: 316
diff changeset
31 from twisted.python import log
54d90c73b8b5 mam: various improvments:
Goffi <goffi@goffi.org>
parents: 316
diff changeset
32 from twisted.words.protocols.jabber import error
282
7d54ff2eeaf2 actually retrieve the MAM messages
souliane <souliane@mailoo.org>
parents: 281
diff changeset
33
7d54ff2eeaf2 actually retrieve the MAM messages
souliane <souliane@mailoo.org>
parents: 281
diff changeset
34 from sat_pubsub import const
322
54d90c73b8b5 mam: various improvments:
Goffi <goffi@goffi.org>
parents: 316
diff changeset
35 from sat_pubsub import backend
54d90c73b8b5 mam: various improvments:
Goffi <goffi@goffi.org>
parents: 316
diff changeset
36 from wokkel import pubsub
282
7d54ff2eeaf2 actually retrieve the MAM messages
souliane <souliane@mailoo.org>
parents: 281
diff changeset
37
322
54d90c73b8b5 mam: various improvments:
Goffi <goffi@goffi.org>
parents: 316
diff changeset
38 from wokkel import rsm
54d90c73b8b5 mam: various improvments:
Goffi <goffi@goffi.org>
parents: 316
diff changeset
39 from wokkel import mam
54d90c73b8b5 mam: various improvments:
Goffi <goffi@goffi.org>
parents: 316
diff changeset
40 from wokkel import delay
282
7d54ff2eeaf2 actually retrieve the MAM messages
souliane <souliane@mailoo.org>
parents: 281
diff changeset
41
280
798cb8962c0b MAM (XEP-0313) support: first draft
souliane <souliane@mailoo.org>
parents:
diff changeset
42
798cb8962c0b MAM (XEP-0313) support: first draft
souliane <souliane@mailoo.org>
parents:
diff changeset
43 class MAMResource(object):
322
54d90c73b8b5 mam: various improvments:
Goffi <goffi@goffi.org>
parents: 316
diff changeset
44 implements(mam.IMAMResource)
54d90c73b8b5 mam: various improvments:
Goffi <goffi@goffi.org>
parents: 316
diff changeset
45 _errorMap = backend.PubSubResourceFromBackend._errorMap
280
798cb8962c0b MAM (XEP-0313) support: first draft
souliane <souliane@mailoo.org>
parents:
diff changeset
46
322
54d90c73b8b5 mam: various improvments:
Goffi <goffi@goffi.org>
parents: 316
diff changeset
47 def __init__(self, backend_):
54d90c73b8b5 mam: various improvments:
Goffi <goffi@goffi.org>
parents: 316
diff changeset
48 self.backend = backend_
54d90c73b8b5 mam: various improvments:
Goffi <goffi@goffi.org>
parents: 316
diff changeset
49
54d90c73b8b5 mam: various improvments:
Goffi <goffi@goffi.org>
parents: 316
diff changeset
50 def _mapErrors(self, failure):
54d90c73b8b5 mam: various improvments:
Goffi <goffi@goffi.org>
parents: 316
diff changeset
51 # XXX: come from backend.PubsubResourceFromBackend
54d90c73b8b5 mam: various improvments:
Goffi <goffi@goffi.org>
parents: 316
diff changeset
52 e = failure.trap(*self._errorMap.keys())
280
798cb8962c0b MAM (XEP-0313) support: first draft
souliane <souliane@mailoo.org>
parents:
diff changeset
53
322
54d90c73b8b5 mam: various improvments:
Goffi <goffi@goffi.org>
parents: 316
diff changeset
54 condition, pubsubCondition, feature = self._errorMap[e]
54d90c73b8b5 mam: various improvments:
Goffi <goffi@goffi.org>
parents: 316
diff changeset
55 msg = failure.value.msg
282
7d54ff2eeaf2 actually retrieve the MAM messages
souliane <souliane@mailoo.org>
parents: 281
diff changeset
56
322
54d90c73b8b5 mam: various improvments:
Goffi <goffi@goffi.org>
parents: 316
diff changeset
57 if pubsubCondition:
54d90c73b8b5 mam: various improvments:
Goffi <goffi@goffi.org>
parents: 316
diff changeset
58 exc = pubsub.PubSubError(condition, pubsubCondition, feature, msg)
54d90c73b8b5 mam: various improvments:
Goffi <goffi@goffi.org>
parents: 316
diff changeset
59 else:
54d90c73b8b5 mam: various improvments:
Goffi <goffi@goffi.org>
parents: 316
diff changeset
60 exc = error.StanzaError(condition, text=msg)
54d90c73b8b5 mam: various improvments:
Goffi <goffi@goffi.org>
parents: 316
diff changeset
61
54d90c73b8b5 mam: various improvments:
Goffi <goffi@goffi.org>
parents: 316
diff changeset
62 raise exc
54d90c73b8b5 mam: various improvments:
Goffi <goffi@goffi.org>
parents: 316
diff changeset
63
325
8d939378f023 mam: removed requestor in favor of mam_request.sender and recipient + fixed bad use of requestor instead of recipient in getItemsData
Goffi <goffi@goffi.org>
parents: 322
diff changeset
64 def onArchiveRequest(self, mam_request):
280
798cb8962c0b MAM (XEP-0313) support: first draft
souliane <souliane@mailoo.org>
parents:
diff changeset
65 """
798cb8962c0b MAM (XEP-0313) support: first draft
souliane <souliane@mailoo.org>
parents:
diff changeset
66
322
54d90c73b8b5 mam: various improvments:
Goffi <goffi@goffi.org>
parents: 316
diff changeset
67 @param mam_request: The MAM archive request.
54d90c73b8b5 mam: various improvments:
Goffi <goffi@goffi.org>
parents: 316
diff changeset
68 @type mam_request: L{MAMQueryReques<wokkel.mam.MAMRequest>}
280
798cb8962c0b MAM (XEP-0313) support: first draft
souliane <souliane@mailoo.org>
parents:
diff changeset
69
316
cca47e9977a5 mam: minor improvments (module import and some checks)
Goffi <goffi@goffi.org>
parents: 311
diff changeset
70 @return: A tuple with list of message data (id, element, data) and RSM element
cca47e9977a5 mam: minor improvments (module import and some checks)
Goffi <goffi@goffi.org>
parents: 311
diff changeset
71 @rtype: C{tuple}
280
798cb8962c0b MAM (XEP-0313) support: first draft
souliane <souliane@mailoo.org>
parents:
diff changeset
72 """
316
cca47e9977a5 mam: minor improvments (module import and some checks)
Goffi <goffi@goffi.org>
parents: 311
diff changeset
73 # FIXME: bad result ordering
322
54d90c73b8b5 mam: various improvments:
Goffi <goffi@goffi.org>
parents: 316
diff changeset
74 try:
54d90c73b8b5 mam: various improvments:
Goffi <goffi@goffi.org>
parents: 316
diff changeset
75 pep = mam_request.delegated
54d90c73b8b5 mam: various improvments:
Goffi <goffi@goffi.org>
parents: 316
diff changeset
76 except AttributeError:
54d90c73b8b5 mam: various improvments:
Goffi <goffi@goffi.org>
parents: 316
diff changeset
77 pep = False
54d90c73b8b5 mam: various improvments:
Goffi <goffi@goffi.org>
parents: 316
diff changeset
78 ext_data = {'pep': pep}
54d90c73b8b5 mam: various improvments:
Goffi <goffi@goffi.org>
parents: 316
diff changeset
79 if mam_request.form:
54d90c73b8b5 mam: various improvments:
Goffi <goffi@goffi.org>
parents: 316
diff changeset
80 ext_data['filters'] = mam_request.form.fields.values()
54d90c73b8b5 mam: various improvments:
Goffi <goffi@goffi.org>
parents: 316
diff changeset
81 if mam_request.rsm is None:
54d90c73b8b5 mam: various improvments:
Goffi <goffi@goffi.org>
parents: 316
diff changeset
82 if const.VAL_RSM_MAX_DEFAULT != None:
54d90c73b8b5 mam: various improvments:
Goffi <goffi@goffi.org>
parents: 316
diff changeset
83 log.msg("MAM request without RSM limited to {}".format(const.VAL_RSM_MAX_DEFAULT))
54d90c73b8b5 mam: various improvments:
Goffi <goffi@goffi.org>
parents: 316
diff changeset
84 ext_data['rsm'] = rsm.RSMRequest(const.VAL_RSM_MAX_DEFAULT)
54d90c73b8b5 mam: various improvments:
Goffi <goffi@goffi.org>
parents: 316
diff changeset
85 else:
54d90c73b8b5 mam: various improvments:
Goffi <goffi@goffi.org>
parents: 316
diff changeset
86 ext_data['rsm'] = mam_request.rsm
282
7d54ff2eeaf2 actually retrieve the MAM messages
souliane <souliane@mailoo.org>
parents: 281
diff changeset
87
375
9a787881b824 implemented Order-By ProtoXEP (MAM + PubSub)
Goffi <goffi@goffi.org>
parents: 369
diff changeset
88 if mam_request.orderBy:
9a787881b824 implemented Order-By ProtoXEP (MAM + PubSub)
Goffi <goffi@goffi.org>
parents: 369
diff changeset
89 ext_data['order_by'] = mam_request.orderBy
9a787881b824 implemented Order-By ProtoXEP (MAM + PubSub)
Goffi <goffi@goffi.org>
parents: 369
diff changeset
90
335
5580f08c7b91 mam: fixed call to getItemsData where requestor was missing
Goffi <goffi@goffi.org>
parents: 325
diff changeset
91 d = self.backend.getItemsData(mam_request.node, mam_request.sender, mam_request.recipient, None, None, ext_data)
282
7d54ff2eeaf2 actually retrieve the MAM messages
souliane <souliane@mailoo.org>
parents: 281
diff changeset
92
7d54ff2eeaf2 actually retrieve the MAM messages
souliane <souliane@mailoo.org>
parents: 281
diff changeset
93 def make_message(elt):
7d54ff2eeaf2 actually retrieve the MAM messages
souliane <souliane@mailoo.org>
parents: 281
diff changeset
94 # XXX: http://xmpp.org/extensions/xep-0297.html#sect-idp629952 (rule 3)
322
54d90c73b8b5 mam: various improvments:
Goffi <goffi@goffi.org>
parents: 316
diff changeset
95 message = domish.Element((const.NS_CLIENT, "message"))
54d90c73b8b5 mam: various improvments:
Goffi <goffi@goffi.org>
parents: 316
diff changeset
96 event = message.addElement((pubsub.NS_PUBSUB_EVENT, "event"))
282
7d54ff2eeaf2 actually retrieve the MAM messages
souliane <souliane@mailoo.org>
parents: 281
diff changeset
97 items = event.addElement('items')
322
54d90c73b8b5 mam: various improvments:
Goffi <goffi@goffi.org>
parents: 316
diff changeset
98 items["node"] = mam_request.node
282
7d54ff2eeaf2 actually retrieve the MAM messages
souliane <souliane@mailoo.org>
parents: 281
diff changeset
99 items.addChild(elt)
7d54ff2eeaf2 actually retrieve the MAM messages
souliane <souliane@mailoo.org>
parents: 281
diff changeset
100 return message
7d54ff2eeaf2 actually retrieve the MAM messages
souliane <souliane@mailoo.org>
parents: 281
diff changeset
101
322
54d90c73b8b5 mam: various improvments:
Goffi <goffi@goffi.org>
parents: 316
diff changeset
102 def cb(items_data):
282
7d54ff2eeaf2 actually retrieve the MAM messages
souliane <souliane@mailoo.org>
parents: 281
diff changeset
103 msg_data = []
7d54ff2eeaf2 actually retrieve the MAM messages
souliane <souliane@mailoo.org>
parents: 281
diff changeset
104 rsm_elt = None
322
54d90c73b8b5 mam: various improvments:
Goffi <goffi@goffi.org>
parents: 316
diff changeset
105 for item_data in items_data:
54d90c73b8b5 mam: various improvments:
Goffi <goffi@goffi.org>
parents: 316
diff changeset
106 if item_data.item.name == 'set' and item_data.item.uri == rsm.NS_RSM:
316
cca47e9977a5 mam: minor improvments (module import and some checks)
Goffi <goffi@goffi.org>
parents: 311
diff changeset
107 assert rsm_elt is None
322
54d90c73b8b5 mam: various improvments:
Goffi <goffi@goffi.org>
parents: 316
diff changeset
108 rsm_elt = item_data.item
54d90c73b8b5 mam: various improvments:
Goffi <goffi@goffi.org>
parents: 316
diff changeset
109 elif item_data.item.name == 'item':
367
a772f7dac930 backend, storage(pgsql): creation/update date + serial ids:
Goffi <goffi@goffi.org>
parents: 335
diff changeset
110 msg_data.append([item_data.item['id'], make_message(item_data.item), item_data.created])
322
54d90c73b8b5 mam: various improvments:
Goffi <goffi@goffi.org>
parents: 316
diff changeset
111 else:
54d90c73b8b5 mam: various improvments:
Goffi <goffi@goffi.org>
parents: 316
diff changeset
112 log.msg("WARNING: unknown element: {}".format(item_data.item.name))
54d90c73b8b5 mam: various improvments:
Goffi <goffi@goffi.org>
parents: 316
diff changeset
113 if pep:
54d90c73b8b5 mam: various improvments:
Goffi <goffi@goffi.org>
parents: 316
diff changeset
114 # we need to send privileged message
54d90c73b8b5 mam: various improvments:
Goffi <goffi@goffi.org>
parents: 316
diff changeset
115 # so me manage the sending ourself, and return
54d90c73b8b5 mam: various improvments:
Goffi <goffi@goffi.org>
parents: 316
diff changeset
116 # an empty msg_data list to avoid double sending
54d90c73b8b5 mam: various improvments:
Goffi <goffi@goffi.org>
parents: 316
diff changeset
117 for data in msg_data:
325
8d939378f023 mam: removed requestor in favor of mam_request.sender and recipient + fixed bad use of requestor instead of recipient in getItemsData
Goffi <goffi@goffi.org>
parents: 322
diff changeset
118 self.forwardPEPMessage(mam_request, *data)
322
54d90c73b8b5 mam: various improvments:
Goffi <goffi@goffi.org>
parents: 316
diff changeset
119 msg_data = []
282
7d54ff2eeaf2 actually retrieve the MAM messages
souliane <souliane@mailoo.org>
parents: 281
diff changeset
120 return (msg_data, rsm_elt)
7d54ff2eeaf2 actually retrieve the MAM messages
souliane <souliane@mailoo.org>
parents: 281
diff changeset
121
322
54d90c73b8b5 mam: various improvments:
Goffi <goffi@goffi.org>
parents: 316
diff changeset
122 d.addErrback(self._mapErrors)
316
cca47e9977a5 mam: minor improvments (module import and some checks)
Goffi <goffi@goffi.org>
parents: 311
diff changeset
123 d.addCallback(cb)
cca47e9977a5 mam: minor improvments (module import and some checks)
Goffi <goffi@goffi.org>
parents: 311
diff changeset
124 return d
280
798cb8962c0b MAM (XEP-0313) support: first draft
souliane <souliane@mailoo.org>
parents:
diff changeset
125
367
a772f7dac930 backend, storage(pgsql): creation/update date + serial ids:
Goffi <goffi@goffi.org>
parents: 335
diff changeset
126 def forwardPEPMessage(self, mam_request, id_, elt, created):
322
54d90c73b8b5 mam: various improvments:
Goffi <goffi@goffi.org>
parents: 316
diff changeset
127 msg = domish.Element((None, 'message'))
54d90c73b8b5 mam: various improvments:
Goffi <goffi@goffi.org>
parents: 316
diff changeset
128 msg['from'] = self.backend.privilege.server_jid.full()
325
8d939378f023 mam: removed requestor in favor of mam_request.sender and recipient + fixed bad use of requestor instead of recipient in getItemsData
Goffi <goffi@goffi.org>
parents: 322
diff changeset
129 msg['to'] = mam_request.sender.full()
322
54d90c73b8b5 mam: various improvments:
Goffi <goffi@goffi.org>
parents: 316
diff changeset
130 result = msg.addElement((mam.NS_MAM, 'result'))
54d90c73b8b5 mam: various improvments:
Goffi <goffi@goffi.org>
parents: 316
diff changeset
131 if mam_request.query_id is not None:
54d90c73b8b5 mam: various improvments:
Goffi <goffi@goffi.org>
parents: 316
diff changeset
132 result['queryid'] = mam_request.query_id
54d90c73b8b5 mam: various improvments:
Goffi <goffi@goffi.org>
parents: 316
diff changeset
133 result['id'] = id_
54d90c73b8b5 mam: various improvments:
Goffi <goffi@goffi.org>
parents: 316
diff changeset
134 forward = result.addElement((const.NS_FORWARD, 'forwarded'))
367
a772f7dac930 backend, storage(pgsql): creation/update date + serial ids:
Goffi <goffi@goffi.org>
parents: 335
diff changeset
135 forward.addChild(delay.Delay(created).toElement())
322
54d90c73b8b5 mam: various improvments:
Goffi <goffi@goffi.org>
parents: 316
diff changeset
136 forward.addChild(elt)
54d90c73b8b5 mam: various improvments:
Goffi <goffi@goffi.org>
parents: 316
diff changeset
137 self.backend.privilege.sendMessage(msg)
54d90c73b8b5 mam: various improvments:
Goffi <goffi@goffi.org>
parents: 316
diff changeset
138
280
798cb8962c0b MAM (XEP-0313) support: first draft
souliane <souliane@mailoo.org>
parents:
diff changeset
139 def onPrefsGetRequest(self, requestor):
798cb8962c0b MAM (XEP-0313) support: first draft
souliane <souliane@mailoo.org>
parents:
diff changeset
140 """
798cb8962c0b MAM (XEP-0313) support: first draft
souliane <souliane@mailoo.org>
parents:
diff changeset
141
798cb8962c0b MAM (XEP-0313) support: first draft
souliane <souliane@mailoo.org>
parents:
diff changeset
142 @param requestor: JID of the requestor.
798cb8962c0b MAM (XEP-0313) support: first draft
souliane <souliane@mailoo.org>
parents:
diff changeset
143 @type requestor: L{JID<twisted.words.protocols.jabber.jid.JID>}
798cb8962c0b MAM (XEP-0313) support: first draft
souliane <souliane@mailoo.org>
parents:
diff changeset
144
798cb8962c0b MAM (XEP-0313) support: first draft
souliane <souliane@mailoo.org>
parents:
diff changeset
145 @return: The current settings.
798cb8962c0b MAM (XEP-0313) support: first draft
souliane <souliane@mailoo.org>
parents:
diff changeset
146 @rtype: L{wokkel.mam.MAMPrefs}
798cb8962c0b MAM (XEP-0313) support: first draft
souliane <souliane@mailoo.org>
parents:
diff changeset
147 """
798cb8962c0b MAM (XEP-0313) support: first draft
souliane <souliane@mailoo.org>
parents:
diff changeset
148 # TODO: return the actual current settings
316
cca47e9977a5 mam: minor improvments (module import and some checks)
Goffi <goffi@goffi.org>
parents: 311
diff changeset
149 return mam.MAMPrefs()
280
798cb8962c0b MAM (XEP-0313) support: first draft
souliane <souliane@mailoo.org>
parents:
diff changeset
150
798cb8962c0b MAM (XEP-0313) support: first draft
souliane <souliane@mailoo.org>
parents:
diff changeset
151 def onPrefsSetRequest(self, prefs, requestor):
798cb8962c0b MAM (XEP-0313) support: first draft
souliane <souliane@mailoo.org>
parents:
diff changeset
152 """
798cb8962c0b MAM (XEP-0313) support: first draft
souliane <souliane@mailoo.org>
parents:
diff changeset
153
798cb8962c0b MAM (XEP-0313) support: first draft
souliane <souliane@mailoo.org>
parents:
diff changeset
154 @param prefs: The new settings to set.
798cb8962c0b MAM (XEP-0313) support: first draft
souliane <souliane@mailoo.org>
parents:
diff changeset
155 @type prefs: L{wokkel.mam.MAMPrefs}
798cb8962c0b MAM (XEP-0313) support: first draft
souliane <souliane@mailoo.org>
parents:
diff changeset
156
798cb8962c0b MAM (XEP-0313) support: first draft
souliane <souliane@mailoo.org>
parents:
diff changeset
157 @param requestor: JID of the requestor.
798cb8962c0b MAM (XEP-0313) support: first draft
souliane <souliane@mailoo.org>
parents:
diff changeset
158 @type requestor: L{JID<twisted.words.protocols.jabber.jid.JID>}
798cb8962c0b MAM (XEP-0313) support: first draft
souliane <souliane@mailoo.org>
parents:
diff changeset
159
798cb8962c0b MAM (XEP-0313) support: first draft
souliane <souliane@mailoo.org>
parents:
diff changeset
160 @return: The settings that have actually been set.
798cb8962c0b MAM (XEP-0313) support: first draft
souliane <souliane@mailoo.org>
parents:
diff changeset
161 @rtype: L{wokkel.mam.MAMPrefs}
798cb8962c0b MAM (XEP-0313) support: first draft
souliane <souliane@mailoo.org>
parents:
diff changeset
162 """
798cb8962c0b MAM (XEP-0313) support: first draft
souliane <souliane@mailoo.org>
parents:
diff changeset
163 # TODO: set the new settings and return them
316
cca47e9977a5 mam: minor improvments (module import and some checks)
Goffi <goffi@goffi.org>
parents: 311
diff changeset
164 return mam.MAMPrefs()