code_generator_dart.CodeGeneratorDart Class Reference

Inheritance diagram for code_generator_dart.CodeGeneratorDart:

Public Member Functions
def	__init__ (self, interfaces_info, cache_dir)
def	generate_code (self, definitions, interface_name, idl_pickle_filename, only_if_changed)
def	generate_globals (self, output_directory)

Public Attributes
	interfaces_info
	jinja_env

Detailed Description

Definition at line 95 of file code_generator_dart.py.

Constructor & Destructor Documentation

__init__()

def code_generator_dart.CodeGeneratorDart.__init__	(		self,
			interfaces_info,
			cache_dir
	)

Definition at line 97 of file code_generator_dart.py.

    def __init__(self, interfaces_info, cache_dir):
        interfaces_info = interfaces_info or {}
        self.interfaces_info = interfaces_info
        self.jinja_env = initialize_jinja_env(cache_dir)
 
        # Set global type info
        idl_types.set_ancestors(
            dict((interface_name, interface_info['ancestors'])
                 for interface_name, interface_info in interfaces_info.items()
                 if interface_info['ancestors']))
        IdlType.set_callback_interfaces(
            set(interface_name
                for interface_name, interface_info in interfaces_info.items()
                if interface_info['is_callback_interface']))
        IdlType.set_implemented_as_interfaces(
            dict((interface_name, interface_info['implemented_as'])
                 for interface_name, interface_info in interfaces_info.items()
                 if interface_info['implemented_as']))
        IdlType.set_garbage_collected_types(
            set(interface_name
                for interface_name, interface_info in interfaces_info.items()
                if 'GarbageCollected' in
                interface_info['inherited_extended_attributes']))
 

Member Function Documentation

generate_code()

def code_generator_dart.CodeGeneratorDart.generate_code	(		self,
			definitions,
			interface_name,
			idl_pickle_filename,
			only_if_changed
	)

Returns .h/.cpp code as (header_text, cpp_text).

Definition at line 121 of file code_generator_dart.py.

                      only_if_changed):
        """Returns .h/.cpp code as (header_text, cpp_text)."""
        try:
            interface = definitions.interfaces[interface_name]
        except KeyError:
            raise Exception('%s not in IDL definitions' % interface_name)
 
        # Store other interfaces for introspection
        interfaces.update(definitions.interfaces)
 
        # Set local type info
        IdlType.set_callback_functions(definitions.callback_functions.keys())
        IdlType.set_enums((enum.name, enum.values)
                          for enum in definitions.enumerations.values())
 
        # Select appropriate Jinja template and contents function
        if interface.is_callback:
            header_template_filename = 'callback_interface_h.template'
            cpp_template_filename = 'callback_interface_cpp.template'
            generate_contents = dart_callback_interface.generate_callback_interface
        else:
            header_template_filename = 'interface_h.template'
            cpp_template_filename = 'interface_cpp.template'
            generate_contents = dart_interface.generate_interface
        header_template = self.jinja_env.get_template(header_template_filename)
        cpp_template = self.jinja_env.get_template(cpp_template_filename)
 
        # Generate contents (input parameters for Jinja)
        template_contents = generate_contents(interface)
        template_contents['code_generator'] = module_pyname
 
        # Add includes for interface itself and any dependencies
        interface_info = self.interfaces_info[interface_name]
        template_contents['header_includes'].add(interface_info['include_path'])
        template_contents['header_includes'] = sorted(
            template_contents['header_includes'])
        includes.update(interface_info.get('dependencies_include_paths', []))
 
        # Remove includes that are not needed for Dart and trigger fatal
        # compile warnings if included. These IDL files need to be
        # imported by Dart to generate the list of events but the
        # associated header files do not contain any code used by Dart.
        includes.discard('core/dom/GlobalEventHandlers.h')
        includes.discard('core/frame/DOMWindowEventHandlers.h')
 
        template_contents['cpp_includes'] = sorted(includes)
 
        idl_world = {'interface': None, 'callback': None}
 
        # Load the pickle file for this IDL.
        if os.path.isfile(idl_pickle_filename):
            with open(idl_pickle_filename) as idl_pickle_file:
                idl_global_data = pickle.load(idl_pickle_file)
                idl_pickle_file.close()
            idl_world['interface'] = idl_global_data['interface']
            idl_world['callback'] = idl_global_data['callback']
 
        if 'interface_name' in template_contents:
            interface_global = {
                'name':
                template_contents['interface_name'],
                'parent_interface':
                template_contents['parent_interface'],
                'is_active_dom_object':
                template_contents['is_active_dom_object'],
                'is_event_target':
                template_contents['is_event_target'],
                'has_resolver':
                template_contents['interface_name'] not in
                INTERFACES_WITHOUT_RESOLVERS,
                'is_node':
                template_contents['is_node'],
                'conditional_string':
                template_contents['conditional_string'],
            }
            idl_world['interface'] = interface_global
        else:
            callback_global = {'name': template_contents['cpp_class']}
            idl_world['callback'] = callback_global
 
        write_pickle_file(idl_pickle_filename, idl_world, only_if_changed)
 
        # Render Jinja templates
        header_text = header_template.render(template_contents)
        cpp_text = cpp_template.render(template_contents)
        return header_text, cpp_text
 

generate_globals()

def code_generator_dart.CodeGeneratorDart.generate_globals	(		self,
			output_directory
	)

Definition at line 210 of file code_generator_dart.py.

    def generate_globals(self, output_directory):
        header_template_filename = 'global_h.template'
        cpp_template_filename = 'global_cpp.template'
 
        # Delete the global pickle file we'll rebuild from each pickle generated
        # for each IDL file '(%s_globals.pickle) % interface_name'.
        global_pickle_filename = os.path.join(output_directory, 'global.pickle')
        if os.path.isfile(global_pickle_filename):
            os.remove(global_pickle_filename)
 
        # List of all interfaces and callbacks for global code generation.
        world = {'interfaces': [], 'callbacks': []}
 
        # Load all pickled data for each interface.
        listing = os.listdir(output_directory)
        for filename in listing:
            if filename.endswith('_globals.pickle'):
                idl_filename = os.path.join(output_directory, filename)
                with open(idl_filename) as idl_pickle_file:
                    idl_world = pickle.load(idl_pickle_file)
                    if 'interface' in idl_world:
                        # FIXME: Why are some of these None?
                        if idl_world['interface']:
                            world['interfaces'].append(idl_world['interface'])
                    if 'callbacks' in idl_world:
                        # FIXME: Why are some of these None?
                        if idl_world['callbacks']:
                            world['callbacks'].append(idl_world['callback'])
                    idl_pickle_file.close()
 
        world['interfaces'] = sorted(world['interfaces'],
                                     key=lambda x: x['name'])
        world['callbacks'] = sorted(world['callbacks'], key=lambda x: x['name'])
 
        template_contents = world
        template_contents['code_generator'] = module_pyname
 
        header_template = self.jinja_env.get_template(header_template_filename)
        header_text = header_template.render(template_contents)
 
        cpp_template = self.jinja_env.get_template(cpp_template_filename)
        cpp_text = cpp_template.render(template_contents)
        return header_text, cpp_text
 
 

Member Data Documentation

interfaces_info

code_generator_dart.CodeGeneratorDart.interfaces_info

Definition at line 99 of file code_generator_dart.py.

jinja_env

code_generator_dart.CodeGeneratorDart.jinja_env

Definition at line 100 of file code_generator_dart.py.

---

The documentation for this class was generated from the following file:

• third_party/dart-lang/sdk/tools/dom/new_scripts/code_generator_dart.py