Update json_schema_compiler to handle the Automation extension API

tools/json_schema_compiler/js_util.py

 # Copyright 2015 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.
 
 from code import Code
 from model import PropertyType
 
 from datetime import datetime
 
 LICENSE = """// Copyright %s The Chromium Authors. All rights reserved.
@@ skipping 83 matching lines @@
                    self._TypeToJsType(namespace_name, function.returns),
                    '', False, function.returns.description)
 
     if function.deprecated:
       c.Append('@deprecated %s' % function.deprecated)
 
     c.Append(self.GetSeeLink(namespace_name, 'method', function.name))
 
     c.Eblock(' */')
 
+  def AppendTypeJsDoc(self, c, namespace_name, js_type):
+    """Appends the documentation for a type as a Code.
+    """
+    c.Append('@type {')
+    c.Concat(self._TypeToJsType(namespace_name, js_type), new_line = False)

[Dan Beam, 2017/01/10 22:54:43]

new_line=False

[dmazzoni, 2017/01/11 22:20:42]

Done.

+    c.Append('}', new_line = False)
+
   def _FunctionToJsFunction(self, namespace_name, function):
     """Converts a model.Function to a JS type (i.e., function([params])...)"""
     c = Code()
     c.Append('function(')
     for i, param in enumerate(function.params):
       c.Concat(self._TypeToJsType(namespace_name, param.type_), new_line=False)
       if i is not len(function.params) - 1:
         c.Append(', ', new_line=False, strip_right=False)
     c.Append('):', new_line=False)
 
@@ skipping 46 matching lines @@
     """Returns a @see link for a given API 'object' (type, method, or event).
     """
 
     # NOTE(devlin): This is kind of a hack. Some APIs will be hosted on
     # developer.chrome.com/apps/ instead of /extensions/, and some APIs have
     # '.'s in them (like app.window), which should resolve to 'app_window'.
     # Luckily, the doc server has excellent url resolution, and knows exactly
     # what we mean. This saves us from needing any complicated logic here.
     return ('@see https://developer.chrome.com/extensions/%s#%s-%s' %
                 (namespace_name, object_type, object_name))