Roll 50: Updated for push to origin/master.

tools/dom/scripts/generate_blink_file.py

 #!/usr/bin/python
 #
 # Copyright (c) 2014, the Dart project authors.  Please see the AUTHORS file
 # for details. All rights reserved. Use of this source code is governed by a
 # BSD-style license that can be found in the LICENSE file.
 
 """Generates sdk/lib/_blink/dartium/_blink_dartium.dart file."""
 
 import os
 from sets import Set
@@ skipping 41 matching lines @@
     'NodeList.item',
     'ParentNode.children',
     'ParentNode.firstElementChild',
     'ParentNode.lastElementChild',
     'Event.target',
     'MouseEvent.clientY',
     'MouseEvent.clientX',
 
     'Node.nodeType',
     'Node.textContent',
-    
+
     'HTMLCollection.length',
     'HTMLCollection.item',
     'Node.lastElementChild',
     'Node.firstElementChild',
     'HTMLElement_tabIndex',
 
     'Element.clientWidth',
     'Element.clientHeight',
     'Document.body',
     'Element.removeAttribute',
     'Element.getBoundingClientRect',
     'CSSStyleDeclaration.getPropertyValue',
     'CSSStyleDeclaration.setProperty',
     'CSSStyleDeclaration.__propertyQuery__',
 
     # TODO(jacobr): consider implementing these methods as well as they show
     # up in benchmarks for some sample applications.
     #'Document.createEvent',
     #'Document.initEvent',
     #'EventTarget.dispatchEvent',
      ])
 
 # Uncomment out this line  to short circuited native methods and run all of
 # dart:html through JS interop except for createElement which is slightly more
 # tightly natively wired.
 # _js_custom_members = Set([])
 
