Functions
	generate_parameter_entries (param_infos)

	rename_constructor (name)

	_Find_Match (interface_id, member, member_prefix, candidates)

	_Is_Native (interface, member)

	Select_Stub (template, is_native)

	Generate_Blink (output_dir, database, type_registry)

	_Emit_Extra_Operations (blink_file, interface_name)

	_Emit_Blink_Constructors (blink_file, analyzed_constructors)

	_Process_Attributes (blink_file, interface, attributes)

	_Process_Operations (blink_file, interface, operations, primary_interface=False)

	_Suppress_Secondary_Interface_Operation (interface, analyzed)

	_Emit_Blink_Operation (blink_file, interface, analyzeOperations, primary_interface)

Variables
	_js_custom_members

dict	_additional_methods

str	HEADER

str	END_RESOLVER

str	BLINK_UTILS

str	CLASS_DEFINITION

str	CLASS_DEFINITION_EXTENDS

list	CONSTRUCTOR_0

list	CONSTRUCTOR_ARGS

list	ATTRIBUTE_GETTER

list	ATTRIBUTE_SETTER

list	OPERATION_0

list	OPERATION_1

list	OPERATION_2

list	OPERATION_PQ

str	ARGUMENT_NUM = "__arg_%s"

list	OPERATION_ARGS

str	CLASS_STATIC = 'Blink_JsNative_DomException.getProperty(js.context, "%s")'

list	STATIC_ATTRIBUTE_GETTER

list	STATIC_OPERATION_0

list	STATIC_OPERATION_ARGS

str	CLASS_DEFINITION_END

dict	constructor_renames

dict	suppressed_operations

Detailed Description

Generates sdk/lib/_blink/dartium/_blink_dartium.dart file.

Function Documentation

◆ _Emit_Blink_Constructors()

scripts.generate_blink_file._Emit_Blink_Constructors	(	blink_file,
		analyzed_constructors
	)

protected

Definition at line 495 of file generate_blink_file.py.

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:
            arguments = []
            for i in range(0, callback_index):
                arguments.append(ARGUMENT_NUM % i)
            argument_list = ', '.join(arguments)
            blink_file.write(
                Select_Stub(CONSTRUCTOR_ARGS, _Is_Native(name, 'constructor')) %
                (callback_index, argument_list, rename_constructor(name),
                 argument_list))
 
 

◆ _Emit_Blink_Operation()

scripts.generate_blink_file._Emit_Blink_Operation	(	blink_file,
		interface,
		analyzeOperations,
		primary_interface
	)

protected

Definition at line 580 of file generate_blink_file.py.

                          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:
            arg_min_count = arg_max_count
            if arg_max_count == 2:
                blink_file.write(
                    Select_Stub(OPERATION_1, is_native) % (name, interface.id,
                                                           name))
            elif arg_max_count == 3:
                blink_file.write(
                    Select_Stub(OPERATION_2, is_native) % (name, interface.id,
                                                           name))
            else:
                print("FATAL ERROR: _blink emitter operator %s.%s" %
                      (interface.id, name))
                exit
 
        return
 
    for callback_index in range(arg_min_count, arg_max_count):
        if callback_index == 0:
            if operation.is_static:
                class_property = CLASS_STATIC % interface.id
                blink_file.write(
                    Select_Stub(STATIC_OPERATION_0, is_native) %
                    (name, class_property, interface.id, name))
            else:
                blink_file.write(
                    Select_Stub(OPERATION_0, is_native) % (name, interface.id,
                                                           name))
        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))

◆ _Emit_Extra_Operations()

scripts.generate_blink_file._Emit_Extra_Operations	(	blink_file,
		interface_name
	)

protected

Definition at line 486 of file generate_blink_file.py.

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))
 
 

◆ _Find_Match()

scripts.generate_blink_file._Find_Match	(	interface_id,
		member,
		member_prefix,
		candidates
	)

protected

Definition at line 409 of file generate_blink_file.py.

def _Find_Match(interface_id, member, member_prefix, candidates):
    member_name = interface_id + '.' + member
    if member_name in candidates:
        return member_name
    member_name = interface_id + '.' + member_prefix + member
    if member_name in candidates:
        return member_name
    member_name = interface_id + '.*'
    if member_name in candidates:
        return member_name
 
 

