IDL compiler: delete Perl compiler, remove unstable/ directory

Source/bindings/scripts/unstable/v8_attributes.py

Index: Source/bindings/scripts/unstable/v8_attributes.py
diff --git a/Source/bindings/scripts/unstable/v8_attributes.py b/Source/bindings/scripts/unstable/v8_attributes.py
deleted file mode 100644
index 6af95ae469f84343c1992d6187e1035d3f8f0be8..0000000000000000000000000000000000000000
--- a/Source/bindings/scripts/unstable/v8_attributes.py
+++ /dev/null
@@ -1,398 +0,0 @@
-# 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.
-
-"""Generate template values for attributes.
-
-FIXME: Not currently used in build.
-This is a rewrite of the Perl IDL compiler in Python, but is not complete.
-Once it is complete, we will switch all IDL files over to Python at once.
-Until then, please work on the Perl IDL compiler.
-For details, see bug http://crbug.com/239771
-"""
-
-from v8_globals import includes, interfaces
-import v8_types
-import v8_utilities
-from v8_utilities import capitalize, cpp_name, has_extended_attribute, uncapitalize
-
-
-def generate_attribute(interface, attribute):
-    idl_type = attribute.idl_type
-    extended_attributes = attribute.extended_attributes
-
-    v8_types.add_includes_for_type(idl_type)
-
-    # [CheckSecurity]
-    is_check_security_for_node = 'CheckSecurity' in extended_attributes
-    if is_check_security_for_node:
-        includes.add('bindings/v8/BindingSecurity.h')
-    # [Custom]
-    has_custom_getter = ('Custom' in extended_attributes and
-                         extended_attributes['Custom'] in [None, 'Getter'])
-    has_custom_setter = (not attribute.is_read_only and
-                         'Custom' in extended_attributes and
-                         extended_attributes['Custom'] in [None, 'Setter'])
-    # [CustomElementCallbacks], [Reflect]
-    is_custom_element_callbacks = 'CustomElementCallbacks' in extended_attributes
-    is_reflect = 'Reflect' in extended_attributes
-    if is_custom_element_callbacks or is_reflect:
-        includes.add('core/dom/custom/CustomElementCallbackDispatcher.h')
-    # [RaisesException], [RaisesException=Setter]
-    is_setter_raises_exception = (
-        'RaisesException' in extended_attributes and
-        extended_attributes['RaisesException'] in [None, 'Setter'])
-    # [StrictTypeChecking]
-    has_strict_type_checking = (
-        ('StrictTypeChecking' in extended_attributes or
-         'StrictTypeChecking' in interface.extended_attributes) and
-        v8_types.is_wrapper_type(idl_type))
-
-    if (idl_type == 'EventHandler' and
-        interface.name in ['Window', 'WorkerGlobalScope'] and
-        attribute.name == 'onerror'):
-        includes.add('bindings/v8/V8ErrorHandler.h')
-
-    contents = {
-        'access_control_list': access_control_list(attribute),
-        'activity_logging_world_list_for_getter': v8_utilities.activity_logging_world_list(attribute, 'Getter'),  # [ActivityLogging]
-        'activity_logging_world_list_for_setter': v8_utilities.activity_logging_world_list(attribute, 'Setter'),  # [ActivityLogging]
-        'cached_attribute_validation_method': extended_attributes.get('CachedAttribute'),
-        'conditional_string': v8_utilities.conditional_string(attribute),
-        'constructor_type': v8_types.constructor_type(idl_type)
-                            if is_constructor_attribute(attribute) else None,
-        'cpp_name': cpp_name(attribute),
-        'cpp_type': v8_types.cpp_type(idl_type),
-        'deprecate_as': v8_utilities.deprecate_as(attribute),  # [DeprecateAs]
-        'enum_validation_expression':
-            v8_utilities.enum_validation_expression(idl_type),
-        'has_custom_getter': has_custom_getter,
-        'has_custom_setter': has_custom_setter,
-        'has_strict_type_checking': has_strict_type_checking,
-        'idl_type': idl_type,
-        'is_call_with_execution_context': v8_utilities.has_extended_attribute_value(attribute, 'CallWith', 'ExecutionContext'),
-        'is_check_security_for_node': is_check_security_for_node,
-        'is_custom_element_callbacks': is_custom_element_callbacks,
-        'is_expose_js_accessors': 'ExposeJSAccessors' in extended_attributes,
-        'is_getter_raises_exception': (  # [RaisesException]
-            'RaisesException' in extended_attributes and
-            extended_attributes['RaisesException'] in [None, 'Getter']),
-        'is_implemented_by': 'ImplementedBy' in extended_attributes,
-        'is_initialized_by_event_constructor':
-            'InitializedByEventConstructor' in extended_attributes,
-        'is_keep_alive_for_gc': is_keep_alive_for_gc(interface, attribute),
-        'is_nullable': attribute.is_nullable,
-        'is_per_world_bindings': 'PerWorldBindings' in extended_attributes,
-        'is_read_only': attribute.is_read_only,
-        'is_reflect': is_reflect,
-        'is_replaceable': 'Replaceable' in attribute.extended_attributes,
-        'is_setter_call_with_execution_context': v8_utilities.has_extended_attribute_value(attribute, 'SetterCallWith', 'ExecutionContext'),
-        'is_setter_raises_exception': is_setter_raises_exception,
-        'has_setter_exception_state': (
-            is_setter_raises_exception or has_strict_type_checking or
-            v8_types.is_integer_type(idl_type)),
-        'is_static': attribute.is_static,
-        'is_url': 'URL' in extended_attributes,
-        'is_unforgeable': 'Unforgeable' in extended_attributes,
-        'measure_as': v8_utilities.measure_as(attribute),  # [MeasureAs]
-        'name': attribute.name,
-        'per_context_enabled_function': v8_utilities.per_context_enabled_function_name(attribute),  # [PerContextEnabled]
-        'property_attributes': property_attributes(attribute),
-        'put_forwards': 'PutForwards' in extended_attributes,
-        'reflect_empty': extended_attributes.get('ReflectEmpty'),
-        'reflect_invalid': extended_attributes.get('ReflectInvalid', ''),
-        'reflect_missing': extended_attributes.get('ReflectMissing'),
-        'reflect_only': extended_attributes['ReflectOnly'].split('|')
-            if 'ReflectOnly' in extended_attributes else None,
-        'setter_callback': setter_callback_name(interface, attribute),
-        'v8_type': v8_types.v8_type(idl_type),
-        'runtime_enabled_function': v8_utilities.runtime_enabled_function_name(attribute),  # [RuntimeEnabled]
-        'world_suffixes': ['', 'ForMainWorld']
-                          if 'PerWorldBindings' in extended_attributes
-                          else [''],  # [PerWorldBindings]
-    }
-
-    if is_constructor_attribute(attribute):
-        return contents
-    if not has_custom_getter:
-        generate_getter(interface, attribute, contents)
-    if (not has_custom_setter and
-        (not attribute.is_read_only or 'PutForwards' in extended_attributes)):
-        generate_setter(interface, attribute, contents)
-
-    return contents
-
-
-################################################################################
-# Getter
-################################################################################
-
-def generate_getter(interface, attribute, contents):
-    idl_type = attribute.idl_type
-    extended_attributes = attribute.extended_attributes
-
-    cpp_value = getter_expression(interface, attribute, contents)
-    # Normally we can inline the function call into the return statement to
-    # avoid the overhead of using a Ref<> temporary, but for some cases
-    # (nullable types, EventHandler, [CachedAttribute], or if there are
-    # exceptions), we need to use a local variable.
-    # FIXME: check if compilers are smart enough to inline this, and if so,
-    # always use a local variable (for readability and CG simplicity).
-    release = False
-    if (attribute.is_nullable or
-        idl_type == 'EventHandler' or
-        'CachedAttribute' in extended_attributes or
-        contents['is_getter_raises_exception']):
-        contents['cpp_value_original'] = cpp_value
-        cpp_value = 'jsValue'
-        # EventHandler has special handling
-        if idl_type != 'EventHandler' and v8_types.is_interface_type(idl_type):
-            release = True
-
-    if 'ReflectOnly' in extended_attributes:
-        contents['cpp_value_original'] = cpp_value
-        # FIXME: rename to jsValue
-        cpp_value = 'resultValue'
-
-    def v8_set_return_value_statement(for_main_world=False):
-        if contents['is_keep_alive_for_gc']:
-            return 'v8SetReturnValue(info, wrapper)'
-        return v8_types.v8_set_return_value(idl_type, cpp_value, extended_attributes=extended_attributes, script_wrappable='imp', release=release, for_main_world=for_main_world)
-
-    contents.update({
-        'cpp_value': cpp_value,
-        'v8_set_return_value_for_main_world': v8_set_return_value_statement(for_main_world=True),
-        'v8_set_return_value': v8_set_return_value_statement(),
-    })
-
-
-def getter_expression(interface, attribute, contents):
-    arguments = []
-    this_getter_base_name = getter_base_name(interface, attribute, arguments)
-    getter_name = v8_utilities.scoped_name(interface, attribute, this_getter_base_name)
-
-    arguments.extend(v8_utilities.call_with_arguments(attribute))
-    if ('ImplementedBy' in attribute.extended_attributes and
-        not attribute.is_static):
-        arguments.append('*imp')
-    if attribute.is_nullable:
-        arguments.append('isNull')
-    if contents['is_getter_raises_exception']:
-        arguments.append('exceptionState')
-    return '%s(%s)' % (getter_name, ', '.join(arguments))
-
-
-CONTENT_ATTRIBUTE_GETTER_NAMES = {
-    'boolean': 'fastHasAttribute',
-    'long': 'getIntegralAttribute',
-    'unsigned long': 'getUnsignedIntegralAttribute',
-}
-
-
-def getter_base_name(interface, attribute, arguments):
-    extended_attributes = attribute.extended_attributes
-    if 'Reflect' not in extended_attributes:
-        return uncapitalize(cpp_name(attribute))
-
-    content_attribute_name = extended_attributes['Reflect'] or attribute.name.lower()
-    if content_attribute_name in ['class', 'id', 'name']:
-        # Special-case for performance optimization.
-        return 'get%sAttribute' % content_attribute_name.capitalize()
-
-    arguments.append(scoped_content_attribute_name(interface, attribute))
-
-    idl_type = attribute.idl_type
-    if idl_type in CONTENT_ATTRIBUTE_GETTER_NAMES:
-        return CONTENT_ATTRIBUTE_GETTER_NAMES[idl_type]
-    if 'URL' in attribute.extended_attributes:
-        return 'getURLAttribute'
-    return 'fastGetAttribute'
-
-
-def is_keep_alive_for_gc(interface, attribute):
-    idl_type = attribute.idl_type
-    extended_attributes = attribute.extended_attributes
-    return (
-        # For readonly attributes, for performance reasons we keep the attribute
-        # wrapper alive while the owner wrapper is alive, because the attribute
-        # never changes.
-        (attribute.is_read_only and
-         v8_types.is_wrapper_type(idl_type) and
-         # There are some exceptions, however:
-         not(
-             # Node lifetime is managed by object grouping.
-             v8_types.inherits_interface(interface.name, 'Node') or
-             v8_types.inherits_interface(idl_type, 'Node') or
-             # A self-reference is unnecessary.
-             attribute.name == 'self' or
-             # FIXME: Remove these hard-coded hacks.
-             idl_type in ['EventTarget', 'Window'] or
-             idl_type.startswith(('HTML', 'SVG')))))
-
-
-################################################################################
-# Setter
-################################################################################
-
-def generate_setter(interface, attribute, contents):
-    def target_attribute():
-        target_interface_name = attribute.idl_type
-        target_attribute_name = extended_attributes['PutForwards']
-        target_interface = interfaces[target_interface_name]
-        try:
-            return next(attribute
-                        for attribute in target_interface.attributes
-                        if attribute.name == target_attribute_name)
-        except StopIteration:
-            raise Exception('[PutForward] target not found:\n'
-                            'Attribute "%s" is not present in interface "%s"' %
-                            (target_attribute_name, target_interface_name))
-
-    extended_attributes = attribute.extended_attributes
-
-    if 'PutForwards' in extended_attributes:
-        # Use target attribute in place of original attribute
-        attribute = target_attribute()
-
-    contents.update({
-        'cpp_setter': setter_expression(interface, attribute, contents),
-        'v8_value_to_local_cpp_value': v8_types.v8_value_to_local_cpp_value(
-            attribute.idl_type, extended_attributes, 'jsValue', 'cppValue'),
-    })
-
-
-def setter_expression(interface, attribute, contents):
-    extended_attributes = attribute.extended_attributes
-    arguments = v8_utilities.call_with_arguments(attribute, extended_attributes.get('SetterCallWith'))
-
-    this_setter_base_name = setter_base_name(interface, attribute, arguments)
-    setter_name = v8_utilities.scoped_name(interface, attribute, this_setter_base_name)
-
-    if ('ImplementedBy' in extended_attributes and
-        not attribute.is_static):
-        arguments.append('*imp')
-    idl_type = attribute.idl_type
-    if idl_type == 'EventHandler':
-        getter_name = v8_utilities.scoped_name(interface, attribute, cpp_name(attribute))
-        contents['event_handler_getter_expression'] = '%s(%s)' % (
-            getter_name, ', '.join(arguments))
-        if (interface.name in ['Window', 'WorkerGlobalScope'] and
-            attribute.name == 'onerror'):
-            includes.add('bindings/v8/V8ErrorHandler.h')
-            arguments.append('V8EventListenerList::findOrCreateWrapper<V8ErrorHandler>(jsValue, true, info.GetIsolate())')
-        else:
-            arguments.append('V8EventListenerList::getEventListener(jsValue, true, ListenerFindOrCreate)')
-    elif v8_types.is_interface_type(idl_type) and not v8_types.array_type(idl_type):
-        # FIXME: should be able to eliminate WTF::getPtr in most or all cases
-        arguments.append('WTF::getPtr(cppValue)')
-    else:
-        arguments.append('cppValue')
-    if contents['is_setter_raises_exception']:
-        arguments.append('exceptionState')
-
-    return '%s(%s)' % (setter_name, ', '.join(arguments))
-
-
-CONTENT_ATTRIBUTE_SETTER_NAMES = {
-    'boolean': 'setBooleanAttribute',
-    'long': 'setIntegralAttribute',
-    'unsigned long': 'setUnsignedIntegralAttribute',
-}
-
-
-def setter_base_name(interface, attribute, arguments):
-    if 'Reflect' not in attribute.extended_attributes:
-        return 'set%s' % capitalize(cpp_name(attribute))
-    arguments.append(scoped_content_attribute_name(interface, attribute))
-
-    idl_type = attribute.idl_type
-    if idl_type in CONTENT_ATTRIBUTE_SETTER_NAMES:
-        return CONTENT_ATTRIBUTE_SETTER_NAMES[idl_type]
-    return 'setAttribute'
-
-
-def scoped_content_attribute_name(interface, attribute):
-    content_attribute_name = attribute.extended_attributes['Reflect'] or attribute.name.lower()
-    namespace = 'SVGNames' if interface.name.startswith('SVG') else 'HTMLNames'
-    includes.add('%s.h' % namespace)
-    return '%s::%sAttr' % (namespace, content_attribute_name)
-
-
-################################################################################
-# Attribute configuration
-################################################################################
-
-# [Replaceable]
-def setter_callback_name(interface, attribute):
-    cpp_class_name = cpp_name(interface)
-    extended_attributes = attribute.extended_attributes
-    if (('Replaceable' in extended_attributes and
-         'PutForwards' not in extended_attributes) or
-        is_constructor_attribute(attribute)):
-        # FIXME: rename to ForceSetAttributeOnThisCallback, since also used for Constructors
-        return '{0}V8Internal::{0}ReplaceableAttributeSetterCallback'.format(cpp_class_name)
-    if attribute.is_read_only and 'PutForwards' not in extended_attributes:
-        return '0'
-    return '%sV8Internal::%sAttributeSetterCallback' % (cpp_class_name, attribute.name)
-
-
-# [DoNotCheckSecurity], [Unforgeable]
-def access_control_list(attribute):
-    extended_attributes = attribute.extended_attributes
-    access_control = []
-    if 'DoNotCheckSecurity' in extended_attributes:
-        do_not_check_security = extended_attributes['DoNotCheckSecurity']
-        if do_not_check_security == 'Setter':
-            access_control.append('v8::ALL_CAN_WRITE')
-        else:
-            access_control.append('v8::ALL_CAN_READ')
-            if (not attribute.is_read_only or
-                'Replaceable' in extended_attributes):
-                access_control.append('v8::ALL_CAN_WRITE')
-    if 'Unforgeable' in extended_attributes:
-        access_control.append('v8::PROHIBITS_OVERWRITING')
-    return access_control or ['v8::DEFAULT']
-
-
-# [NotEnumerable], [Unforgeable]
-def property_attributes(attribute):
-    extended_attributes = attribute.extended_attributes
-    property_attributes_list = []
-    if ('NotEnumerable' in extended_attributes or
-        is_constructor_attribute(attribute)):
-        property_attributes_list.append('v8::DontEnum')
-    if 'Unforgeable' in extended_attributes:
-        property_attributes_list.append('v8::DontDelete')
-    return property_attributes_list or ['v8::None']
-
-
-################################################################################
-# Constructors
-################################################################################
-
-def is_constructor_attribute(attribute):
-    return attribute.idl_type.endswith('Constructor')