Chromium Code Reviews| OLD | NEW |
|---|---|
| 1 #!/usr/bin/env python | 1 #!/usr/bin/env python |
| 2 # Copyright (c) 2012 The Chromium Authors. All rights reserved. | 2 # Copyright (c) 2012 The Chromium Authors. All rights reserved. |
| 3 # Use of this source code is governed by a BSD-style license that can be | 3 # Use of this source code is governed by a BSD-style license that can be |
| 4 # found in the LICENSE file. | 4 # found in the LICENSE file. |
| 5 """Generator for C++ structs from api json files. | 5 """Generator for C++ structs from api json files. |
| 6 | 6 |
| 7 The purpose of this tool is to remove the need for hand-written code that | 7 The purpose of this tool is to remove the need for hand-written code that |
| 8 converts to and from base::Value types when receiving javascript api calls. | 8 converts to and from base::Value types when receiving javascript api calls. |
| 9 Originally written for generating code for extension apis. Reference schemas | 9 Originally written for generating code for extension apis. Reference schemas |
| 10 are in chrome/common/extensions/api. | 10 are in chrome/common/extensions/api. |
| 11 | 11 |
| 12 Usage example: | 12 Usage example: |
| 13 compiler.py --root /home/Work/src --namespace extensions windows.json | 13 compiler.py --root /home/Work/src --namespace extensions windows.json |
| 14 tabs.json | 14 tabs.json |
| 15 compiler.py --destdir gen --root /home/Work/src | 15 compiler.py --destdir gen --root /home/Work/src |
| 16 --namespace extensions windows.json tabs.json | 16 --namespace extensions windows.json tabs.json |
| 17 """ | 17 """ |
| 18 | 18 |
| 19 import cc_generator | 19 import cc_generator |
| 20 import cpp_type_generator | 20 import cpp_type_generator |
| 21 import h_bundle_generator | |
| 21 import h_generator | 22 import h_generator |
| 22 import idl_schema | 23 import idl_schema |
| 23 import json_schema | 24 import json_schema |
| 24 import model | 25 import model |
| 25 import optparse | 26 import optparse |
| 26 import os.path | 27 import os.path |
| 27 import sys | 28 import sys |
| 28 | 29 |
| 29 if __name__ == '__main__': | 30 def load_schema(schema): |
| 30 parser = optparse.OptionParser( | 31 schema_filename, schema_extension = os.path.splitext(schema) |
| 31 description='Generates a C++ model of an API from JSON schema', | |
| 32 usage='usage: %prog [option]... schema') | |
| 33 parser.add_option('-r', '--root', default='.', | |
| 34 help='logical include root directory. Path to schema files from specified' | |
| 35 'dir will be the include path.') | |
| 36 parser.add_option('-d', '--destdir', | |
| 37 help='root directory to output generated files.') | |
| 38 parser.add_option('-n', '--namespace', default='generated_api_schemas', | |
| 39 help='C++ namespace for generated files. e.g extensions::api.') | |
| 40 | 32 |
| 41 (opts, args) = parser.parse_args() | |
| 42 if not args: | |
| 43 sys.exit(parser.get_usage()) | |
| 44 dest_dir = opts.destdir | |
| 45 root_namespace = opts.namespace | |
| 46 | |
| 47 schema = os.path.normpath(args[0]) | |
| 48 | |
| 49 api_model = model.Model() | |
| 50 | |
| 51 # Actually generate for source file. | |
| 52 schema_filename, schema_extension = os.path.splitext(schema) | |
| 53 if schema_extension == '.json': | 33 if schema_extension == '.json': |
| 54 api_defs = json_schema.Load(schema) | 34 api_defs = json_schema.Load(schema) |
| 55 elif schema_extension == '.idl': | 35 elif schema_extension == '.idl': |
| 56 api_defs = idl_schema.Load(schema) | 36 api_defs = idl_schema.Load(schema) |
| 57 else: | 37 else: |
| 58 sys.exit("Did not recognize file extension %s for schema %s" % | 38 sys.exit("Did not recognize file extension %s for schema %s" % |
| 59 (schema_extension, schema)) | 39 (schema_extension, schema)) |
| 60 | 40 |
| 41 return api_defs | |
| 42 | |
| 43 def handle_single_schema(filename, dest_dir, root, root_namespace): | |
| 44 schema = os.path.normpath(filename) | |
| 45 schema_filename, schema_extension = os.path.splitext(schema) | |
| 46 api_defs = load_schema(schema) | |
| 47 | |
| 48 api_model = model.Model() | |
| 49 | |
| 61 for target_namespace in api_defs: | 50 for target_namespace in api_defs: |
| 62 referenced_schemas = target_namespace.get('dependencies', []) | 51 referenced_schemas = target_namespace.get('dependencies', []) |
| 63 # Load type dependencies into the model. | 52 # Load type dependencies into the model. |
| 64 # TODO(miket): do we need this in IDL? | 53 # TODO(miket): do we need this in IDL? |
| 65 for referenced_schema in referenced_schemas: | 54 for referenced_schema in referenced_schemas: |
| 66 referenced_schema_path = os.path.join( | 55 referenced_schema_path = os.path.join( |
| 67 os.path.dirname(schema), referenced_schema + '.json') | 56 os.path.dirname(schema), referenced_schema + '.json') |
| 68 referenced_api_defs = json_schema.Load(referenced_schema_path) | 57 referenced_api_defs = json_schema.Load(referenced_schema_path) |
| 69 | 58 |
| 70 for namespace in referenced_api_defs: | 59 for namespace in referenced_api_defs: |
| (...skipping 32 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... | |
| 103 'w') as h_file: | 92 'w') as h_file: |
| 104 h_file.write(h_code) | 93 h_file.write(h_code) |
| 105 else: | 94 else: |
| 106 print '%s.h' % out_file | 95 print '%s.h' % out_file |
| 107 print | 96 print |
| 108 print h_code | 97 print h_code |
| 109 print | 98 print |
| 110 print '%s.cc' % out_file | 99 print '%s.cc' % out_file |
| 111 print | 100 print |
| 112 print cc_code | 101 print cc_code |
| 102 | |
| 103 def handle_bundle_schema(filenames, dest_dir, root, root_namespace): | |
| 104 # Merge the source files into a single list of schemas. | |
| 105 api_defs = [] | |
| 106 for filename in filenames: | |
| 107 schema = os.path.normpath(filename) | |
| 108 schema_filename, schema_extension = os.path.splitext(schema) | |
| 109 api_defs.extend(load_schema(schema)) | |
| 110 | |
| 111 api_model = model.Model() | |
| 112 relpath = os.path.relpath(os.path.normpath(filenames[0]), root) | |
| 113 for target_namespace in api_defs: | |
| 114 api_model.AddNamespace(target_namespace, relpath) | |
| 115 | |
| 116 type_generator = cpp_type_generator.CppTypeGenerator(root_namespace) | |
| 117 for referenced_namespace in api_model.namespaces.values(): | |
| 118 type_generator.AddNamespace( | |
| 119 referenced_namespace, | |
| 120 referenced_namespace.unix_name) | |
| 121 | |
| 122 h_bundle_code = (h_bundle_generator.HBundleGenerator(api_model, | |
| 123 type_generator) | |
| 124 .Generate().Render()) | |
|
asargent_no_longer_on_chrome
2012/03/14 22:46:07
nit: the indentation looks a little weird here. Ev
miket_OOO
2012/03/14 22:55:16
Done.
| |
| 125 | |
| 126 out_file = 'generated_api' | |
| 127 if dest_dir: | |
| 128 with open( | |
| 129 os.path.join(dest_dir, 'chrome/common/extensions/api/generated_api.h'), | |
| 130 'w') as h_file: | |
| 131 h_file.write(h_bundle_code) | |
| 132 else: | |
| 133 print '%s.h' % out_file | |
| 134 print | |
| 135 print h_bundle_code | |
| 136 | |
| 137 if __name__ == '__main__': | |
| 138 parser = optparse.OptionParser( | |
| 139 description='Generates a C++ model of an API from JSON schema', | |
| 140 usage='usage: %prog [option]... schema') | |
| 141 parser.add_option('-r', '--root', default='.', | |
| 142 help='logical include root directory. Path to schema files from specified' | |
| 143 'dir will be the include path.') | |
| 144 parser.add_option('-d', '--destdir', | |
| 145 help='root directory to output generated files.') | |
| 146 parser.add_option('-n', '--namespace', default='generated_api_schemas', | |
| 147 help='C++ namespace for generated files. e.g extensions::api.') | |
| 148 parser.add_option('-b', '--bundle', action="store_true", help= | |
| 149 '''if supplied, causes compiler to generate bundle files for the given set of | |
| 150 source files.''') | |
| 151 | |
| 152 (opts, args) = parser.parse_args() | |
| 153 | |
| 154 if not args: | |
| 155 sys.exit(0) # This is OK as a no-op | |
| 156 dest_dir = opts.destdir | |
| 157 root_namespace = opts.namespace | |
| 158 | |
| 159 if opts.bundle: | |
| 160 handle_bundle_schema(args, dest_dir, opts.root, root_namespace) | |
| 161 else: | |
| 162 handle_single_schema(args[0], dest_dir, opts.root, root_namespace) | |
| OLD | NEW |