Fix problem with non void return types in extension API IDL.

tools/json_schema_compiler/idl_schema.py

 #! /usr/bin/env python
 # Copyright (c) 2012 The Chromium Authors. All rights reserved.
 # Use of this source code is governed by a BSD-style license that can be
 # found in the LICENSE file.
 
 import itertools
 import json
 import os.path
 import re
 import sys
@@ skipping 70 matching lines @@
     param_comment_start = cur_param.end()
     param_comment_end = next_param.start() if next_param else len(comment)
     params[param_name] = (comment[param_comment_start:param_comment_end
                                   ].strip().replace('\n\n', '<br/><br/>')
                                            .replace('\n', ''))
   return (parent_comment, params)
 
 class Callspec(object):
   '''
   Given a Callspec node representing an IDL function declaration, converts into
-  a name/value pair where the value is a list of function parameters.
+  a tuple:
+      (name, list of function parameters, return type)
   '''
   def __init__(self, callspec_node, comment):
     self.node = callspec_node
     self.comment = comment
 
   def process(self, callbacks):
     parameters = []
+    return_type = None
+    if self.node.GetProperty('TYPEREF') not in ['void', None]:

[asargent_no_longer_on_chrome, 2013/02/26 06:19:47]

tiny nit: I think we typically prefer ('void', None) to ['void', None] for "in"
expressions where the set of items is static

+      return_type = Typeref(self.node.GetProperty('TYPEREF'),
+                            self.node,
+                            {'name': self.node.GetName()}).process(callbacks)
+      # The IDL parser doesn't allow specifying return types as optional.
+      # Instead we infer any object return values to be optional.

[asargent_no_longer_on_chrome, 2013/02/26 06:19:47]

I can whip up a quick CL to add this support to the idl parser - it's just a
matter of supporting a question mark appearing after a type:

 static Foo? myFunc();

Then in the parse tree, in the list of properties for myFunc, there will be
TYPEREF: Foo and OPTIONAL: True.

While I'm there I could also add support for array type return values, so you
could do:

 static long[] myFunc2();

and even optional array types, like:

 static long[]? myFunc3();


It's probably fine to still land this as you currently have it - just add a TODO
comment here saying that we'll want to switch this to looking for an OPTIONAL
entry in the properties. 

+      if return_type.get('type') == 'object' or '$ref' in return_type:
+        return_type['optional'] = True;
     for node in self.node.children:
       parameter = Param(node).process(callbacks)
       if parameter['name'] in self.comment:
         parameter['description'] = self.comment[parameter['name']]
       parameters.append(parameter)
-    return self.node.GetName(), parameters
+    return (self.node.GetName(), parameters, return_type)
 
 class Param(object):
   '''
   Given a Param node representing a function parameter, converts into a Python
   dictionary that the JSON schema compiler expects to see.
   '''
   def __init__(self, param_node):
     self.node = param_node
 
   def process(self, callbacks):
@@ skipping 39 matching lines @@
       if self.node.GetProperty(property_name):
         properties[property_name.lower()] = True
     is_function = False
     parameter_comments = OrderedDict()
     for node in self.node.children:
       if node.cls == 'Comment':
         (parent_comment, parameter_comments) = ProcessComment(node.GetName())
         properties['description'] = parent_comment
       elif node.cls == 'Callspec':
         is_function = True
-        name, parameters = Callspec(node, parameter_comments).process(callbacks)
+        name, parameters, return_type = (Callspec(node, parameter_comments)
+                                         .process(callbacks))
         properties['parameters'] = parameters
+        if return_type is not None:
+          properties['returns'] = return_type
     properties['name'] = name
     if is_function:
       properties['type'] = 'function'
     else:
       properties = Typeref(self.node.GetProperty('TYPEREF'),
                            self.node, properties).process(callbacks)
     enum_values = self.node.GetProperty('legalValues')
     if enum_values:
       if properties['type'] == 'integer':
         enum_values = map(int, enum_values)
@@ skipping 43 matching lines @@
       properties['type'] = 'object'
       if 'additionalProperties' not in properties:
         properties['additionalProperties'] = OrderedDict()
       properties['additionalProperties']['type'] = 'any'
       instance_of = self.parent.GetProperty('instanceOf')
       if instance_of:
         properties['isInstanceOf'] = instance_of
     elif self.typeref == 'ArrayBuffer':
       properties['type'] = 'binary'
       properties['isInstanceOf'] = 'ArrayBuffer'
+    elif self.typeref == 'FileEntry':
+      properties['type'] = 'object'
+      properties['isInstanceOf'] = 'FileEntry'
+      if 'additionalProperties' not in properties:
+        properties['additionalProperties'] = OrderedDict()
+      properties['additionalProperties']['type'] = 'any'
     elif self.typeref is None:
       properties['type'] = 'function'
     else:
       if self.typeref in callbacks:
         # Do not override name and description if they are already specified.
         name = properties.get('name', None)
         description = properties.get('description', None)
         properties.update(callbacks[self.typeref])
         if description is not None:
           properties['description'] = description
@@ skipping 134 matching lines @@
   '''
   Dump a json serialization of parse result for the IDL files whose names
   were passed in on the command line.
   '''
   for filename in sys.argv[1:]:
     schema = Load(filename)
     print json.dumps(schema, indent=2)
 
 if __name__ == '__main__':
   Main()