Add js_interface_generator for generating extensions interfaces

tools/json_schema_compiler/js_externs_generator_test.py

 #!/usr/bin/env python
 # 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.
 
 import idl_schema
 import json_parse
 from js_externs_generator import JsExternsGenerator
 from datetime import datetime
 import model
 import sys
 import unittest
 
-COPYRIGHT = ("""// Copyright %s 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.
-""" % datetime.now().year)
-
-INFO = """// This file was generated by:
-//   %s.
-// NOTE: The format of types has changed. 'FooType' is now
-//   'chrome.%s.FooType'.
-// Please run the closure compiler before committing changes.
-// See https://code.google.com/p/chromium/wiki/ClosureCompilation.
-"""
-
 # The contents of a fake idl file.
 fake_idl = """
 // Copyright 2014 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.
 
 // A totally fake API.
 namespace fakeApi {
   enum Greek {
     ALPHA,
@@ skipping 41 matching lines @@
   };
 
   interface Events {
     // Fired when we realize it's a trap!
     static void onTrapDetected(Baz baz);
   };
 };
 """
 
 # The output we expect from our fake idl file.
-expected_output = COPYRIGHT + "\n" + (INFO % (sys.argv[0], "fakeApi")) + """
+expected_output = ("""// Copyright %s 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.
+
+// This file was generated by:
+//   %s.
+// NOTE: The format of types has changed. 'FooType' is now
+//   'chrome.fakeApi.FooType'.
+// Please run the closure compiler before committing changes.
+// See https://code.google.com/p/chromium/wiki/ClosureCompilation.
+
 /** @fileoverview Externs generated from namespace: fakeApi */
 
 /**
  * @const
  */
 chrome.fakeApi = {};
 
 /**
  * @enum {string}
  * @see https://developer.chrome.com/extensions/fakeApi#type-Greek
@@ skipping 55 matching lines @@
  * @deprecated Use a new method.
  * @see https://developer.chrome.com/extensions/fakeApi#method-returnString
  */
 chrome.fakeApi.returnString = function() {};
 
 /**
  * Fired when we realize it's a trap!
  * @type {!ChromeEvent}
  * @see https://developer.chrome.com/extensions/fakeApi#event-onTrapDetected
  */
-chrome.fakeApi.onTrapDetected;
-"""
+chrome.fakeApi.onTrapDetected;""" % (datetime.now().year, sys.argv[0]))
 
 
 fake_json = """// Copyright 2014 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.
 
 [
   {
     "namespace": "fakeJson",
     "description": "Fake JSON API Stuff",
@@ skipping 52 matching lines @@
         "type": "object",
         "properties": {
           "str": { "type": "string" },
           "int": { "type": "number" }
         }
       }
     } ]
   }
 ]"""
 
-json_expected = COPYRIGHT + "\n" + (INFO % (sys.argv[0], "fakeJson")) + """
+json_expected = ("""// Copyright %s 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.
+
+// This file was generated by:
+//   %s.
+// NOTE: The format of types has changed. 'FooType' is now
+//   'chrome.fakeJson.FooType'.
+// Please run the closure compiler before committing changes.
+// See https://code.google.com/p/chromium/wiki/ClosureCompilation.
+
 /** @fileoverview Externs generated from namespace: fakeJson */
 
 /**
  * @const
  */
 chrome.fakeJson = {};
 
 /**
  * @enum {string}
  * @see https://developer.chrome.com/extensions/fakeJson#type-CrazyEnum
@@ skipping 16 matching lines @@
  *     description that causes problems!
  * @param {function({
  *   str: string
  * }):void} callback The callback to this heinous method
  * @return {{
  *   str: string,
  *   int: number
  * }}
  * @see https://developer.chrome.com/extensions/fakeJson#method-funcWithInlineObj
  */
-chrome.fakeJson.funcWithInlineObj = function(inlineObj, callback) {};
-"""
+chrome.fakeJson.funcWithInlineObj = function(inlineObj, callback) {};""" %
+                 (datetime.now().year, sys.argv[0]))

[Dan Beam, 2015/12/10 22:17:33]

not sure i understand this indent

[stevenjb, 2015/12/10 22:29:04]

Hmm, me neither. I blame my editor. If (when) we need to update this I will fix
it, or in a separate followup.

 
 
 class JsExternGeneratorTest(unittest.TestCase):
   def _GetNamespace(self, fake_content, filename, is_idl):
     """Returns a namespace object for the given content"""
     api_def = (idl_schema.Process(fake_content, filename) if is_idl
         else json_parse.Parse(fake_content))
     m = model.Model()
     return m.AddNamespace(api_def[0], filename)
 
   def setUp(self):
     self.maxDiff = None # Lets us see the full diff when inequal.
 
   def testBasic(self):
     namespace = self._GetNamespace(fake_idl, 'fake_api.idl', True)
     self.assertMultiLineEqual(expected_output,
                               JsExternsGenerator().Generate(namespace).Render())
 
   def testJsonWithInlineObjects(self):
     namespace = self._GetNamespace(fake_json, 'fake_api.json', False)
     self.assertMultiLineEqual(json_expected,
                               JsExternsGenerator().Generate(namespace).Render())
 
 
 if __name__ == '__main__':
   unittest.main()