Add Python flow to bindings generation, move dummy-generating IDL files over

Source/bindings/scripts/idl_compiler.py

+#!/usr/bin/python
+# Copyright (C) 2013 Google Inc. All rights reserved.
+#
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions are
+# met:
+#
+#     * Redistributions of source code must retain the above copyright
+# notice, this list of conditions and the following disclaimer.
+#     * Redistributions in binary form must reproduce the above
+# copyright notice, this list of conditions and the following disclaimer
+# in the documentation and/or other materials provided with the
+# distribution.
+#     * Neither the name of Google Inc. nor the names of its
+# contributors may be used to endorse or promote products derived from
+# this software without specific prior written permission.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+# "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+# LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+# A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+# OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+# LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+# DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+# THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+# (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+# OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+"""Compile an .idl file to Blink V8 bindings (.h and .cpp files).
+
+We are porting the IDL compiler from Perl to Python. The plan is as follows.
+We will temporarily have two build flows (see ../derived_sources.gyp):
+[1] Perl: deprecated_generate_bindings.pl, which calls:
+    deprecated_idl_parser.pm => deprecated_code_generator_v8.pm
+[2] Python: idl_compiler.py, which calls:
+    IDL lexer => IDL parser => Python object builder =>
+    interface dependency resolver => IDL semantic validator =>
+    C++ code generator
+
+We will move IDL files from the Perl build flow [1] to the Python build flow [2]
+incrementally. See http://crbug.com/239771
+"""
+import optparse
+import os
+import shlex
+import sys
+
+import idl_reader
+import code_generator_v8
+
+
+def parse_options():
+    parser = optparse.OptionParser()
+    parser.add_option('--additional-idl-files')
+    parser.add_option('--idl-attributes-file')
+    parser.add_option('--include', dest='idl_directories', action='append')
+    parser.add_option('--output-directory')
+    parser.add_option('--interface-dependencies-file')
+    parser.add_option('--verbose', action='store_true', default=False)
+    parser.add_option('--write-file-only-if-changed', type='int')
+    # ensure output comes last, so command line easy to parse via regexes
+    parser.disable_interspersed_args()
+
+    options, args = parser.parse_args()
+    if options.output_directory is None:
+        parser.error('Must specify output directory using --output-directory.')
+    if options.additional_idl_files is not None:
+        # additional_idl_files is passed as a string with varied (shell-style)
+        # quoting, hence needs parsing.
+        options.additional_idl_files = shlex.split(options.additional_idl_files)
+    if len(args) != 1:
+        parser.error('Must specify exactly 1 input file as argument, but %d given.' % len(args))
+    options.idl_filename = os.path.realpath(args[0])
+    return options
+
+
+def main():
+    options = parse_options()
+    idl_filename = options.idl_filename
+    basename = os.path.basename(idl_filename)
+    interface_name, _ = os.path.splitext(basename)
+    verbose = options.verbose
+    if verbose:
+        print idl_filename
+
+    idl_definitions = idl_reader.read_idl_interface(idl_filename, options.interface_dependencies_file, options.additional_idl_files)
+    # FIXME: add parameters when add validator
+    # idl_definitions = idl_reader.read_idl_interface(idl_filename, options.interface_dependencies_file, options.additional_idl_files, options.idl_attributes_file, verbose=verbose)
+    if not idl_definitions:
+        # We generate dummy .h and .cpp files just to tell build scripts
+        # that outputs have been created.
+        code_generator_v8.generate_dummy_header_and_cpp(interface_name, options.output_directory)
+        return
+    # FIXME: turn on code generator
+    # Currently idl_definitions must be None (so dummy .h and .cpp files are
+    # generated), as actual code generator not present yet.
+    # code_generator_v8.write_interface(idl_definitions, interface_name, options.output_directory)
+    raise RuntimeError('Stub: code generator not implemented yet')
+
+
+if __name__ == '__main__':
+    sys.exit(main())