◆ _Is_Native()

scripts.generate_blink_file._Is_Native	(	interface,
		member
	)

protected

Definition at line 421 of file generate_blink_file.py.

def _Is_Native(interface, member):
    return _Find_Match(interface, member, '', _js_custom_members)

◆ _Process_Attributes()

scripts.generate_blink_file._Process_Attributes	(	blink_file,
		interface,
		attributes
	)

protected

Definition at line 518 of file generate_blink_file.py.

def _Process_Attributes(blink_file, interface, attributes):
    # Emit an interface's attributes and operations.
    for attribute in sorted(attributes, key=ConstantOutputOrder):
        name = attribute.id
        is_native = _Is_Native(interface.id, name)
        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))
 
 

◆ _Process_Operations()

scripts.generate_blink_file._Process_Operations	(	blink_file,
		interface,
		operations,
		primary_interface = `False`
	)

protected

Definition at line 542 of file generate_blink_file.py.

                        primary_interface=False):
    analyzeOperations = []
 
    for operation in sorted(operations, key=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,
                                      primary_interface)
                analyzeOperations = [operation]
    if len(analyzeOperations) > 0:
        _Emit_Blink_Operation(blink_file, interface, analyzeOperations,
                              primary_interface)
 
 
# 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.

◆ _Suppress_Secondary_Interface_Operation()

scripts.generate_blink_file._Suppress_Secondary_Interface_Operation	(	interface,
		analyzed
	)

protected

Definition at line 573 of file generate_blink_file.py.

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
 
 

◆ Generate_Blink()

scripts.generate_blink_file.Generate_Blink	(	output_dir,
		database,
		type_registry
	)

Definition at line 432 of file generate_blink_file.py.

def Generate_Blink(output_dir, database, type_registry):
    blink_filename = os.path.join(output_dir, '_blink_dartium.dart')
    blink_file = open(blink_filename, 'w')
 
    blink_file.write(HEADER)
 
    interfaces = database.GetInterfaces()
    for interface in interfaces:
        name = interface.id
        resolver_entry = '  if (s == "%s") return Blink%s.instance;\n' % (name,
                                                                          name)
        blink_file.write(resolver_entry)
 
    blink_file.write(END_RESOLVER)
 
    for interface in interfaces:
        name = interface.id
 
        if interface.parents and len(
                interface.parents) > 0 and interface.parents[0].id:
            extends = interface.parents[0].id
            class_def = CLASS_DEFINITION_EXTENDS % (name, extends, name)
        else:
            class_def = CLASS_DEFINITION % (name, name)
        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, 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,
                                False)
 
        blink_file.write(CLASS_DEFINITION_END)
 
    blink_file.write(BLINK_UTILS)
 
    blink_file.close()
 
 

◆ generate_parameter_entries()

scripts.generate_blink_file.generate_parameter_entries ( param_infos )

Definition at line 387 of file generate_blink_file.py.

def generate_parameter_entries(param_infos):
    optional_default_args = 0
    for argument in param_infos:
        if argument.is_optional:
            optional_default_args += 1
 
    arg_count = len(param_infos)
    min_arg_count = arg_count - optional_default_args
    lb = min_arg_count - 2 if min_arg_count > 2 else 0
    return (lb, arg_count + 1)
 
 

◆ rename_constructor()

scripts.generate_blink_file.rename_constructor ( name )

Definition at line 405 of file generate_blink_file.py.

def rename_constructor(name):
    return constructor_renames[name] if name in constructor_renames else name

◆ Select_Stub()

scripts.generate_blink_file.Select_Stub	(	template,
		is_native
	)

Definition at line 425 of file generate_blink_file.py.

def Select_Stub(template, is_native):
    if is_native:
        return template[0] + template[2]
    else:
        return template[0] + template[1]
 
 

Variable Documentation

◆ _additional_methods

dict scripts.generate_blink_file._additional_methods

protected

Initial value:

=  {
    # 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),
}

Definition at line 84 of file generate_blink_file.py.

◆ _js_custom_members

scripts.generate_blink_file._js_custom_members

protected

Definition at line 15 of file generate_blink_file.py.

◆ ARGUMENT_NUM

