Move chrome.downloads out of experimental to dev

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 json
 import os.path
 import re
 import sys
 
@@ skipping 19 matching lines @@
   Given the string from a Comment node, parse it into a tuple that looks
   like:
     (
       "The processed comment, minus all |parameter| mentions.",
       {
         'parameter_name_1': "The comment that followed |parameter_name_1|:",
         ...
       }
     )
   '''
-  # Find all the parameter comments of the form "|name|: comment".
+  # Find all the parameter comments of the form '|name|: comment'.
   parameter_comments = re.findall(r'\n *\|([^|]*)\| *: *(.*)', comment)
   # Get the parent comment (everything before the first parameter comment.
   parent_comment = re.sub(r'\n *\|.*', '', comment)
   parent_comment = parent_comment.replace('\n', '').strip()
 
   parsed = {}
   for (name, comment) in parameter_comments:
     parsed[name] = comment.replace('\n', '').strip()
   return (parent_comment, parsed)
 
@@ skipping 44 matching lines @@
         properties[k] = v
     return { 'id': self.node.GetName(),
              'properties': properties,
              'type': 'object' }
 
 class Enum(object):
   '''
   Given an IDL Enum node, converts into a Python dictionary that the JSON
   schema compiler expects to see.
   '''
   def __init__(self, enum_node):

[not at google - send to devlin, 2012/06/04 04:16:49]

please get asargent@ to look at the contents of this file

[benjhayden, 2012/06/04 20:33:15]

Done.

     self.node = enum_node
+    self.description = ''
 
   def process(self, callbacks):
     enum = []
+    enum_type = 'integer'
     for node in self.node.children:
       if node.cls == 'EnumItem':
-        name = node.GetName()
-        enum.append(name)
+        value = node.GetProperty('VALUE')
+        if value:
+          try:
+            value = int(value)
+          except ValueError:
+            try:
+              value = float(value)
+              enum_type = 'double'
+            except ValueError:
+              enum_type = 'string'
+        else:
+          value = node.GetName()
+          enum_type = 'string'
+        enum.append(value)
+      elif node.cls == 'Comment':
+        self.description = ProcessComment(node.GetName())[0]
       else:
-        sys.exit("Did not process %s %s" % (node.cls, node))
-    return { "id" : self.node.GetName(),
-             'enum': enum,
-             'type': 'string' }
-
+        sys.exit('Did not process %s %s' % (node.cls, node))
+    return {'id' : self.node.GetName(),
+            'description': self.description,
+            'type': enum_type,
+            'enum': enum}
 
 
 class Member(object):
   '''
   Given an IDL dictionary or interface member, converts into a name/value pair
   where the value is a Python dictionary that the JSON schema compiler expects
   to see.
   '''
   def __init__(self, member_node):
     self.node = member_node
@@ skipping 79 matching lines @@
         properties['$ref'] = self.typeref
 
     return result
 
 class Namespace(object):
   '''
   Given an IDLNode representing an IDL namespace, converts into a Python
   dictionary that the JSON schema compiler expects to see.
   '''
 
-  def __init__(self, namespace_node, nodoc=False):
+  def __init__(self, namespace_node, description='', nodoc=False,
+      permissions=None):
     self.namespace = namespace_node
     self.nodoc = nodoc
+    self.description = description
     self.events = []
     self.functions = []
     self.types = []
     self.callbacks = {}
+    self.permissions = permissions or []
 
   def process(self):
     for node in self.namespace.children:
       cls = node.cls
-      if cls == "Dictionary":
+      if cls == 'Dictionary':
         self.types.append(Dictionary(node).process(self.callbacks))
-      elif cls == "Callback":
+      elif cls == 'Callback':
         k, v = Member(node).process(self.callbacks)
         self.callbacks[k] = v
-      elif cls == "Interface" and node.GetName() == "Functions":
+      elif cls == 'Interface' and node.GetName() == 'Functions':
         self.functions = self.process_interface(node)
-      elif cls == "Interface" and node.GetName() == "Events":
+      elif cls == 'Interface' and node.GetName() == 'Events':
         self.events = self.process_interface(node)
-      elif cls == "Enum":
+      elif cls == 'Enum':
         self.types.append(Enum(node).process(self.callbacks))
+      elif cls == 'Member':
+        name, properties = Member(node).process(self.callbacks)
+        self.functions.append(properties)
       else:
-        sys.exit("Did not process %s %s" % (node.cls, node))
+        sys.exit('Did not process %s %s' % (node.cls, node))
 
-    return { 'events': self.events,
-             'functions': self.functions,
-             'types': self.types,
-             'namespace': self.namespace.GetName(),
-             'nodoc': self.nodoc }
+    return {'namespace': self.namespace.GetName(),
+            'documentation_permissions_required': self.permissions,
+            'nodoc': self.nodoc,
+            'description': self.description,
+            'types': self.types,
+            'events': self.events,
+            'functions': self.functions}
 
   def process_interface(self, node):
     members = []
     for member in node.children:
       if member.cls == 'Member':
         name, properties = Member(member).process(self.callbacks)
         members.append(properties)
     return members
 
 class IDLSchema(object):
   '''
   Given a list of IDLNodes and IDLAttributes, converts into a Python list
   of api_defs that the JSON schema compiler expects to see.
   '''
 
   def __init__(self, idl):
     self.idl = idl
 
   def process(self):
     namespaces = []
+    description = ''
+    nodoc = False
+    permissions = None
     for node in self.idl:
-      nodoc = False
       cls = node.cls
       if cls == 'Namespace':
-        namespace = Namespace(node, nodoc)
+        namespace = Namespace(node, description, nodoc, permissions)
         namespaces.append(namespace.process())
       elif cls == 'Copyright':
         continue
       elif cls == 'Comment':
+        description = ProcessComment(node.GetName())[0]
         continue
       elif cls == 'ExtAttribute':
         if node.name == 'nodoc':
           nodoc = bool(node.value)
+        elif node.name == 'permissions':
+          permissions = node.value.split(',')
         else:
           continue
       else:
-        sys.exit("Did not process %s %s" % (node.cls, node))
+        sys.exit('Did not process %s %s' % (node.cls, node))
     schema_util.PrefixSchemasWithNamespace(namespaces)
     return namespaces
 
 def Load(filename):
   '''
   Given the filename of an IDL file, parses it and returns an equivalent
   Python dictionary in a format that the JSON schema compiler expects to see.
   '''
 
   f = open(filename, 'r')
   contents = f.read()
   f.close()
 
   idl = idl_parser.IDLParser().ParseData(contents, filename)
   idl_schema = IDLSchema(idl)
   return idl_schema.process()
 
 def Main():
   '''
   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()