Revert IDL compiler build flow to Perl, rename 'deprecated'

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 pickle
-import posixpath
-import shlex
-import sys
-
-import code_generator_v8
-import idl_reader
-
-module_path, _ = os.path.split(__file__)
-source_path = os.path.normpath(os.path.join(module_path, os.pardir, os.pardir))
-
-def parse_options():
-    parser = optparse.OptionParser()
-    parser.add_option('--additional-idl-files')
-    # FIXME: The --dump-json-and-pickle option is only for debugging and will
-    # be removed once we complete migrating all IDL files from the Perl flow to
-    # the Python flow.
-    parser.add_option('--dump-json-and-pickle', action='store_true', default=False)
-    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 None:
-        options.additional_idl_files = []
-    else:
-        # 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 get_relative_dir_posix(filename):
-    """Returns directory of a local file relative to Source, in POSIX format."""
-    relative_path_local = os.path.relpath(filename, source_path)
-    relative_dir_local = os.path.dirname(relative_path_local)
-    return relative_dir_local.replace(os.path.sep, posixpath.sep)
-
-
-def write_json_and_pickle(definitions, interface_name, output_directory):
-    json_string = definitions.to_json()
-    json_basename = interface_name + '.json'
-    json_filename = os.path.join(output_directory, json_basename)
-    with open(json_filename, 'w') as json_file:
-        json_file.write(json_string)
-    pickle_basename = interface_name + '.pkl'
-    pickle_filename = os.path.join(output_directory, pickle_basename)
-    with open(pickle_filename, 'wb') as pickle_file:
-        pickle.dump(definitions, pickle_file)
-
-
-def main():
-    options = parse_options()
-    idl_filename = options.idl_filename
-    basename = os.path.basename(idl_filename)
-    interface_name, _ = os.path.splitext(basename)
-    output_directory = options.output_directory
-    verbose = options.verbose
-    if verbose:
-        print idl_filename
-    relative_dir_posix = get_relative_dir_posix(idl_filename)
-
-    reader = idl_reader.IdlReader(options.interface_dependencies_file, options.additional_idl_files, options.idl_attributes_file, output_directory, verbose)
-    definitions = reader.read_idl_definitions(idl_filename)
-    code_generator = code_generator_v8.CodeGeneratorV8(definitions, interface_name, options.output_directory, relative_dir_posix, options.idl_directories, verbose)
-    if not definitions:
-        # We generate dummy .h and .cpp files just to tell build scripts
-        # that outputs have been created.
-        code_generator.write_dummy_header_and_cpp()
-        return
-    if options.dump_json_and_pickle:
-        write_json_and_pickle(definitions, interface_name, output_directory)
-        return
-    code_generator.write_header_and_cpp()
-
-
-if __name__ == '__main__':
-    sys.exit(main())