Mercurial > libervia-backend
annotate src/plugins/plugin_adhoc_dbus.py @ 1472:c005c212b538
xmlui: minor docstring fixes
| author | Goffi <goffi@goffi.org> |
|---|---|
| date | Tue, 18 Aug 2015 10:04:47 +0200 |
| parents | 069ad98b360d |
| children | 9a4e95c62380 |
| rev | line source |
|---|---|
| 822 | 1 #!/usr/bin/python |
| 2 # -*- coding: utf-8 -*- | |
| 3 | |
| 4 # SAT plugin for adding D-Bus to Ad-Hoc Commands | |
| 1396 | 5 # Copyright (C) 2009, 2010, 2011, 2012, 2013, 2014, 2015 Jérôme Poisson (goffi@goffi.org) |
| 822 | 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_ | |
|
916
1a759096ccbd
core: use of Const for profile_key + replaced '@DEFAULT@' default profile_key by '@NONE@'
Goffi <goffi@goffi.org>
parents:
822
diff
changeset
|
21 from sat.core.constants import Const as C |
|
993
301b342c697a
core: use of the new core.log module:
Goffi <goffi@goffi.org>
parents:
916
diff
changeset
|
22 from sat.core.log import getLogger |
|
301b342c697a
core: use of the new core.log module:
Goffi <goffi@goffi.org>
parents:
916
diff
changeset
|
23 log = getLogger(__name__) |
| 822 | 24 from twisted.words.protocols.jabber import jid |
| 25 from twisted.internet import defer, reactor | |
| 26 from wokkel import data_form | |
| 27 from lxml import etree | |
| 28 from os import path | |
| 29 import uuid | |
| 30 import dbus | |
| 31 from dbus.mainloop.glib import DBusGMainLoop | |
| 32 DBusGMainLoop(set_as_default=True) | |
| 33 | |
| 34 FD_NAME = "org.freedesktop.DBus" | |
| 35 FD_PATH = "/org/freedekstop/DBus" | |
| 36 INTROSPECT_IFACE = "org.freedesktop.DBus.Introspectable" | |
| 37 | |
| 38 INTROSPECT_METHOD = "Introspect" | |
| 39 IGNORED_IFACES_START = ('org.freedesktop', 'org.qtproject', 'org.kde.KMainWindow') # commands in interface starting with these values will be ignored | |
| 40 FLAG_LOOP = 'LOOP' | |
| 41 | |
| 42 PLUGIN_INFO = { | |
| 43 "name": "Ad-Hoc Commands - D-Bus", | |
| 44 "import_name": "AD_HOC_DBUS", | |
| 45 "type": "Misc", | |
| 46 "protocols": [], | |
| 47 "dependencies": ["XEP-0050"], | |
| 48 "main": "AdHocDBus", | |
| 49 "handler": "no", | |
| 50 "description": _("""Add D-Bus management to Ad-Hoc commands""") | |
| 51 } | |
| 52 | |
| 53 | |
| 54 class AdHocDBus(object): | |
| 55 | |
| 56 def __init__(self, host): | |
|
993
301b342c697a
core: use of the new core.log module:
Goffi <goffi@goffi.org>
parents:
916
diff
changeset
|
57 log.info(_("plugin Ad-Hoc D-Bus initialization")) |
| 822 | 58 self.host = host |
| 59 host.bridge.addMethod("adHocDBusAddAuto", ".plugin", in_sign='sasasasasasass', out_sign='(sa(sss))', | |
| 60 method=self._adHocDBusAddAuto, | |
| 61 async=True) | |
| 62 self.session_bus = dbus.SessionBus() | |
| 63 self.fd_object = self.session_bus.get_object(FD_NAME, FD_PATH, introspect=False) | |
| 64 self.XEP_0050 = host.plugins['XEP-0050'] | |
| 65 | |
| 66 def _DBusAsyncCall(self, proxy, method, *args, **kwargs): | |
| 67 """ Call a DBus method asynchronously and return a deferred | |
| 68 @param proxy: DBus object proxy, as returner by get_object | |
| 69 @param method: name of the method to call | |
| 70 @param args: will be transmitted to the method | |
| 71 @param kwargs: will be transmetted to the method, except for the following poped values: | |
| 72 - interface: name of the interface to use | |
| 73 @return: a deferred | |
| 74 | |
| 75 """ | |
| 76 d = defer.Deferred() | |
| 77 interface = kwargs.pop('interface', None) | |
| 78 kwargs['reply_handler'] = lambda ret=None: d.callback(ret) | |
| 79 kwargs['error_handler'] = d.errback | |
| 80 proxy.get_dbus_method(method, dbus_interface=interface)(*args, **kwargs) | |
| 81 return d | |
| 82 | |
| 83 def _DBusListNames(self): | |
| 84 return self._DBusAsyncCall(self.fd_object, "ListNames") | |
| 85 | |
| 86 def _DBusIntrospect(self, proxy): | |
| 87 return self._DBusAsyncCall(proxy, INTROSPECT_METHOD, interface=INTROSPECT_IFACE) | |
| 88 | |
| 89 def _acceptMethod(self, method): | |
| 90 """ Return True if we accept the method for a command | |
| 91 @param method: etree.Element | |
| 92 @return: True if the method is acceptable | |
| 93 | |
| 94 """ | |
| 95 if method.xpath("arg[@direction='in']"): # we don't accept method with argument for the moment | |
| 96 return False | |
| 97 return True | |
| 98 | |
| 99 @defer.inlineCallbacks | |
| 100 def _introspect(self, methods, bus_name, proxy): | |
|
993
301b342c697a
core: use of the new core.log module:
Goffi <goffi@goffi.org>
parents:
916
diff
changeset
|
101 log.debug("introspecting path [%s]" % proxy.object_path) |
| 822 | 102 introspect_xml = yield self._DBusIntrospect(proxy) |
| 103 el = etree.fromstring(introspect_xml) | |
| 104 for node in el.iterchildren('node', 'interface'): | |
| 105 if node.tag == 'node': | |
| 106 new_path = path.join(proxy.object_path, node.get('name')) | |
| 107 new_proxy = self.session_bus.get_object(bus_name, new_path, introspect=False) | |
| 108 yield self._introspect(methods, bus_name, new_proxy) | |
| 109 elif node.tag == 'interface': | |
| 110 name = node.get('name') | |
| 111 if any(name.startswith(ignored) for ignored in IGNORED_IFACES_START): | |
|
993
301b342c697a
core: use of the new core.log module:
Goffi <goffi@goffi.org>
parents:
916
diff
changeset
|
112 log.debug('interface [%s] is ignored' % name) |
| 822 | 113 continue |
|
993
301b342c697a
core: use of the new core.log module:
Goffi <goffi@goffi.org>
parents:
916
diff
changeset
|
114 log.debug("introspecting interface [%s]" % name) |
| 822 | 115 for method in node.iterchildren('method'): |
| 116 if self._acceptMethod(method): | |
| 117 method_name = method.get('name') | |
|
993
301b342c697a
core: use of the new core.log module:
Goffi <goffi@goffi.org>
parents:
916
diff
changeset
|
118 log.debug("method accepted: [%s]" % method_name) |
| 822 | 119 methods.add((proxy.object_path, name, method_name)) |
| 120 | |
| 121 def _adHocDBusAddAuto(self, prog_name, allowed_jids, allowed_groups, allowed_magics, forbidden_jids, forbidden_groups, flags, profile_key): | |
| 122 return self.adHocDBusAddAuto(prog_name, allowed_jids, allowed_groups, allowed_magics, forbidden_jids, forbidden_groups, flags, profile_key) | |
| 123 | |
| 124 @defer.inlineCallbacks | |
|
916
1a759096ccbd
core: use of Const for profile_key + replaced '@DEFAULT@' default profile_key by '@NONE@'
Goffi <goffi@goffi.org>
parents:
822
diff
changeset
|
125 def adHocDBusAddAuto(self, prog_name, allowed_jids=None, allowed_groups=None, allowed_magics=None, forbidden_jids=None, forbidden_groups=None, flags=None, profile_key=C.PROF_KEY_NONE): |
| 822 | 126 bus_names = yield self._DBusListNames() |
| 127 bus_names = [bus_name for bus_name in bus_names if '.' + prog_name in bus_name] | |
| 128 if not bus_names: | |
|
993
301b342c697a
core: use of the new core.log module:
Goffi <goffi@goffi.org>
parents:
916
diff
changeset
|
129 log.info("Can't find any bus for [%s]" % prog_name) |
| 822 | 130 return |
| 131 bus_names.sort() | |
| 132 for bus_name in bus_names: | |
| 133 if bus_name.endswith(prog_name): | |
| 134 break | |
|
993
301b342c697a
core: use of the new core.log module:
Goffi <goffi@goffi.org>
parents:
916
diff
changeset
|
135 log.info("bus name found: [%s]" % bus_name) |
| 822 | 136 proxy = self.session_bus.get_object(bus_name, '/', introspect=False) |
| 137 methods = set() | |
| 138 | |
| 139 yield self._introspect(methods, bus_name, proxy) | |
| 140 | |
| 141 if methods: | |
| 142 self._addCommand(prog_name, bus_name, methods, | |
| 143 allowed_jids = allowed_jids, | |
| 144 allowed_groups = allowed_groups, | |
| 145 allowed_magics = allowed_magics, | |
| 146 forbidden_jids = forbidden_jids, | |
| 147 forbidden_groups = forbidden_groups, | |
| 148 flags = flags, | |
| 149 profile_key = profile_key) | |
| 150 | |
| 151 defer.returnValue((bus_name, methods)) | |
| 152 | |
| 153 | |
|
916
1a759096ccbd
core: use of Const for profile_key + replaced '@DEFAULT@' default profile_key by '@NONE@'
Goffi <goffi@goffi.org>
parents:
822
diff
changeset
|
154 def _addCommand(self, adhoc_name, bus_name, methods, allowed_jids=None, allowed_groups=None, allowed_magics=None, forbidden_jids=None, forbidden_groups=None, flags=None, profile_key=C.PROF_KEY_NONE): |
| 822 | 155 if flags is None: |
| 156 flags = set() | |
| 157 | |
| 158 def DBusCallback(command_elt, session_data, action, node, profile): | |
| 159 actions = session_data.setdefault('actions',[]) | |
| 160 names_map = session_data.setdefault('names_map', {}) | |
| 161 actions.append(action) | |
| 162 | |
| 163 if len(actions) == 1: | |
| 164 # it's our first request, we ask the desired new status | |
| 165 status = self.XEP_0050.STATUS.EXECUTING | |
| 166 form = data_form.Form('form', title=_('Command selection')) | |
| 167 options = [] | |
| 168 for path, iface, command in methods: | |
| 169 label = command.rsplit('.',1)[-1] | |
| 170 name = str(uuid.uuid4()) | |
| 171 names_map[name] = (path, iface, command) | |
| 172 options.append(data_form.Option(name, label)) | |
| 173 | |
| 174 field = data_form.Field('list-single', 'command', options=options, required=True) | |
| 175 form.addField(field) | |
| 176 | |
| 177 payload = form.toElement() | |
| 178 note = None | |
| 179 | |
| 180 elif len(actions) == 2: | |
| 181 # we should have the answer here | |
| 182 try: | |
| 183 x_elt = command_elt.elements(data_form.NS_X_DATA,'x').next() | |
| 184 answer_form = data_form.Form.fromElement(x_elt) | |
| 185 command = answer_form['command'] | |
| 186 except KeyError, StopIteration: | |
| 187 raise self.XEP_0050.AdHocError(self.XEP_0050.ERROR.BAD_PAYLOAD) | |
| 188 | |
| 189 if command not in names_map: | |
| 190 raise self.XEP_0050.AdHocError(self.XEP_0050.ERROR.BAD_PAYLOAD) | |
| 191 | |
| 192 path, iface, command = names_map[command] | |
| 193 proxy = self.session_bus.get_object(bus_name, path) | |
| 194 | |
| 195 d = self._DBusAsyncCall(proxy, command, interface=iface) | |
| 196 | |
| 197 # job done, we can end the session, except if we have FLAG_LOOP | |
| 198 if FLAG_LOOP in flags: | |
| 199 # We have a loop, so we clear everything and we execute again the command as we had a first call (command_elt is not used, so None is OK) | |
| 200 del actions[:] | |
| 201 names_map.clear() | |
| 202 return DBusCallback(None, session_data, self.XEP_0050.ACTION.EXECUTE, node, profile) | |
| 203 form = data_form.Form('form', title=_(u'Updated')) | |
| 204 form.addField(data_form.Field('fixed', u'Command sent')) | |
| 205 status = self.XEP_0050.STATUS.COMPLETED | |
| 206 payload = None | |
| 207 note = (self.XEP_0050.NOTE.INFO, _(u"Command sent")) | |
| 208 else: | |
| 209 raise self.XEP_0050.AdHocError(self.XEP_0050.ERROR.INTERNAL) | |
| 210 | |
| 211 return (payload, status, None, note) | |
| 212 | |
| 213 self.XEP_0050.addAdHocCommand(DBusCallback, adhoc_name, | |
| 214 allowed_jids = allowed_jids, | |
| 215 allowed_groups = allowed_groups, | |
| 216 allowed_magics = allowed_magics, | |
| 217 forbidden_jids = forbidden_jids, | |
| 218 forbidden_groups = forbidden_groups, | |
| 219 profile_key = profile_key) |