Mercurial > libervia-backend
annotate src/plugins/plugin_xep_0071.py @ 1939:e68483c5a999
quick app (contact list): when a new profile is plugged, updates are locked until the end of the process, this avoid many useless refreshes
author | Goffi <goffi@goffi.org> |
---|---|
date | Mon, 18 Apr 2016 18:33:55 +0200 |
parents | 2daf7b4c6756 |
children | 633b5c21aefd |
rev | line source |
---|---|
1934
2daf7b4c6756
use of /usr/bin/env instead of /usr/bin/python in shebang
Goffi <goffi@goffi.org>
parents:
1813
diff
changeset
|
1 #!/usr/bin/env python2 |
668 | 2 # -*- coding: utf-8 -*- |
3 | |
4 # SAT plugin for Publish-Subscribe (xep-0071) | |
1766 | 5 # Copyright (C) 2009-2016 Jérôme Poisson (goffi@goffi.org) |
668 | 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 | |
771 | 20 from sat.core.i18n import _ |
832
c4b22aedb7d7
plugin groupblog, XEP-0071, XEP-0277, text_syntaxes: manage raw/rich/xhtml data for content/title:
souliane <souliane@mailoo.org>
parents:
811
diff
changeset
|
21 from sat.core import exceptions |
993
301b342c697a
core: use of the new core.log module:
Goffi <goffi@goffi.org>
parents:
922
diff
changeset
|
22 from sat.core.log import getLogger |
301b342c697a
core: use of the new core.log module:
Goffi <goffi@goffi.org>
parents:
922
diff
changeset
|
23 log = getLogger(__name__) |
668 | 24 |
993
301b342c697a
core: use of the new core.log module:
Goffi <goffi@goffi.org>
parents:
922
diff
changeset
|
25 from wokkel import disco, iwokkel |
668 | 26 from zope.interface import implements |
27 # from lxml import etree | |
1542
94901070478e
plugins: added new MissingModule exceptions to plugins using third party modules
Goffi <goffi@goffi.org>
parents:
1396
diff
changeset
|
28 try: |
94901070478e
plugins: added new MissingModule exceptions to plugins using third party modules
Goffi <goffi@goffi.org>
parents:
1396
diff
changeset
|
29 from lxml import html |
94901070478e
plugins: added new MissingModule exceptions to plugins using third party modules
Goffi <goffi@goffi.org>
parents:
1396
diff
changeset
|
30 except ImportError: |
94901070478e
plugins: added new MissingModule exceptions to plugins using third party modules
Goffi <goffi@goffi.org>
parents:
1396
diff
changeset
|
31 raise exceptions.MissingModule(u"Missing module lxml, please download/install it from http://lxml.de/") |
668 | 32 try: |
33 from twisted.words.protocols.xmlstream import XMPPHandler | |
34 except ImportError: | |
35 from wokkel.subprotocols import XMPPHandler | |
36 | |
37 NS_XHTML_IM = 'http://jabber.org/protocol/xhtml-im' | |
38 NS_XHTML = 'http://www.w3.org/1999/xhtml' | |
39 | |
40 PLUGIN_INFO = { | |
41 "name": "XHTML-IM Plugin", | |
42 "import_name": "XEP-0071", | |
43 "type": "XEP", | |
44 "protocols": ["XEP-0071"], | |
45 "dependencies": ["TEXT-SYNTAXES"], | |
46 "main": "XEP_0071", | |
47 "handler": "yes", | |
48 "description": _("""Implementation of XHTML-IM""") | |
49 } | |
50 | |
51 allowed = { | |
52 "a": set(["href", "style", "type"]), | |
53 "blockquote": set(["style"]), | |
54 "body": set(["style"]), | |
55 "br": set([]), | |
56 "cite": set(["style"]), | |
57 "em": set([]), | |
58 "img": set(["alt", "height", "src", "style", "width"]), | |
59 "li": set(["style"]), | |
60 "ol": set(["style"]), | |
61 "p": set(["style"]), | |
62 "span": set(["style"]), | |
63 "strong": set([]), | |
64 "ul": set(["style"]), | |
65 } | |
66 | |
67 styles_allowed = ["background-color", "color", "font-family", "font-size", "font-style", "font-weight", "margin-left", "margin-right", "text-align", "text-decoration"] | |
68 | |
69 blacklist = ['script'] # tag that we have to kill (we don't keep content) | |
70 | |
71 | |
72 class XEP_0071(object): | |
73 SYNTAX_XHTML_IM = "XHTML-IM" | |
74 | |
75 def __init__(self, host): | |
993
301b342c697a
core: use of the new core.log module:
Goffi <goffi@goffi.org>
parents:
922
diff
changeset
|
76 log.info(_("XHTML-IM plugin initialization")) |
668 | 77 self.host = host |
702
a25db3fe3959
plugin XEP-0071: rich messages management for sendMessage
Goffi <goffi@goffi.org>
parents:
701
diff
changeset
|
78 self.synt_plg = self.host.plugins["TEXT-SYNTAXES"] |
a25db3fe3959
plugin XEP-0071: rich messages management for sendMessage
Goffi <goffi@goffi.org>
parents:
701
diff
changeset
|
79 self.synt_plg.addSyntax(self.SYNTAX_XHTML_IM, lambda xhtml: xhtml, self.XHTML2XHTML_IM, [self.synt_plg.OPT_HIDDEN]) |
668 | 80 host.trigger.add("MessageReceived", self.messageReceivedTrigger) |
702
a25db3fe3959
plugin XEP-0071: rich messages management for sendMessage
Goffi <goffi@goffi.org>
parents:
701
diff
changeset
|
81 host.trigger.add("sendMessage", self.sendMessageTrigger) |
668 | 82 |
83 def getHandler(self, profile): | |
84 return XEP_0071_handler(self) | |
85 | |
86 def _messagePostTreat(self, data, body_elt): | |
87 """ Callback which manage the post treatment of the message in case of XHTML-IM found | |
88 @param data: data send by MessageReceived trigger through post_treat deferred | |
89 @param xhtml_im: XHTML-IM body element found | |
90 @return: the data with the extra parameter updated | |
91 """ | |
92 #TODO: check if text only body is empty, then try to convert XHTML-IM to pure text and show a warning message | |
93 def converted(xhtml): | |
94 data['extra']['xhtml'] = xhtml | |
95 return data | |
702
a25db3fe3959
plugin XEP-0071: rich messages management for sendMessage
Goffi <goffi@goffi.org>
parents:
701
diff
changeset
|
96 d = self.synt_plg.convert(body_elt.toXml(), self.SYNTAX_XHTML_IM, safe=True) |
668 | 97 d.addCallback(converted) |
98 return d | |
99 | |
702
a25db3fe3959
plugin XEP-0071: rich messages management for sendMessage
Goffi <goffi@goffi.org>
parents:
701
diff
changeset
|
100 def _sendMessageAddRich(self, mess_data, profile): |
a25db3fe3959
plugin XEP-0071: rich messages management for sendMessage
Goffi <goffi@goffi.org>
parents:
701
diff
changeset
|
101 """ Construct XHTML-IM node and add it XML element |
a25db3fe3959
plugin XEP-0071: rich messages management for sendMessage
Goffi <goffi@goffi.org>
parents:
701
diff
changeset
|
102 @param mess_data: message data as sended by sendMessage callback |
a25db3fe3959
plugin XEP-0071: rich messages management for sendMessage
Goffi <goffi@goffi.org>
parents:
701
diff
changeset
|
103 """ |
a25db3fe3959
plugin XEP-0071: rich messages management for sendMessage
Goffi <goffi@goffi.org>
parents:
701
diff
changeset
|
104 def syntax_converted(xhtml_im): |
a25db3fe3959
plugin XEP-0071: rich messages management for sendMessage
Goffi <goffi@goffi.org>
parents:
701
diff
changeset
|
105 message_elt = mess_data['xml'] |
a25db3fe3959
plugin XEP-0071: rich messages management for sendMessage
Goffi <goffi@goffi.org>
parents:
701
diff
changeset
|
106 html_elt = message_elt.addElement('html', NS_XHTML_IM) |
a25db3fe3959
plugin XEP-0071: rich messages management for sendMessage
Goffi <goffi@goffi.org>
parents:
701
diff
changeset
|
107 body_elt = html_elt.addElement('body', NS_XHTML) |
a25db3fe3959
plugin XEP-0071: rich messages management for sendMessage
Goffi <goffi@goffi.org>
parents:
701
diff
changeset
|
108 body_elt.addRawXml(xhtml_im) |
a25db3fe3959
plugin XEP-0071: rich messages management for sendMessage
Goffi <goffi@goffi.org>
parents:
701
diff
changeset
|
109 mess_data['extra']['xhtml'] = xhtml_im |
a25db3fe3959
plugin XEP-0071: rich messages management for sendMessage
Goffi <goffi@goffi.org>
parents:
701
diff
changeset
|
110 return mess_data |
a25db3fe3959
plugin XEP-0071: rich messages management for sendMessage
Goffi <goffi@goffi.org>
parents:
701
diff
changeset
|
111 |
a25db3fe3959
plugin XEP-0071: rich messages management for sendMessage
Goffi <goffi@goffi.org>
parents:
701
diff
changeset
|
112 syntax = self.synt_plg.getCurrentSyntax(profile) |
832
c4b22aedb7d7
plugin groupblog, XEP-0071, XEP-0277, text_syntaxes: manage raw/rich/xhtml data for content/title:
souliane <souliane@mailoo.org>
parents:
811
diff
changeset
|
113 rich = mess_data['extra'].get('rich', '') |
c4b22aedb7d7
plugin groupblog, XEP-0071, XEP-0277, text_syntaxes: manage raw/rich/xhtml data for content/title:
souliane <souliane@mailoo.org>
parents:
811
diff
changeset
|
114 xhtml = mess_data['extra'].get('xhtml', '') |
c4b22aedb7d7
plugin groupblog, XEP-0071, XEP-0277, text_syntaxes: manage raw/rich/xhtml data for content/title:
souliane <souliane@mailoo.org>
parents:
811
diff
changeset
|
115 if rich: |
c4b22aedb7d7
plugin groupblog, XEP-0071, XEP-0277, text_syntaxes: manage raw/rich/xhtml data for content/title:
souliane <souliane@mailoo.org>
parents:
811
diff
changeset
|
116 d = self.synt_plg.convert(rich, syntax, self.SYNTAX_XHTML_IM) |
c4b22aedb7d7
plugin groupblog, XEP-0071, XEP-0277, text_syntaxes: manage raw/rich/xhtml data for content/title:
souliane <souliane@mailoo.org>
parents:
811
diff
changeset
|
117 if xhtml: |
c4b22aedb7d7
plugin groupblog, XEP-0071, XEP-0277, text_syntaxes: manage raw/rich/xhtml data for content/title:
souliane <souliane@mailoo.org>
parents:
811
diff
changeset
|
118 raise exceptions.DataError(_("Can't have xhtml and rich content at the same time")) |
702
a25db3fe3959
plugin XEP-0071: rich messages management for sendMessage
Goffi <goffi@goffi.org>
parents:
701
diff
changeset
|
119 d.addCallback(syntax_converted) |
a25db3fe3959
plugin XEP-0071: rich messages management for sendMessage
Goffi <goffi@goffi.org>
parents:
701
diff
changeset
|
120 return d |
a25db3fe3959
plugin XEP-0071: rich messages management for sendMessage
Goffi <goffi@goffi.org>
parents:
701
diff
changeset
|
121 |
668 | 122 def messageReceivedTrigger(self, message, post_treat, profile): |
123 """ Check presence of XHTML-IM in message | |
124 """ | |
125 try: | |
126 html_elt = message.elements(NS_XHTML_IM, 'html').next() | |
127 body_elt = html_elt.elements(NS_XHTML, 'body').next() | |
128 # OK, we have found rich text | |
129 post_treat.addCallback(self._messagePostTreat, body_elt) | |
130 except StopIteration: | |
131 # No XHTML-IM | |
132 pass | |
133 return True | |
134 | |
922
c897c8d321b3
core: sendMessageTrigger now manage pre and post treatments, which happen before or after XML generation
Goffi <goffi@goffi.org>
parents:
832
diff
changeset
|
135 def sendMessageTrigger(self, mess_data, pre_xml_treatments, post_xml_treatments, profile): |
702
a25db3fe3959
plugin XEP-0071: rich messages management for sendMessage
Goffi <goffi@goffi.org>
parents:
701
diff
changeset
|
136 """ Check presence of rich text in extra |
a25db3fe3959
plugin XEP-0071: rich messages management for sendMessage
Goffi <goffi@goffi.org>
parents:
701
diff
changeset
|
137 """ |
832
c4b22aedb7d7
plugin groupblog, XEP-0071, XEP-0277, text_syntaxes: manage raw/rich/xhtml data for content/title:
souliane <souliane@mailoo.org>
parents:
811
diff
changeset
|
138 if 'rich' in mess_data['extra'] or 'xhtml' in mess_data['extra']: |
922
c897c8d321b3
core: sendMessageTrigger now manage pre and post treatments, which happen before or after XML generation
Goffi <goffi@goffi.org>
parents:
832
diff
changeset
|
139 post_xml_treatments.addCallback(self._sendMessageAddRich, profile) |
702
a25db3fe3959
plugin XEP-0071: rich messages management for sendMessage
Goffi <goffi@goffi.org>
parents:
701
diff
changeset
|
140 return True |
a25db3fe3959
plugin XEP-0071: rich messages management for sendMessage
Goffi <goffi@goffi.org>
parents:
701
diff
changeset
|
141 |
668 | 142 def _purgeStyle(self, styles_raw): |
143 """ Remove unauthorised styles according to the XEP-0071 | |
144 @param styles_raw: raw styles (value of the style attribute) | |
145 """ | |
146 purged = [] | |
147 | |
148 styles = [style.strip().split(':') for style in styles_raw.split(';')] | |
149 | |
150 for style_tuple in styles: | |
151 if len(style_tuple) != 2: | |
152 continue | |
153 name, value = style_tuple | |
154 name = name.strip() | |
155 if name not in styles_allowed: | |
156 continue | |
157 purged.append((name, value.strip())) | |
158 | |
159 return u'; '.join([u"%s: %s" % data for data in purged]) | |
160 | |
161 def XHTML2XHTML_IM(self, xhtml): | |
162 """ Convert XHTML document to XHTML_IM subset | |
163 @param xhtml: raw xhtml to convert | |
164 """ | |
165 # TODO: more clever tag replacement (replace forbidden tags with equivalents when possible) | |
166 | |
167 parser = html.HTMLParser(remove_comments=True, encoding='utf-8') | |
168 root = html.fromstring(xhtml, parser=parser) | |
169 body_elt = root.find('body') | |
170 if body_elt is None: | |
171 # we use the whole XML as body if no body element is found | |
172 body_elt = html.Element('body') | |
173 body_elt.append(root) | |
174 else: | |
175 body_elt.attrib.clear() | |
176 | |
177 allowed_tags = allowed.keys() | |
178 to_strip = [] | |
179 for elem in body_elt.iter(): | |
180 if elem.tag not in allowed_tags: | |
181 to_strip.append(elem) | |
182 else: | |
183 # we remove unallowed attributes | |
184 attrib = elem.attrib | |
185 att_to_remove = set(attrib).difference(allowed[elem.tag]) | |
186 for att in att_to_remove: | |
187 del(attrib[att]) | |
188 if "style" in attrib: | |
189 attrib["style"] = self._purgeStyle(attrib["style"]) | |
190 | |
191 for elem in to_strip: | |
192 if elem.tag in blacklist: | |
193 #we need to remove the element and all descendants | |
993
301b342c697a
core: use of the new core.log module:
Goffi <goffi@goffi.org>
parents:
922
diff
changeset
|
194 log.debug(u"removing black listed tag: %s" % (elem.tag)) |
668 | 195 elem.drop_tree() |
196 else: | |
197 elem.drop_tag() | |
701
98b2400e17d6
plugin XEP-0071: XHTML2XHTML_IM don't return the <body> root tag anymore.
Goffi <goffi@goffi.org>
parents:
668
diff
changeset
|
198 if len(body_elt) !=1: |
98b2400e17d6
plugin XEP-0071: XHTML2XHTML_IM don't return the <body> root tag anymore.
Goffi <goffi@goffi.org>
parents:
668
diff
changeset
|
199 root_elt = body_elt |
98b2400e17d6
plugin XEP-0071: XHTML2XHTML_IM don't return the <body> root tag anymore.
Goffi <goffi@goffi.org>
parents:
668
diff
changeset
|
200 body_elt.tag = "p" |
98b2400e17d6
plugin XEP-0071: XHTML2XHTML_IM don't return the <body> root tag anymore.
Goffi <goffi@goffi.org>
parents:
668
diff
changeset
|
201 else: |
98b2400e17d6
plugin XEP-0071: XHTML2XHTML_IM don't return the <body> root tag anymore.
Goffi <goffi@goffi.org>
parents:
668
diff
changeset
|
202 root_elt = body_elt[0] |
668 | 203 |
701
98b2400e17d6
plugin XEP-0071: XHTML2XHTML_IM don't return the <body> root tag anymore.
Goffi <goffi@goffi.org>
parents:
668
diff
changeset
|
204 return html.tostring(root_elt, encoding='unicode', method='xml') |
668 | 205 |
206 class XEP_0071_handler(XMPPHandler): | |
207 implements(iwokkel.IDisco) | |
208 | |
209 def __init__(self, plugin_parent): | |
210 self.plugin_parent = plugin_parent | |
211 self.host = plugin_parent.host | |
212 | |
213 def getDiscoInfo(self, requestor, target, nodeIdentifier=''): | |
214 return [disco.DiscoFeature(NS_XHTML_IM)] | |
215 | |
216 def getDiscoItems(self, requestor, target, nodeIdentifier=''): | |
217 return [] |