+
+# Expose built-in methods support by an instance that is not shown in the IDL.
+_additional_methods = {
+  # Support propertyIsEnumerable (available on all objects only needed by
+  # CSSStyleDeclaration decides if style property is supported (handling
+  # camelcase and inject hyphens between camelcase).
+  # Format of dictionary is 'operation name', arguments, returns value (True or False)
+  'CSSStyleDeclaration': ('propertyIsEnumerable', 1, True), 
+}
+
+
 HEADER = """/* Copyright (c) 2014, the Dart project authors.  Please see the AUTHORS file
  * for details. All rights reserved. Use of this source code is governed by a
  * BSD-style license that can be found in the LICENSE file.
  *
  * DO NOT EDIT
  * Auto-generated _blink library.
  */
 library dart.dom._blink;
 
 import 'dart:async';
@@ skipping 213 matching lines @@
                     ' => Blink_JsNative_DomException.setProperty(mthis /* %s */, "%s", __arg_0);\n\n',
                     ' native "Blink_Setter_%s_%s";\n\n'
                     ]
 
 #(operation_name, operationName)
 OPERATION_0 = ['  %s_Callback_0_(mthis)',
                ' => Blink_JsNative_DomException.callMethod(mthis /* %s */, "%s", []);\n\n',
                ' native "Blink_Operation_0_%s_%s";\n\n'
                ]
 
-# getter, setter, deleter and propertyQuery code
+# getter, setter, deleter, propertyQuery code, and propertyIsEnumerable
 OPERATION_1 = ['  $%s_Callback_1_(mthis, __arg_0)',
                ' => Blink_JsNative_DomException.callMethod(mthis /* %s */, "%s", [__arg_0]);\n\n',
                ' native "Blink_Operation_1_%s_%s";\n\n'
                ]
 
 OPERATION_2 = ['  $%s_Callback_2_(mthis, __arg_0, __arg_1)',
                ' => Blink_JsNative_DomException.callMethod(mthis /* %s */, "%s", [__arg_0, __arg_1]);\n\n',
                ' native "Blink_Operation_2_%s_%s";\n\n']
 
 OPERATION_PQ = ['  $%s_Callback_1_(mthis, __arg_0)',
@@ skipping 99 matching lines @@
     blink_file.write(class_def);
 
     analyzed_constructors = AnalyzeConstructor(interface)
     if analyzed_constructors:
       _Emit_Blink_Constructors(blink_file, analyzed_constructors)
     elif 'Constructor' in interface.ext_attrs:
       # Zero parameter constructor.
       blink_file.write(Select_Stub(CONSTRUCTOR_0, _Is_Native(name, 'constructor')) % rename_constructor(name))
 
     _Process_Attributes(blink_file, interface, interface.attributes)
-    _Process_Operations(blink_file, interface, interface.operations)
+    _Process_Operations(blink_file, interface, interface.operations, True)
+
+    _Emit_Extra_Operations(blink_file, name)
 
     secondary_parents = database.TransitiveSecondaryParents(interface, False)
     for secondary in secondary_parents:
       _Process_Attributes(blink_file, secondary, secondary.attributes)
-      _Process_Operations(blink_file, secondary, secondary.operations)
+      _Process_Operations(blink_file, secondary, secondary.operations, False)
 
     blink_file.write(CLASS_DEFINITION_END);
 
   blink_file.write(BLINK_UTILS)
 
   blink_file.close()
 
+def _Emit_Extra_Operations(blink_file, interface_name):
+  if (interface_name in _additional_methods):
+    (name, arg_count, return_value) = _additional_methods[interface_name]
+    exposed_name = ''.join(['__get', '___', name]) if return_value else name
+    blink_file.write(Select_Stub(OPERATION_1, False) % (exposed_name, interface_name, name))
+
 def _Emit_Blink_Constructors(blink_file, analyzed_constructors):
   (arg_min_count, arg_max_count) = generate_parameter_entries(analyzed_constructors.param_infos)
   name = analyzed_constructors.js_name
   if not(name):
     name = analyzed_constructors.type_name
 
   for callback_index in range(arg_min_count, arg_max_count):
     if callback_index == 0:
       blink_file.write(Select_Stub(CONSTRUCTOR_0, _Is_Native(name, 'constructor')) % (rename_constructor(name)))
     else:
@@ skipping 12 matching lines @@
     if attribute.is_read_only:
       if attribute.is_static:
         class_property = CLASS_STATIC % interface.id
         blink_file.write(Select_Stub(STATIC_ATTRIBUTE_GETTER, is_native) % (name, class_property, interface.id, name))
       else:
         blink_file.write(Select_Stub(ATTRIBUTE_GETTER, is_native) % (name, interface.id, name))
     else:
       blink_file.write(Select_Stub(ATTRIBUTE_GETTER, is_native) % (name, interface.id, name))
       blink_file.write(Select_Stub(ATTRIBUTE_SETTER, is_native) % (name, interface.id, name))
 
-def _Process_Operations(blink_file, interface, operations):
+def _Process_Operations(blink_file, interface, operations, primary_interface = False):
   analyzeOperations = []
 
   for operation in sorted(operations, ConstantOutputOrder):
     if len(analyzeOperations) == 0:
       analyzeOperations.append(operation)
     else:
       if analyzeOperations[0].id == operation.id:
         # Handle overloads
         analyzeOperations.append(operation)
       else:
-        _Emit_Blink_Operation(blink_file, interface, analyzeOperations)
+        _Emit_Blink_Operation(blink_file, interface, analyzeOperations, primary_interface)
         analyzeOperations = [operation]
   if len(analyzeOperations) > 0:
-    _Emit_Blink_Operation(blink_file, interface, analyzeOperations)
+    _Emit_Blink_Operation(blink_file, interface, analyzeOperations, primary_interface)
 
-def _Emit_Blink_Operation(blink_file, interface, analyzeOperations):
+# List of DartName operations to not emit (e.g., For now only WebGL2RenderingContextBase
+# has readPixels in both WebGLRenderingContextBase and WebGL2RenderingContextBase.
+# Furthermore, readPixels has the exact same number of arguments - in Javascript
+# there is no typing so they're the same.
+suppressed_operations = {
+    'WebGL2RenderingContextBase': [ 'readPixels2', 'texImage2D2' ],
+}
+
+def _Suppress_Secondary_Interface_Operation(interface, analyzed):
+  if interface.id in suppressed_operations:
+    # Should this DartName (name property) be suppressed on this interface?
+    return analyzed.name in suppressed_operations[interface.id]
+  return False
+
+def _Emit_Blink_Operation(blink_file, interface, analyzeOperations, primary_interface):
   analyzed = AnalyzeOperation(interface, analyzeOperations)
+
+  if not(primary_interface) and _Suppress_Secondary_Interface_Operation(interface, analyzed):
+    return
+
   (arg_min_count, arg_max_count) = generate_parameter_entries(analyzed.param_infos)
   name = analyzed.js_name
+
   is_native = _Is_Native(interface.id, name)
 
   operation = analyzeOperations[0]
   if (name.startswith('__') and \
       ('getter' in operation.specials or \
        'setter' in operation.specials or \
        'deleter' in operation.specials)):
     if name == '__propertyQuery__':
       blink_file.write(Select_Stub(OPERATION_PQ, is_native) % (name, interface.id))
     else:
@@ skipping 18 matching lines @@
     else:
       arguments = []
       for i in range(0, callback_index):
         arguments.append(ARGUMENT_NUM % i)
       argument_list = ', '.join(arguments)
       if operation.is_static:
         class_property = CLASS_STATIC % interface.id
         blink_file.write(Select_Stub(STATIC_OPERATION_ARGS, is_native) % (name, callback_index, argument_list, class_property, interface.id, name, argument_list))
       else:
         blink_file.write(Select_Stub(OPERATION_ARGS, is_native) % (name, callback_index, argument_list, interface.id, name, argument_list))