| # 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. |
| |
| """Read an IDL file or complete IDL interface, producing an IdlDefinitions object.""" |
| |
| import os.path |
| |
| import blink_idl_parser |
| import idl_definitions_builder |
| import idl_validator |
| import interface_dependency_resolver |
| |
| |
| class IdlReader: |
| def __init__(self, interface_dependencies_filename=None, additional_idl_filenames=None, idl_attributes_filename=None, outputdir='', verbose=False): |
| if idl_attributes_filename: |
| self.extended_attribute_validator = idl_validator.IDLExtendedAttributeValidator(idl_attributes_filename) |
| else: |
| self.extended_attribute_validator = None |
| |
| if interface_dependencies_filename: |
| self.interface_dependency_resolver = interface_dependency_resolver.InterfaceDependencyResolver(interface_dependencies_filename, additional_idl_filenames, self) |
| else: |
| self.interface_dependency_resolver = None |
| |
| self.parser = blink_idl_parser.BlinkIDLParser(outputdir=outputdir, verbose=verbose) |
| |
| def read_idl_definitions(self, idl_filename): |
| """Returns an IdlDefinitions object for an IDL file, including all dependencies.""" |
| basename = os.path.basename(idl_filename) |
| interface_name, _ = os.path.splitext(basename) |
| definitions = self.read_idl_file(idl_filename) |
| if self.interface_dependency_resolver: |
| should_generate_bindings = self.interface_dependency_resolver.resolve_dependencies(definitions, interface_name) |
| if not should_generate_bindings: |
| return None |
| return definitions |
| |
| def read_idl_file(self, idl_filename): |
| """Returns an IdlDefinitions object for an IDL file, without any dependencies.""" |
| ast = blink_idl_parser.parse_file(self.parser, idl_filename) |
| definitions = idl_definitions_builder.build_idl_definitions_from_ast(ast) |
| if self.extended_attribute_validator: |
| try: |
| self.extended_attribute_validator.validate_extended_attributes(definitions) |
| except idl_validator.IDLInvalidExtendedAttributeError as error: |
| raise idl_validator.IDLInvalidExtendedAttributeError("""IDL ATTRIBUTE ERROR in file %s: |
| %s |
| If you want to add a new IDL extended attribute, please add it to |
| bindings/IDLExtendedAttributes.txt |
| and add an explanation to the Blink IDL documentation at: |
| http://www.chromium.org/blink/webidl/blink-idl-extended-attributes |
| """ % (idl_filename, str(error))) |
| |
| return definitions |