str scripts.generate_blink_file.ARGUMENT_NUM = "__arg_%s"

Definition at line 352 of file generate_blink_file.py.

◆ ATTRIBUTE_GETTER

list scripts.generate_blink_file.ATTRIBUTE_GETTER

Initial value:

=  [
    '  %s_Getter_(mthis)',
    ' => Blink_JsNative_DomException.getProperty(mthis /* %s */, "%s");\n\n',
    ' native "Blink_Getter_%s_%s";\n\n'
]

Definition at line 313 of file generate_blink_file.py.

◆ ATTRIBUTE_SETTER

list scripts.generate_blink_file.ATTRIBUTE_SETTER

Initial value:

=  [
    '  %s_Setter_(mthis, __arg_0)',
    ' => Blink_JsNative_DomException.setProperty(mthis /* %s */, "%s", __arg_0);\n\n',
    ' native "Blink_Setter_%s_%s";\n\n'
]

Definition at line 319 of file generate_blink_file.py.

◆ BLINK_UTILS

str scripts.generate_blink_file.BLINK_UTILS

Definition at line 121 of file generate_blink_file.py.

◆ CLASS_DEFINITION

str scripts.generate_blink_file.CLASS_DEFINITION

Initial value:

=  """class Blink%s {
  static final instance = new Blink%s();
 
"""

Definition at line 286 of file generate_blink_file.py.

◆ CLASS_DEFINITION_END

str scripts.generate_blink_file.CLASS_DEFINITION_END

Initial value:

=  """}
 
"""

Definition at line 383 of file generate_blink_file.py.

◆ CLASS_DEFINITION_EXTENDS

str scripts.generate_blink_file.CLASS_DEFINITION_EXTENDS

Initial value:

=  """class Blink%s extends Blink%s {
  static final instance = new Blink%s();
 
"""

Definition at line 291 of file generate_blink_file.py.

◆ CLASS_STATIC

str scripts.generate_blink_file.CLASS_STATIC = 'Blink_JsNative_DomException.getProperty(js.context, "%s")'

Definition at line 360 of file generate_blink_file.py.

◆ CONSTRUCTOR_0

list scripts.generate_blink_file.CONSTRUCTOR_0

Initial value:

=  [
    '  constructorCallback_0_()',
    ' => Blink_JsNative_DomException.callConstructor0("%s");\n\n',
    ' native "Blink_Constructor_%s";\n\n'
]

Definition at line 299 of file generate_blink_file.py.

◆ CONSTRUCTOR_ARGS

list scripts.generate_blink_file.CONSTRUCTOR_ARGS

Initial value:

=  [
    '  constructorCallback_%s_(%s)',
    ' => Blink_JsNative_DomException.callConstructor("%s", [%s]);\n\n',
    ' native "Blink_Constructor_Args_%s" /* %s */;\n\n'
]

Definition at line 306 of file generate_blink_file.py.

◆ constructor_renames

dict scripts.generate_blink_file.constructor_renames

Initial value:

=  {
    'RTCPeerConnection': 'webkitRTCPeerConnection',
    'SpeechRecognition': 'webkitSpeechRecognition',
}

Definition at line 399 of file generate_blink_file.py.

◆ END_RESOLVER

str scripts.generate_blink_file.END_RESOLVER

Initial value:

=  """
  // Failed to find it, check for custom renames
  dynamic obj = resolverMap[s];
  if (obj != null) return obj;
  throw("No such interface exposed in blink: ${s}");
}
 
"""

Definition at line 112 of file generate_blink_file.py.

◆ HEADER

str scripts.generate_blink_file.HEADER

Initial value:

=  """/* 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';
import 'dart:js' as js;
import 'dart:html' show DomException;
import 'dart:_internal' as internal;
// This is a place to put custom renames if we need them.
final resolverMap = {
};
 
dynamic resolver(String s) {
"""

Definition at line 92 of file generate_blink_file.py.

◆ OPERATION_0

list scripts.generate_blink_file.OPERATION_0

Initial value:

=  [
    '  %s_Callback_0_(mthis)',
    ' => Blink_JsNative_DomException.callMethod(mthis /* %s */, "%s", []);\n\n',
    ' native "Blink_Operation_0_%s_%s";\n\n'
]

