Update json_schema_compiler to handle the Automation extension API

tools/json_schema_compiler/compiler.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.
 """Generator for C++ structs from api json files.
 
 The purpose of this tool is to remove the need for hand-written code that
 converts to and from base::Value types when receiving javascript api calls.
 Originally written for generating code for extension apis. Reference schemas
 are in chrome/common/extensions/api.
@@ skipping 27 matching lines @@
   'cpp', 'cpp-bundle-registration', 'cpp-bundle-schema', 'externs', 'interface'
 ]
 
 def GenerateSchema(generator_name,
                    file_paths,
                    root,
                    destdir,
                    cpp_namespace_pattern,
                    bundle_name,
                    impl_dir,
-                   include_rules):
+                   include_rules,
+                   no_normalize_enums):
   # Merge the source files into a single list of schemas.
   api_defs = []
   for file_path in file_paths:
     schema = os.path.relpath(file_path, root)
     api_def = SchemaLoader(root).LoadSchema(schema)
 
     # If compiling the C++ model code, delete 'nocompile' nodes.
     if generator_name == 'cpp':
       api_def = json_schema.DeleteNodes(api_def, 'nocompile')
 
@@ skipping 60 matching lines @@
         ('generated_schemas.h', cpp_bundle_generator.schemas_h_generator)
       ]
   elif generator_name == 'cpp':
     cpp_generator = CppGenerator(type_generator)
     generators = [
       ('%s.h' % filename_base, cpp_generator.h_generator),
       ('%s.cc' % filename_base, cpp_generator.cc_generator)
     ]
   elif generator_name == 'externs':
     generators = [
-      ('%s_externs.js' % namespace.unix_name, JsExternsGenerator())
+      ('%s_externs.js' % namespace.unix_name, JsExternsGenerator(
+          no_normalize_enums))
     ]
   elif generator_name == 'interface':
     generators = [
       ('%s_interface.js' % namespace.unix_name, JsInterfaceGenerator())
     ]
   else:
     raise Exception('Unrecognised generator %s' % generator_name)
 
   output_code = []
   for filename, generator in generators:
@@ skipping 36 matching lines @@
   parser.add_option('-g', '--generator', default=GENERATORS[0],
       choices=GENERATORS,
       help='The generator to use to build the output code. Supported values are'
       ' %s' % GENERATORS)
   parser.add_option('-i', '--impl-dir', dest='impl_dir',
       help='The root path of all API implementations')
   parser.add_option('-I', '--include-rules',
       help='A list of paths to include when searching for referenced objects,'
       ' with the namespace separated by a \':\'. Example: '
       '/foo/bar:Foo::Bar::%(namespace)s')
+  parser.add_option('-e', '--no-normalize-enums', action='store_true',
+      dest='no_normalize_enums',

[Devlin, 2017/01/04 23:54:21]

nit: no_normalize_enums sounds funny - maybe we could just do normalize_enums
and default to true?  It might also be worth describing when we'd want to do
this - and probably discouraging it in the general case, since we don't want
most APIs to.

+      help='Do not normalize enums to uppercase with underscores'
+                    ' when generating externs')
 
   (opts, file_paths) = parser.parse_args()
 
   if not file_paths:
     sys.exit(0) # This is OK as a no-op
 
   # Unless in bundle mode, only one file should be specified.
   if (opts.generator not in ('cpp-bundle-registration', 'cpp-bundle-schema') and
       len(file_paths) > 1):
     # TODO(sashab): Could also just use file_paths[0] here and not complain.
     raise Exception(
         "Unless in bundle mode, only one file can be specified at a time.")
 
   def split_path_and_namespace(path_and_namespace):
     if ':' not in path_and_namespace:
       raise ValueError('Invalid include rule "%s". Rules must be of '
                        'the form path:namespace' % path_and_namespace)
     return path_and_namespace.split(':', 1)
 
   include_rules = []
   if opts.include_rules:
     include_rules = map(split_path_and_namespace,
                         shlex.split(opts.include_rules))
 
   result = GenerateSchema(opts.generator, file_paths, opts.root, opts.destdir,
                           opts.namespace, opts.bundle_name, opts.impl_dir,
-                          include_rules)
+                          include_rules, opts.no_normalize_enums)
   if not opts.destdir:
     print result