[WIP] IDL: Add limited serializer support and use for RTCIceCandidate

Source/bindings/scripts/idl_definitions.py

 # Copyright (C) 2013 Google Inc. All rights reserved.
 #
 # Redistribution and use in source and binary forms, with or without
 # modification, are permitted provided that the following conditions are
 # met:
 #
 #     * Redistributions of source code must retain the above copyright
 # notice, this list of conditions and the following disclaimer.
 #     * Redistributions in binary form must reproduce the above
 # copyright notice, this list of conditions and the following disclaimer
@@ skipping 29 matching lines @@
 
 IdlDefinitions
     IdlCallbackFunction < TypedObject
     IdlEnum :: FIXME: remove, just use a dict for enums
     IdlInterface
         IdlAttribute < TypedObject
         IdlConstant < TypedObject
         IdlLiteral
         IdlOperation < TypedObject
             IdlArgument < TypedObject
+        IdlSerializer
         IdlStringifier
         IdlIterable < IdlIterableOrMaplikeOrSetlike
         IdlMaplike < IdlIterableOrMaplikeOrSetlike
         IdlSetlike < IdlIterableOrMaplikeOrSetlike
     IdlException < IdlInterface
         (same contents as IdlInterface)
 
 TypedObject :: Object with one or more attributes that is a type.
 
 IdlArgument is 'picklable', as it is stored in interfaces_info.
@@ skipping 198 matching lines @@
 
 class IdlInterface(object):
     def __init__(self, idl_name, node=None):
         self.attributes = []
         self.constants = []
         self.constructors = []
         self.custom_constructors = []
         self.extended_attributes = {}
         self.operations = []
         self.parent = None
+        self.serializer = None
         self.stringifier = None
         self.iterable = None
         self.maplike = None
         self.setlike = None
         self.original_interface = None
         self.partial_interfaces = []
         if not node:  # Early exit for IdlException.__init__
             return
 
         self.is_callback = bool(node.GetProperty('CALLBACK'))
@@ skipping 14 matching lines @@
             elif child_class == 'ExtAttributes':
                 extended_attributes = ext_attributes_node_to_extended_attributes(idl_name, child)
                 self.constructors, self.custom_constructors = (
                     extended_attributes_to_constructors(idl_name, extended_attributes))
                 clear_constructor_attributes(extended_attributes)
                 self.extended_attributes = extended_attributes
             elif child_class == 'Operation':
                 self.operations.append(IdlOperation(idl_name, child))
             elif child_class == 'Inherit':
                 self.parent = child.GetName()
+            elif child_class == 'Serializer':
+                self.serializer = IdlSerializer(idl_name, child)
+                self.process_serializer()
             elif child_class == 'Stringifier':
                 self.stringifier = IdlStringifier(idl_name, child)
                 self.process_stringifier()
             elif child_class == 'Iterable':
                 self.iterable = IdlIterable(idl_name, child)
             elif child_class == 'Maplike':
                 self.maplike = IdlMaplike(idl_name, child)
             elif child_class == 'Setlike':
                 self.setlike = IdlSetlike(idl_name, child)
             else:
@@ skipping 14 matching lines @@
             custom_constructor.accept(visitor)
         for operation in self.operations:
             operation.accept(visitor)
         if self.iterable:
             self.iterable.accept(visitor)
         elif self.maplike:
             self.maplike.accept(visitor)
         elif self.setlike:
             self.setlike.accept(visitor)
 
+    def process_serializer(self):
+        """Add the serializer's named operation child, if it has one, as a regular
+        operation of this interface."""
+        if self.serializer.operation:
+            self.operations.append(self.serializer.operation)
+
     def process_stringifier(self):
         """Add the stringifier's attribute or named operation child, if it has
         one, as a regular attribute/operation of this interface."""
         if self.stringifier.attribute:
             self.attributes.append(self.stringifier.attribute)
         elif self.stringifier.operation:
             self.operations.append(self.stringifier.operation)
 
     def merge(self, other):
         """Merge in another interface's members (e.g., partial interface)"""
@@ skipping 153 matching lines @@
     if idl_type == 'NULL':
         return IdlLiteralNull()
     raise ValueError('Unrecognized default value type: %s' % idl_type)
 
 
 ################################################################################
 # Operations
 ################################################################################
 
 class IdlOperation(TypedObject):
+    def __str__(self):
+        return "%s %s(%s)" % (self.idl_type, self.name, ", ".join(str(a) for a in self.arguments))
+
     def __init__(self, idl_name, node=None):
         self.arguments = []
         self.extended_attributes = {}
         self.specials = []
         self.is_constructor = False
         self.idl_name = idl_name
         self.idl_type = None
         self.is_static = False
 
         if not node:
@@ skipping 55 matching lines @@
         visitor.visit_operation(self)
         for argument in self.arguments:
             argument.accept(visitor)
 
 
 ################################################################################
 # Arguments
 ################################################################################
 
 class IdlArgument(TypedObject):
+    def __str__(self):
+        return "%s %s" % (self.idl_type, self.name)
+
     def __init__(self, idl_name, node=None):
         self.extended_attributes = {}
         self.idl_type = None
         self.is_optional = False  # syntax: (optional T)
         self.is_variadic = False  # syntax: (T...)
         self.idl_name = idl_name
         self.default_value = None
 
         if not node:
             return
@@ skipping 35 matching lines @@
     # have None instead of an arguments node, but have the same meaning as using
     # an empty argument list, [Constructor()], so special-case this.
     # http://www.w3.org/TR/WebIDL/#Constructor
     if node is None:
         return []
     return [IdlArgument(idl_name, argument_node)
             for argument_node in node.GetChildren()]
 
 
 ################################################################################
+# Serializers
+################################################################################
+
+class IdlSerializer(object):
+    def __init__(self, idl_name, node):
+        self.attribute_name = node.GetProperty('ATTRIBUTE')
+        self.attribute_names = None
+        self.operation = None
+        self.extended_attributes = {}
+        self.is_attribute = False
+        self.is_getter = False
+        self.is_inherit = False
+        self.is_list = False
+        self.is_map = False
+        self.idl_name = idl_name
+
+        for child in node.GetChildren():
+            child_class = child.GetClass()
+            if child_class == 'Operation':
+                self.operation = IdlOperation(idl_name, child)
+            elif child_class == 'List':
+                self.is_list = True
+                self.is_getter = bool(child.GetProperty('GETTER'))
+                self.attributes = child.GetProperty('ATTRIBUTES')
+            elif child_class == 'Map':
+                self.is_map = True
+                self.is_attribute = bool(child.GetProperty('ATTRIBUTE'))
+                self.is_getter = bool(child.GetProperty('GETTER'))
+                self.is_inherit = bool(child.GetProperty('INHERIT'))
+                self.attributes = child.GetProperty('ATTRIBUTES')
+            elif child_class == 'ExtAttributes':
+                self.extended_attributes = ext_attributes_node_to_extended_attributes(idl_name, child)
+            else:
+                raise ValueError('Unrecognized node class: %s' % child_class)
+
+
+################################################################################
 # Stringifiers
 ################################################################################
 
 class IdlStringifier(object):
     def __init__(self, idl_name, node):
         self.attribute = None
         self.operation = None
         self.extended_attributes = {}
         self.idl_name = idl_name
 
@@ skipping 364 matching lines @@
         self.visit_typed_object(argument)
 
     def visit_iterable(self, iterable):
         self.visit_typed_object(iterable)
 
     def visit_maplike(self, maplike):
         self.visit_typed_object(maplike)
 
     def visit_setlike(self, setlike):
         self.visit_typed_object(setlike)