Definition at line 326 of file generate_blink_file.py.

◆ OPERATION_1

list scripts.generate_blink_file.OPERATION_1

Initial value:

=  [
    '  $%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'
]

Definition at line 333 of file generate_blink_file.py.

◆ OPERATION_2

list scripts.generate_blink_file.OPERATION_2

Initial value:

=  [
    '  $%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'
]

Definition at line 339 of file generate_blink_file.py.

◆ OPERATION_ARGS

list scripts.generate_blink_file.OPERATION_ARGS

Initial value:

=  [
    '  %s_Callback_%s_(mthis, %s)',
    ' => Blink_JsNative_DomException.callMethod(mthis /* %s */, "%s", [%s]);\n\n',
    ' native "Blink_Operation_%s_%s"; /* %s */\n\n'
]

Definition at line 353 of file generate_blink_file.py.

◆ OPERATION_PQ

list scripts.generate_blink_file.OPERATION_PQ

Initial value:

=  [
    '  $%s_Callback_1_(mthis, __arg_0)',
    ' => Blink_JsNative_DomException.propertyQuery(mthis, __arg_0); /* %s */ \n\n',
    ' native "Blink_Operation_PQ_%s";\n\n'
]

Definition at line 345 of file generate_blink_file.py.

◆ STATIC_ATTRIBUTE_GETTER

list scripts.generate_blink_file.STATIC_ATTRIBUTE_GETTER

Initial value:

=  [
    '  %s_Getter_()',
    ' => Blink_JsNative_DomException.getProperty(%s /* %s */, "%s");\n\n',
    ' /* %s */ native "Blink_Static_getter_%s_%s"'
]

Definition at line 363 of file generate_blink_file.py.

◆ STATIC_OPERATION_0

list scripts.generate_blink_file.STATIC_OPERATION_0

Initial value:

=  [
    '  %s_Callback_0_()',
    ' => Blink_JsNative_DomException.callMethod(%s /* %s */, "%s", []);\n\n',
    ' /* %s */ native "Blink_Static_Operation_0_%s_%s'
]

Definition at line 370 of file generate_blink_file.py.

◆ STATIC_OPERATION_ARGS

list scripts.generate_blink_file.STATIC_OPERATION_ARGS

Initial value:

=  [
    '  %s_Callback_%s_(%s)',
    ' => Blink_JsNative_DomException.callMethod(%s /* %s */, "%s", [%s]);\n\n',
    ' /* %s */ native "Blink_Static_Operations_%s_%s" /* %s */ \n\n'
]

Definition at line 377 of file generate_blink_file.py.

◆ suppressed_operations

dict scripts.generate_blink_file.suppressed_operations

Initial value:

=  {
    'WebGL2RenderingContextBase': ['readPixels2', 'texImage2D2'],
}

Definition at line 568 of file generate_blink_file.py.

Functions

Variables

Detailed Description

Function Documentation

◆ _Emit_Blink_Constructors()

◆ _Emit_Blink_Operation()

◆ _Emit_Extra_Operations()

◆ _Find_Match()

◆ _Is_Native()

◆ _Process_Attributes()

◆ _Process_Operations()

◆ _Suppress_Secondary_Interface_Operation()

◆ Generate_Blink()

◆ generate_parameter_entries()

◆ rename_constructor()

◆ Select_Stub()

Variable Documentation

◆ _additional_methods

◆ _js_custom_members

◆ ARGUMENT_NUM

◆ ATTRIBUTE_GETTER

◆ ATTRIBUTE_SETTER

◆ BLINK_UTILS

◆ CLASS_DEFINITION

◆ CLASS_DEFINITION_END

◆ CLASS_DEFINITION_EXTENDS

◆ CLASS_STATIC

◆ CONSTRUCTOR_0

◆ CONSTRUCTOR_ARGS

◆ constructor_renames

◆ END_RESOLVER

◆ HEADER

◆ OPERATION_0

◆ OPERATION_1

◆ OPERATION_2

◆ OPERATION_ARGS

◆ OPERATION_PQ

◆ STATIC_ATTRIBUTE_GETTER

◆ STATIC_OPERATION_0

◆ STATIC_OPERATION_ARGS

◆ suppressed_operations