Generated bindings for IDL callback functions

third_party/WebKit/Source/bindings/scripts/v8_callback_function.py

+# Copyright 2016 The Chromium Authors. All rights reserved.
+# Use of this source code is governed by a BSD-style license that can be
+# found in the LICENSE file.
+
+"""Generate template values for a callback function.
+
+Design doc: http://www.chromium.org/developers/design-documents/idl-compiler
+"""
+
+from v8_globals import includes  # pylint: disable=W0403
+import v8_utilities  # pylint: disable=W0403
+
+CALLBACK_FUNCTION_H_INCLUDES = frozenset([
+    'bindings/core/v8/ScopedPersistent.h',
+    'platform/heap/Handle.h',
+    'wtf/text/WTFString.h',
+])
+CALLBACK_FUNCTION_CPP_INCLUDES = frozenset([
+    'bindings/core/v8/ScriptState.h',
+    'bindings/core/v8/V8Binding.h',
+    'wtf/Assertions.h',
+])
+
+
+def callback_function_context(callback_function):
+    includes.clear()
+    includes.update(CALLBACK_FUNCTION_CPP_INCLUDES)
+    idl_type = callback_function.idl_type
+    idl_type_str = str(idl_type)
+    context = {
+        'cpp_class': callback_function.name,
+        'cpp_includes': sorted(CALLBACK_FUNCTION_CPP_INCLUDES),
+        'header_includes': sorted(CALLBACK_FUNCTION_H_INCLUDES),
+        'idl_type': idl_type_str,
+        'return_cpp_type': (idl_type.cpp_type + '&') if idl_type.cpp_type != 'void' else None,
+        'return_value': idl_type.v8_value_to_local_cpp_value(
+            callback_function.extended_attributes, 'v8ReturnValue', 'cppValue',
+            bailout_return_value="false") if idl_type.cpp_type != 'void' else None,
+        'v8_class': v8_utilities.v8_class_name(callback_function),
+    }
+    context.update(arguments_context(callback_function.arguments, context['return_cpp_type']))
+    return context
+
+
+def arguments_context(arguments, return_cpp_type):
+    def argument_context(argument):
+        return {
+            'cpp_value_to_v8_value': argument.idl_type.cpp_value_to_v8_value(
+                argument.name, isolate='scriptState->isolate()',
+                creation_context='scriptState->context()->Global()'),
+            'argument_name': '%sArgument' % argument.name,
+        }
+
+    argument_declarations = ['ScriptState* scriptState', 'ScriptWrappable* scriptWrappable']
+    argument_declarations.extend(
+        '%s %s' % (argument.idl_type.callback_cpp_type, argument.name)
+        for argument in arguments)
+    if return_cpp_type:
+        argument_declarations.append('%s returnValue' % return_cpp_type)
+    return {
+        'argument_declarations': argument_declarations,
+        'arguments': [argument_context(argument) for argument in arguments],
+    }