sbus_codegen revision b07852825eeb63a78e1b3863e42b3f328430da18
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt#!/usr/bin/env python
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt
ddccd5811feff696ba460dabfb666ce61040f545Andreas Gustafsson#
0c27b3fe77ac1d5094ba3521e8142d9e7973133fMark Andrews# Authors:
ddccd5811feff696ba460dabfb666ce61040f545Andreas Gustafsson# Stef Walter <stefw@redhat.com>
0c27b3fe77ac1d5094ba3521e8142d9e7973133fMark Andrews#
0c27b3fe77ac1d5094ba3521e8142d9e7973133fMark Andrews# Copyright (C) 2014 Red Hat
0c27b3fe77ac1d5094ba3521e8142d9e7973133fMark Andrews#
ddccd5811feff696ba460dabfb666ce61040f545Andreas Gustafsson# This program is free software; you can redistribute it and/or modify
19c7b1a0293498a3e36692c59646ed6e15ffc8d0Tinderbox User# it under the terms of the GNU General Public License as published by
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt# the Free Software Foundation; either version 3 of the License, or
83a28ca274521e15086fc39febde507bcc4e145eMark Andrews# (at your option) any later version.
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt#
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt# This program is distributed in the hope that it will be useful,
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt# but WITHOUT ANY WARRANTY; without even the implied warranty of
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt# GNU General Public License for more details.
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt#
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein# You should have received a copy of the GNU General Public License
ddccd5811feff696ba460dabfb666ce61040f545Andreas Gustafsson# along with this program. If not, see <http://www.gnu.org/licenses/>.
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein#
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein#
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein# Some parser code from GLib
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein#
ddccd5811feff696ba460dabfb666ce61040f545Andreas Gustafsson# Copyright (C) 2008-2011 Red Hat, Inc.
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein#
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein# This library is free software; you can redistribute it and/or
194e2dfffa6a167b8eef0ad11864026b423a1c30Mark Andrews# modify it under the terms of the GNU Lesser General Public
194e2dfffa6a167b8eef0ad11864026b423a1c30Mark Andrews# License as published by the Free Software Foundation; either
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein# version 2 of the License, or (at your option) any later version.
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein#
c1a883f2e04d94e99c433b1f6cfd0c0338f4ed85Mark Andrews# This library is distributed in the hope that it will be useful,
938440694b33cd752e9e4b71a526368b4811c177Tinderbox User# but WITHOUT ANY WARRANTY; without even the implied warranty of
19c7b1a0293498a3e36692c59646ed6e15ffc8d0Tinderbox User# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
0c27b3fe77ac1d5094ba3521e8142d9e7973133fMark Andrews# Lesser General Public License for more details.
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein#
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein# You should have received a copy of the GNU Lesser General
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein# Public License along with this library; if not, write to the
ddccd5811feff696ba460dabfb666ce61040f545Andreas Gustafsson# Free Software Foundation, Inc., 59 Temple Place, Suite 330,
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein# Boston, MA 02111-1307, USA.
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein#
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein# Portions by: David Zeuthen <davidz@redhat.com>
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein#
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein#
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein# DBus interfaces are defined here:
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein#
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein# http://dbus.freedesktop.org/doc/dbus-specification.html#introspection-format
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein#
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein# The introspection data format has become the standard way to represent a
ddccd5811feff696ba460dabfb666ce61040f545Andreas Gustafsson# DBus interface. For many examples see /usr/share/dbus-1/interfaces/ on a
ddccd5811feff696ba460dabfb666ce61040f545Andreas Gustafsson# typical linux machine.
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein#
ddccd5811feff696ba460dabfb666ce61040f545Andreas Gustafsson# A word about annotations. These are extra flags or values that can be
ddccd5811feff696ba460dabfb666ce61040f545Andreas Gustafsson# assigned to anything. So far, the codegen supports this annotation:
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein#
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein# org.freedesktop.DBus.GLib.CSymbol
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein# - An annotation specified in the specification that tells us what C symbol
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein# to generate for a given interface or method. By default the codegen will
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein# build up a symbol name from the DBus name.
ddccd5811feff696ba460dabfb666ce61040f545Andreas Gustafsson#
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austeinfrom __future__ import print_function
ddccd5811feff696ba460dabfb666ce61040f545Andreas Gustafsson
ddccd5811feff696ba460dabfb666ce61040f545Andreas Gustafssonimport optparse
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austeinimport os
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austeinimport re
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austeinimport sys
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austeinimport xml.parsers.expat
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein
ddccd5811feff696ba460dabfb666ce61040f545Andreas Gustafssonif sys.version_info[0] > 2:
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein import io as StringIO
ddccd5811feff696ba460dabfb666ce61040f545Andreas Gustafssonelse:
ddccd5811feff696ba460dabfb666ce61040f545Andreas Gustafsson import StringIO
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein# -----------------------------------------------------------------------------
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein# Objects
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austeinclass DBusXmlException(Exception):
ddccd5811feff696ba460dabfb666ce61040f545Andreas Gustafsson line = 0
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein file = None
ddccd5811feff696ba460dabfb666ce61040f545Andreas Gustafsson
ddccd5811feff696ba460dabfb666ce61040f545Andreas Gustafsson # Lets us print problems like a compiler would
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein def __str__(self):
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein message = Exception.__str__(self)
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein if self.file and self.line:
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein return "%s:%d: %s" % (self.file, self.line, message)
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein elif self.file:
ddccd5811feff696ba460dabfb666ce61040f545Andreas Gustafsson return "%s: %s" % (self.file, message)
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein else:
ddccd5811feff696ba460dabfb666ce61040f545Andreas Gustafsson return message
ddccd5811feff696ba460dabfb666ce61040f545Andreas Gustafsson
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austeinclass Base(object):
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein def __init__(self, name):
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein if not name:
ddccd5811feff696ba460dabfb666ce61040f545Andreas Gustafsson raise DBusXmlException('No name on element')
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein self.name = name
ddccd5811feff696ba460dabfb666ce61040f545Andreas Gustafsson self.annotations = { }
ddccd5811feff696ba460dabfb666ce61040f545Andreas Gustafsson def validate(self):
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein pass
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein def c_name(self):
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein return self.annotations.get("org.freedesktop.DBus.GLib.CSymbol", self.name)
ddccd5811feff696ba460dabfb666ce61040f545Andreas Gustafsson
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein# The basic types that we support marshalling right now. These
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt# are the ones we can pass as basic arguments to libdbus directly.
30eec077db2bdcb6f2a0dc388a3cdde2ede75ec1Mark Andrews# If the dbus and sssd types are identical we pass things directly.
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein# otherwise some copying is necessary.
268a4475065fe6a8cd7cc707820982cf5e98f430Rob AusteinBASIC_TYPES = {
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein 'y': ( "DBUS_TYPE_BYTE", "uint8_t", "uint8_t" ),
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein 'b': ( "DBUS_TYPE_BOOLEAN", "dbus_bool_t", "bool" ),
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein 'n': ( "DBUS_TYPE_INT16", "int16_t", "int16_t" ),
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein 'q': ( "DBUS_TYPE_UINT16", "uint16_t", "uint16_t" ),
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein 'i': ( "DBUS_TYPE_INT32", "int32_t", "int32_t" ),
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein 'u': ( "DBUS_TYPE_UINT32", "uint32_t", "uint32_t" ),
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein 'x': ( "DBUS_TYPE_INT64", "int64_t", "int64_t" ),
821350367e2c7313c02eb275e8e05d5193b47cfdJeremy C. Reed 't': ( "DBUS_TYPE_UINT64", "uint64_t", "uint64_t" ),
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein 'd': ( "DBUS_TYPE_DOUBLE", "double", "double" ),
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein 's': ( "DBUS_TYPE_STRING", "const char *", "const char *" ),
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein 'o': ( "DBUS_TYPE_OBJECT_PATH", "const char *", "const char *" ),
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein}
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austeinclass Typed(Base):
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein def __init__(self, name, type):
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein Base.__init__(self, name)
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein self.type = type
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein self.is_basic = False
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein self.is_array = False
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein self.is_dictionary = False
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein self.dbus_constant = None
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein self.dbus_type = None
8eea877894ea5bcf5cdd9ca124a8601ad421d753Andreas Gustafsson self.sssd_type = None
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein if type[0] == 'a':
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein type = type[1:]
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein self.is_array = True
ddccd5811feff696ba460dabfb666ce61040f545Andreas Gustafsson if "{" in type:
ddccd5811feff696ba460dabfb666ce61040f545Andreas Gustafsson self.is_dictionary = True
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein if type in BASIC_TYPES:
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein (self.dbus_constant, self.dbus_type, self.sssd_type) = BASIC_TYPES[type]
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein # If types are not identical, we can't do array (yet)
ddccd5811feff696ba460dabfb666ce61040f545Andreas Gustafsson if self.is_array:
8eea877894ea5bcf5cdd9ca124a8601ad421d753Andreas Gustafsson self.is_basic = (self.dbus_type == self.sssd_type)
8eea877894ea5bcf5cdd9ca124a8601ad421d753Andreas Gustafsson else:
8eea877894ea5bcf5cdd9ca124a8601ad421d753Andreas Gustafsson self.is_basic = True
8eea877894ea5bcf5cdd9ca124a8601ad421d753Andreas Gustafsson
ddccd5811feff696ba460dabfb666ce61040f545Andreas Gustafssonclass Arg(Typed):
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein def __init__(self, method, name, type):
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein Typed.__init__(self, name, type)
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein self.method = method
ddccd5811feff696ba460dabfb666ce61040f545Andreas Gustafsson
8eea877894ea5bcf5cdd9ca124a8601ad421d753Andreas Gustafssonclass Method(Base):
8eea877894ea5bcf5cdd9ca124a8601ad421d753Andreas Gustafsson def __init__(self, iface, name):
8eea877894ea5bcf5cdd9ca124a8601ad421d753Andreas Gustafsson Base.__init__(self, name)
8eea877894ea5bcf5cdd9ca124a8601ad421d753Andreas Gustafsson self.iface = iface
8eea877894ea5bcf5cdd9ca124a8601ad421d753Andreas Gustafsson self.in_args = []
8eea877894ea5bcf5cdd9ca124a8601ad421d753Andreas Gustafsson self.out_args = []
8eea877894ea5bcf5cdd9ca124a8601ad421d753Andreas Gustafsson def validate(self):
8eea877894ea5bcf5cdd9ca124a8601ad421d753Andreas Gustafsson if not self.only_basic_args() and not self.use_raw_handler():
8eea877894ea5bcf5cdd9ca124a8601ad421d753Andreas Gustafsson raise DBusXmlException("Method has complex arguments and requires " +
8eea877894ea5bcf5cdd9ca124a8601ad421d753Andreas Gustafsson "the 'org.freedesktop.sssd.RawHandler' annotation")
ddccd5811feff696ba460dabfb666ce61040f545Andreas Gustafsson def fq_c_name(self):
ddccd5811feff696ba460dabfb666ce61040f545Andreas Gustafsson return "%s_%s" % (self.iface.c_name(), self.c_name())
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein def use_raw_handler(self):
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein anno = 'org.freedesktop.sssd.RawHandler'
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein return self.annotations.get(anno, self.iface.annotations.get(anno)) == 'true'
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein def in_signature(self):
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein return "".join([arg.type for arg in self.in_args])
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein def only_basic_args(self):
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein for arg in self.in_args + self.out_args:
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein if not arg.is_basic:
ddccd5811feff696ba460dabfb666ce61040f545Andreas Gustafsson return False
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein return True
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austeinclass Signal(Base):
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein def __init__(self, iface, name):
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein Base.__init__(self, name)
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein self.iface = iface
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein self.args = []
ddccd5811feff696ba460dabfb666ce61040f545Andreas Gustafsson def fq_c_name(self):
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein return "%s_%s" % (self.iface.c_name(), self.c_name())
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austeinclass Property(Typed):
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein def __init__(self, iface, name, type, access):
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein Typed.__init__(self, name, type)
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein self.iface = iface
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein self.readable = False
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein self.writable = False
ddccd5811feff696ba460dabfb666ce61040f545Andreas Gustafsson if access == 'readwrite':
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein self.readable = True
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein self.writable = True
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein elif access == 'read':
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein self.readable = True
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein elif access == 'write':
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein self.writable = True
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein else:
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein raise DBusXmlException('Invalid access type %s'%self.access)
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein def fq_c_name(self):
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein return "%s_%s" % (self.iface.c_name(), self.c_name())
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein def get_invoker_name(self):
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein type = self.type
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein type = type.replace("{", "DO")
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein type = type.replace("}", "DE")
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein return type
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt def get_invoker_signature(self, name):
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt sig = "void (*%s)(struct sbus_request *, void *data, " % (name)
30eec077db2bdcb6f2a0dc388a3cdde2ede75ec1Mark Andrews if self.is_dictionary:
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein sig += "hash_table_t **"
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein elif self.is_array:
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein sig += "%s**, int *" % (self.sssd_type)
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein else:
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein sig += "%s*" % (self.sssd_type)
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein sig += ")"
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein return sig
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein def getter_name(self):
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein return "get_%s" % self.c_name()
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein def getter_invoker_name(self):
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein return "sbus_invoke_get_%s" % self.get_invoker_name()
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein def getter_signature(self):
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein return self.get_invoker_signature(self.getter_name())
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austeinclass Interface(Base):
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein def __init__(self, name):
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein Base.__init__(self, name)
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein self.methods = []
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein self.signals = []
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein self.properties = []
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein def c_name(self):
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein return self.annotations.get("org.freedesktop.DBus.GLib.CSymbol",
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein self.name.replace(".", "_"))
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein# -----------------------------------------------------------------------------
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein# Code Generation
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austeindef out(format, *args, **kwargs):
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt str = format % args
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein sys.stdout.write(str)
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein # NOTE: Would like to use the following syntax for this function
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein # but need to wait until python3 until it is supported:
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein # def out(format, *args, new_line=True)
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt if kwargs.pop("new_line", True):
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt sys.stdout.write("\n")
30eec077db2bdcb6f2a0dc388a3cdde2ede75ec1Mark Andrews assert not kwargs, "unknown keyword argument(s): %s" % str(kwargs)
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austeindef method_arg_types(args, with_names=False):
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein str = ""
268a4475065fe6a8cd7cc707820982cf5e98f430Rob Austein for arg in args:
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt str += ", "
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt str += arg.sssd_type
if with_names:
if str[-1] != '*':
str += " "
str += "arg_"
str += arg.c_name()
if arg.is_array:
str += "[], int"
if with_names:
str += " len_"
str += arg.c_name()
return str
def method_function_pointer(meth, name, with_names=False):
if meth.use_raw_handler():
return "sbus_msg_handler_fn " + name
else:
return "int (*%s)(struct sbus_request *%s, void *%s%s)" % \
(name, with_names and "req" or "",
with_names and "data" or "",
method_arg_types(meth.in_args, with_names))
def property_handlers(prop):
return prop.getter_signature()
def forward_method_invoker(signature, args):
out("")
out("/* invokes a handler with a '%s' DBus signature */", signature)
out("static int invoke_%s_method(struct sbus_request *dbus_req, void *function_ptr);", signature)
def source_method_invoker(signature, args):
out("")
out("/* invokes a handler with a '%s' DBus signature */", signature)
out("static int invoke_%s_method(struct sbus_request *dbus_req, void *function_ptr)", signature)
out("{")
for i in range(0, len(args)):
arg = args[i]
if arg.is_array:
out(" %s *arg_%d;", arg.dbus_type, i)
out(" int len_%d;", i)
else:
out(" %s arg_%d;", arg.dbus_type, i)
out(" int (*handler)(struct sbus_request *, void *%s) = function_ptr;", method_arg_types(args))
out("")
out(" if (!sbus_request_parse_or_finish(dbus_req,")
for i in range(0, len(args)):
arg = args[i]
if arg.is_array:
out(" DBUS_TYPE_ARRAY, %s, &arg_%d, &len_%d,",
arg.dbus_constant, i, i)
else:
out(" %s, &arg_%d,", arg.dbus_constant, i)
out(" DBUS_TYPE_INVALID)) {")
out(" return EOK; /* request handled */")
out(" }")
out("")
out(" return (handler)(dbus_req, dbus_req->intf->handler_data", new_line=False)
for i in range(0, len(args)):
arg = args[i]
out(",\n arg_%d", i, new_line=False)
if arg.is_array:
out(",\n len_%d", i, new_line=False)
out(");")
out("}")
def source_prop_types(prop, type_prefix=False):
prefix = "%s_" % prop.type if type_prefix else ""
if prop.is_array:
out(" %s *%sprop_val;", prop.sssd_type, prefix)
out(" int %sprop_len;", prefix)
out(" %s *%sout_val;", prop.dbus_type, prefix)
else:
out(" %s %sprop_val;", prop.sssd_type, prefix)
out(" %s %sout_val;", prop.dbus_type, prefix)
def source_prop_handler(prop, type_prefix=False):
prefix = "%s_" % prop.type if type_prefix else ""
out(" %s", prop.getter_signature("%shandler" % prefix), new_line=False)
out(";")
def forward_method_invokers(ifaces):
invokers = { }
for iface in ifaces:
for meth in iface.methods:
if meth.use_raw_handler() or not meth.in_args:
continue
signature = meth.in_signature()
if signature in invokers:
continue
forward_method_invoker(signature, meth.in_args)
invokers[signature] = meth
return invokers
def source_method_invokers(invokers):
for (signature, meth) in invokers.items():
source_method_invoker(signature, meth.in_args)
def source_finisher(meth):
out("")
out("int %s_finish(struct sbus_request *req%s)",
meth.fq_c_name(), method_arg_types(meth.out_args, with_names=True))
out("{")
for arg in meth.out_args:
if arg.dbus_type != arg.sssd_type:
out(" %s cast_%s = arg_%s;", arg.dbus_type, arg.c_name(), arg.c_name())
out(" return sbus_request_return_and_finish(req,")
for arg in meth.out_args:
out(" ", new_line=False)
if arg.is_array:
out("DBUS_TYPE_ARRAY, %s, &arg_%s, len_%s,",
arg.dbus_constant, arg.c_name(), arg.c_name())
elif arg.dbus_type != arg.sssd_type:
out("%s, &cast_%s,", arg.dbus_constant, arg.c_name())
else:
out("%s, &arg_%s,", arg.dbus_constant, arg.c_name())
out(" DBUS_TYPE_INVALID);")
out("}")
def header_reply(meth):
for arg in meth.out_args:
if arg.is_array:
out(" %s *%s", arg.dbus_type, arg.c_name())
out(" int %s__len", arg.c_name())
else:
out(" %s %s;", arg.dbus_type, arg.c_name())
types = [arg.sssd_type for arg in meth.in_args]
def source_args(parent, args, suffix):
out("")
out("/* arguments for %s.%s */", parent.iface.name, parent.name)
out("const struct sbus_arg_meta %s%s[] = {", parent.fq_c_name(), suffix)
for arg in args:
out(" { \"%s\", \"%s\" },", arg.name, arg.type)
out(" { NULL, }")
out("};")
def source_methods(iface, methods):
for meth in methods:
if meth.in_args:
source_args(meth, meth.in_args, "__in")
if meth.out_args:
source_args(meth, meth.out_args, "__out")
if not meth.use_raw_handler():
source_finisher(meth)
out("")
out("/* methods for %s */", iface.name)
out("const struct sbus_method_meta %s__methods[] = {", iface.c_name())
for meth in methods:
out(" {")
out(" \"%s\", /* name */", meth.name)
if meth.in_args:
out(" %s__in,", meth.fq_c_name())
else:
out(" NULL, /* no in_args */")
if meth.out_args:
out(" %s__out,", meth.fq_c_name())
else:
out(" NULL, /* no out_args */")
out(" offsetof(struct %s, %s),", iface.c_name(), meth.c_name())
if meth.use_raw_handler() or not meth.in_args:
out(" NULL, /* no invoker */")
else:
out(" invoke_%s_method,", meth.in_signature())
out(" },")
out(" { NULL, }")
out("};")
def source_signals(iface, signals):
for sig in iface.signals:
if sig.args:
source_args(sig, sig.args, "__args")
out("")
out("/* signals for %s */", iface.name)
out("const struct sbus_signal_meta %s__signals[] = {", iface.c_name())
for sig in signals:
out(" {")
out(" \"%s\", /* name */", sig.name)
if sig.args:
out(" %s__args", sig.fq_c_name())
else:
out(" NULL, /* no args */")
out(" },")
out(" { NULL, }")
out("};")
def source_properties(iface, properties):
out("")
out("/* property info for %s */", iface.name)
out("const struct sbus_property_meta %s__properties[] = {", iface.c_name())
for prop in properties:
out(" {")
out(" \"%s\", /* name */", prop.name)
out(" \"%s\", /* type */", prop.type)
if prop.readable and prop.writable:
out(" SBUS_PROPERTY_READABLE | SBUS_PROPERTY_WRITABLE,")
elif prop.readable:
out(" SBUS_PROPERTY_READABLE,")
elif prop.writable:
out(" SBUS_PROPERTY_WRITABLE,")
else:
assert False, "should not be reached"
if prop.readable:
out(" offsetof(struct %s, %s),", iface.c_name(), prop.getter_name())
out(" %s,", prop.getter_invoker_name())
else:
out(" 0, /* not readable */")
out(" NULL, /* no invoker */")
out(" 0, /* not writable */")
out(" NULL, /* no invoker */")
out(" },")
out(" { NULL, }")
out("};")
def header_interface(iface):
out("")
out("/* interface info for %s */", iface.name)
out("extern const struct sbus_interface_meta %s_meta;", iface.c_name())
def source_interface(iface):
out("")
out("/* interface info for %s */", iface.name)
out("const struct sbus_interface_meta %s_meta = {", iface.c_name())
out(" \"%s\", /* name */", iface.name)
if iface.methods:
out(" %s__methods,", iface.c_name())
else:
out(" NULL, /* no methods */")
if iface.signals:
out(" %s__signals,", iface.c_name())
else:
out(" NULL, /* no signals */")
if iface.properties:
out(" %s__properties,", iface.c_name())
else:
out(" NULL, /* no properties */")
out(" sbus_invoke_get_all, /* GetAll invoker */")
out("};")
def generate_source(ifaces, filename, include_header=None):
basename = os.path.basename(filename)
out("/* The following definitions are auto-generated from %s */", basename)
out("")
out("#include <stddef.h>")
out("")
out("#include \"dbus/dbus-protocol.h\"")
out("#include \"util/util_errors.h\"")
out("#include \"sbus/sssd_dbus.h\"")
out("#include \"sbus/sssd_dbus_meta.h\"")
out("#include \"sbus/sssd_dbus_invokers.h\"")
if include_header:
out("#include \"%s\"", os.path.basename(include_header))
meth_invokers = forward_method_invokers(ifaces)
for iface in ifaces:
# The methods
if iface.methods:
source_methods(iface, iface.methods)
# The signals array
if iface.signals:
source_signals(iface, iface.signals)
# The properties array
if iface.properties:
source_properties(iface, iface.properties)
# The sbus_interface structure
source_interface(iface)
source_method_invokers(meth_invokers)
def header_finisher(iface, meth):
if meth.use_raw_handler():
return
out("")
out("/* finish function for %s */", meth.name)
out("int %s_finish(struct sbus_request *req%s);",
meth.fq_c_name(), method_arg_types(meth.out_args, with_names=True))
def header_vtable(iface, methods):
out("")
out("/* vtable for %s */", iface.name)
out("struct %s {", iface.c_name())
out(" struct sbus_vtable vtable; /* derive from sbus_vtable */")
# All methods
for meth in iface.methods:
out(" %s;", method_function_pointer(meth, meth.c_name(), with_names=True))
for prop in iface.properties:
out(" %s;", property_handlers(prop))
out("};")
def header_constants(iface):
out("")
out("/* constants for %s */", iface.name)
out("#define %s \"%s\"", iface.c_name().upper(), iface.name)
for meth in iface.methods:
out("#define %s \"%s\"", meth.fq_c_name().upper(), meth.name)
for sig in iface.signals:
out("#define %s \"%s\"", sig.fq_c_name().upper(), sig.name)
for prop in iface.properties:
out("#define %s \"%s\"", prop.fq_c_name().upper(), prop.name)
def generate_header(ifaces, filename):
basename = os.path.basename(filename)
guard = "__%s__" % re.sub(r'([^_A-Z0-9])', "_", basename.upper())
out("/* The following declarations are auto-generated from %s */", basename)
out("")
out("#ifndef %s", guard)
out("#define %s", guard)
out("")
out("#include \"sbus/sssd_dbus.h\"")
out("#include \"sbus/sssd_dbus_meta.h\"")
out("")
out("/* ------------------------------------------------------------------------")
out(" * DBus Constants")
out(" *")
out(" * Various constants of interface and method names mostly for use by clients")
out(" */")
for iface in ifaces:
header_constants(iface)
out("")
out("/* ------------------------------------------------------------------------")
out(" * DBus handlers")
out(" *")
out(" * These structures are filled in by implementors of the different")
out(" * dbus interfaces to handle method calls.")
out(" *")
out(" * Handler functions of type sbus_msg_handler_fn accept raw messages,")
out(" * other handlers are typed appropriately. If a handler that is")
out(" * set to NULL is invoked it will result in a")
out(" * org.freedesktop.DBus.Error.NotSupported error for the caller.")
out(" *")
out(" * Handlers have a matching xxx_finish() function (unless the method has")
out(" * accepts raw messages). These finish functions the")
out(" * sbus_request_return_and_finish() with the appropriate arguments to")
out(" * construct a valid reply. Once a finish function has been called, the")
out(" * @dbus_req it was called with is freed and no longer valid.")
out(" */")
for iface in ifaces:
if iface.methods or iface.properties:
header_vtable(iface, iface.methods)
for meth in iface.methods:
header_finisher(iface, meth)
out("")
out("/* ------------------------------------------------------------------------")
out(" * DBus Interface Metadata")
out(" *")
out(" * These structure definitions are filled in with the information about")
out(" * the interfaces, methods, properties and so on.")
out(" *")
out(" * The actual definitions are found in the accompanying C file next")
out(" * to this header.")
out(" */")
for iface in ifaces:
header_interface(iface)
out("")
out("#endif /* %s */", guard)
# -----------------------------------------------------------------------------
# XML Interface Parsing
STATE_TOP = 'top'
STATE_NODE = 'node'
STATE_INTERFACE = 'interface'
STATE_METHOD = 'method'
STATE_SIGNAL = 'signal'
STATE_PROPERTY = 'property'
STATE_ARG = 'arg'
STATE_ANNOTATION = 'annotation'
STATE_IGNORED = 'ignored'
def expect_attr(attrs, name):
if name not in attrs:
raise DBusXmlException("Missing attribute '%s'" % name)
if attrs[name] == "":
raise DBusXmlException("Empty attribute '%s'" % name)
return attrs[name]
class DBusXMLParser(object):
def __init__(self, filename):
parser = xml.parsers.expat.ParserCreate()
parser.CommentHandler = self.handle_comment
parser.CharacterDataHandler = self.handle_char_data
parser.StartElementHandler = self.handle_start_element
parser.EndElementHandler = self.handle_end_element
self.parsed_interfaces = []
self.cur_object = None
self.state = STATE_TOP
self.state_stack = []
self.cur_object = None
self.cur_object_stack = []
self.arg_count = 0
try:
with open(filename, "rb") as f:
parser.ParseFile(f)
except DBusXmlException as ex:
ex.line = parser.CurrentLineNumber
ex.file = filename
raise
except xml.parsers.expat.ExpatError as ex:
exc = DBusXmlException(str(ex))
exc.line = ex.lineno
exc.file = filename
raise exc
def handle_comment(self, data):
pass
def handle_char_data(self, data):
pass
def handle_start_element(self, name, attrs):
old_state = self.state
old_cur_object = self.cur_object
if self.state == STATE_IGNORED:
self.state = STATE_IGNORED
elif self.cur_object and name == STATE_ANNOTATION:
val = attrs.get('value', '')
self.cur_object.annotations[expect_attr(attrs, 'name')] = val
self.state = STATE_IGNORED
elif self.state == STATE_TOP:
if name == STATE_NODE:
self.state = STATE_NODE
else:
self.state = STATE_IGNORED
elif self.state == STATE_NODE:
if name == STATE_INTERFACE:
self.state = STATE_INTERFACE
iface = Interface(expect_attr(attrs, 'name'))
self.cur_object = iface
self.parsed_interfaces.append(iface)
else:
self.state = STATE_IGNORED
elif self.state == STATE_INTERFACE:
if name == STATE_METHOD:
self.state = STATE_METHOD
method = Method(self.cur_object, expect_attr(attrs, 'name'))
self.cur_object.methods.append(method)
self.cur_object = method
self.arg_count = 0
elif name == STATE_SIGNAL:
self.state = STATE_SIGNAL
signal = Signal(self.cur_object, expect_attr(attrs, 'name'))
self.cur_object.signals.append(signal)
self.cur_object = signal
self.arg_count = 0
elif name == STATE_PROPERTY:
self.state = STATE_PROPERTY
prop = Property(self.cur_object,
expect_attr(attrs, 'name'),
expect_attr(attrs, 'type'),
expect_attr(attrs, 'access'))
self.cur_object.properties.append(prop)
self.cur_object = prop
else:
self.state = STATE_IGNORED
elif self.state == STATE_METHOD:
if name == STATE_ARG:
self.state = STATE_ARG
arg = Arg(self.cur_object,
expect_attr(attrs, 'name'),
expect_attr(attrs, 'type'))
direction = attrs.get('direction', 'in')
if direction == 'in':
self.cur_object.in_args.append(arg)
elif direction == 'out':
self.cur_object.out_args.append(arg)
else:
raise DBusXmlException('Invalid direction "%s"' % direction)
self.cur_object = arg
else:
self.state = STATE_IGNORED
elif self.state == STATE_SIGNAL:
if name == STATE_ARG:
self.state = STATE_ARG
arg = Arg(self.cur_object,
expect_attr(attrs, 'name'),
expect_attr(attrs, 'type'))
self.cur_object.args.append(arg)
self.cur_object = arg
else:
self.state = STATE_IGNORED
elif self.state == STATE_PROPERTY:
self.state = STATE_IGNORED
elif self.state == STATE_ARG:
self.state = STATE_IGNORED
else:
assert False, 'Unhandled state "%s" while entering element with name "%s"' % (self.state, name)
self.state_stack.append(old_state)
self.cur_object_stack.append(old_cur_object)
def handle_end_element(self, name):
if self.cur_object:
self.cur_object.validate()
self.state = self.state_stack.pop()
self.cur_object = self.cur_object_stack.pop()
def parse_options():
parser = optparse.OptionParser("usage: %prog [options] introspect.xml ...")
parser.set_description("sbus_codegen generates sbus interface structures \
from standard XML Introspect data.")
parser.add_option("--mode",
dest="mode", default="header",
help="'header' or 'source' (default: header)",
metavar="MODE")
parser.add_option("--output",
dest="output", default=None,
help="Set output file name (default: stdout)",
metavar="FILE")
parser.add_option("--include",
dest="include", default=None,
help="name of a header to #include",
metavar="HEADER")
(options, args) = parser.parse_args()
if not args:
print("sbus_codegen: no input file specified", file=sys.stderr)
sys.exit(2)
if options.mode not in ["header", "source"]:
print("sbus_codegen: specify --mode=header or --mode=source", file=sys.stderr)
return options, args
def main():
options, args = parse_options()
if options.output:
sys.stdout = buf = StringIO.StringIO()
for filename in args:
parser = DBusXMLParser(filename)
if options.mode == "header":
generate_header(parser.parsed_interfaces, filename)
elif options.mode == "source":
generate_source(parser.parsed_interfaces, filename, options.include)
else:
assert False, "should not be reached"
# Write output at end to be nice to 'make'
if options.output:
output = open(options.output, "w")
output.write(buf.getvalue())
output.close()
if __name__ == "__main__":
try:
main()
except DBusXmlException as ex:
print(str(ex), file=sys.stderr)
sys.exit(1)