OLD | NEW |
---|---|
(Empty) | |
1 # Copyright 2017 The Chromium Authors. All rights reserved. | |
2 # Use of this source code is governed by a BSD-style license that can be | |
3 # found in the LICENSE file. | |
4 | |
5 # pylint: disable=relative-import | |
6 | |
7 import argparse | |
8 import os | |
9 | |
10 from code_generator import initialize_jinja_env | |
11 from idl_reader import IdlReader | |
12 from utilities import create_component_info_provider, write_file | |
13 import utilities | |
14 import v8_attributes | |
15 import v8_interface | |
16 import v8_types | |
17 import v8_utilities | |
18 | |
19 | |
20 INCLUDES = frozenset([ | |
21 'bindings/core/v8/GeneratedCodeHelper.h', | |
22 'bindings/core/v8/V8HTMLDocument.h', | |
23 'bindings/core/v8/V8Initializer.h', | |
24 'bindings/core/v8/V8Window.h', | |
25 'platform/bindings/DOMWrapperWorld.h', | |
26 'platform/bindings/V8ObjectConstructor.h', | |
27 'platform/bindings/V8PerIsolateData.h', | |
28 'platform/bindings/V8PrivateProperty.h', | |
29 'v8/include/v8.h']) | |
30 | |
31 TEMPLATE_FILE = 'external_reference_table.cpp.tmpl' | |
32 | |
33 WHITE_LIST_INTERFACES = frozenset([ | |
34 'DOMMatrix', # crbug.com/733481 | |
35 ]) | |
36 | |
37 SNAPSHOTTED_INTERFACES = frozenset([ | |
38 'Window', | |
39 'EventTarget', | |
40 'HTMLDocument', | |
41 'Document', | |
42 'Node', | |
43 ]) | |
44 | |
45 | |
46 def parse_args(): | |
47 parser = argparse.ArgumentParser() | |
48 parser.add_argument('--idl-files-list', type=str, required=True, | |
49 help='file listing IDL files') | |
50 parser.add_argument('--output', type=str, required=True, | |
51 help='output file path') | |
52 parser.add_argument('--info-dir', type=str, required=True, | |
53 help='directory contains component info') | |
54 parser.add_argument('--cache-dir', type=str, required=True, | |
55 help='cache directory') | |
56 parser.add_argument('--target-component', type=str, required=True, | |
57 help='target component') | |
58 return parser.parse_known_args() | |
59 | |
60 | |
61 # This class creates a Jinja template context about an interface. | |
62 class InterfaceTemplateContextBuilder(object): | |
63 | |
64 def __init__(self, opts, info_provider): | |
65 self._opts = opts | |
66 self._info_provider = info_provider | |
67 | |
68 def create_interface_context(self, interface, interfaces): | |
69 '''Creates a Jinja context which is based on an interface.''' | |
70 | |
71 name = '%s%s' % (v8_utilities.cpp_name(interface), 'Partial' if interfac e.is_partial else '') | |
72 | |
73 # Constructors | |
74 constructors = any(constructor.name == 'Constructor' for constructor in interface.constructors) | |
75 custom_constructors = interface.custom_constructors | |
76 html_constructor = 'HTMLConstructor' in interface.extended_attributes | |
77 has_constructor_callback = constructors or custom_constructors or html_c onstructor | |
78 | |
79 attributes = [] | |
80 methods = [] | |
81 is_global = False | |
82 named_property_getter = None | |
83 indexed_property_getter = None | |
84 has_origin_safe_method_setter = None | |
85 has_cross_origin_named_getter = None | |
86 if interface.name in SNAPSHOTTED_INTERFACES: | |
87 attributes = [v8_attributes.attribute_context(interface, attribute, interfaces) | |
88 for attribute in interface.attributes] | |
89 methods = v8_interface.methods_context(interface)['methods'] | |
90 is_global = ('PrimaryGlobal' in interface.extended_attributes or | |
91 'Global' in interface.extended_attributes) | |
92 | |
93 named_property_getter = v8_interface.property_getter(interface.named _property_getter, ['name']) | |
94 indexed_property_getter = v8_interface.property_getter(interface.ind exed_property_getter, ['index']) | |
95 | |
96 has_origin_safe_method_setter = not interface.is_partial and is_glob al and any( | |
97 method['is_check_security_for_receiver'] and not method['is_unfo rgeable'] | |
98 for method in methods) | |
99 has_cross_origin_named_getter = ( | |
100 any(attribute['has_cross_origin_getter'] for attribute in attrib utes) or | |
101 any(method['is_cross_origin'] for method in methods)) | |
102 | |
103 has_security_check = False | |
104 has_cross_origin_named_setter = False | |
105 has_cross_origin_named_enum = False | |
106 has_cross_origin_named_getter = False | |
107 has_cross_origin_indexed_getter = False | |
108 if not interface.is_partial: | |
haraken
2017/07/10 06:52:09
Why doesn't the line 108 - 114 need to be in the '
peria
2017/07/10 10:18:43
Done.
This change reduce the number of the entries
| |
109 has_security_check = ('CheckSecurity' in interface.extended_attribut es and | |
110 interface.name != 'EventTarget') | |
111 has_cross_origin_named_setter = any(attribute['has_cross_origin_sett er'] for attribute in attributes) | |
112 has_cross_origin_named_enum = has_cross_origin_named_getter or has_c ross_origin_named_setter | |
113 has_cross_origin_named_getter = named_property_getter and named_prop erty_getter['is_cross_origin'] | |
114 has_cross_origin_indexed_getter = indexed_property_getter and indexe d_property_getter['is_cross_origin'] | |
115 | |
116 return { | |
117 'attributes': attributes, | |
118 'has_origin_safe_method_setter': has_origin_safe_method_setter, | |
119 'has_constructor_callback': has_constructor_callback, | |
120 'has_cross_origin_named_getter': has_cross_origin_named_getter, | |
121 'has_cross_origin_named_setter': has_cross_origin_named_setter, | |
122 'has_cross_origin_named_enumerator': has_cross_origin_named_enum, | |
123 'has_cross_origin_indexed_getter': has_cross_origin_indexed_getter, | |
124 'has_security_check': has_security_check, | |
125 'indexed_property_getter': indexed_property_getter, | |
126 'indexed_property_setter': v8_interface.property_setter(interface.in dexed_property_setter, interface), | |
127 'indexed_property_deleter': v8_interface.property_deleter(interface. indexed_property_deleter), | |
128 'is_array_buffer_or_view': interface.idl_type.is_array_buffer_or_vie w, | |
129 'is_callback': interface.is_callback, | |
130 'is_partial': interface.is_partial, | |
131 'is_snapshotted': interface in SNAPSHOTTED_INTERFACES, | |
132 'methods': methods, | |
133 'name': name, | |
134 'named_constructor': v8_interface.named_constructor_context(interfac e), | |
135 'named_property_getter': named_property_getter, | |
136 'named_property_setter': v8_interface.property_setter(interface.name d_property_setter, interface), | |
137 'named_property_deleter': v8_interface.property_deleter(interface.na med_property_deleter), | |
138 'v8_name': v8_utilities.v8_class_name_or_partial(interface), | |
139 } | |
140 | |
141 | |
142 # This class applies a Jinja template and creates a .cpp file for the external r eference table. | |
143 class ExternalReferenceTableGenerator(object): | |
144 def __init__(self, opts, info_provider): | |
145 self._opts = opts | |
146 self._info_provider = info_provider | |
147 self._reader = IdlReader( | |
148 info_provider.interfaces_info, opts.cache_dir) | |
149 self._interface_contexts = {} | |
150 self._include_files = set(INCLUDES) | |
151 v8_types.set_component_dirs(info_provider.interfaces_info['component_dir s']) | |
152 | |
153 def process_idl_file(self, idl_filename): | |
154 definitions = self._reader.read_idl_definitions(idl_filename) | |
155 base_name, _ = os.path.splitext(os.path.basename(idl_filename)) | |
156 for component in definitions: | |
157 target_definitions = definitions[component] | |
158 interfaces = target_definitions.interfaces | |
159 if base_name in interfaces.keys(): | |
160 interface = interfaces[base_name] | |
161 self._process_interface(interface, component, interfaces) | |
162 | |
163 def _process_interface(self, interface, component, interfaces): | |
164 def has_impl(interface): | |
haraken
2017/07/10 06:52:09
Add more comments about what this method is doing.
peria
2017/07/10 10:18:43
Done.
| |
165 if interface.name in WHITE_LIST_INTERFACES: | |
166 return True | |
167 # Non legacy callback interface does not provide V8 callbacks. | |
168 if interface.is_callback: | |
169 return len(interface.constants) > 0 | |
170 if 'RuntimeEnabled' in interface.extended_attributes: | |
171 return False | |
172 return True | |
173 | |
174 if not has_impl(interface): | |
175 return | |
176 | |
177 context_builder = InterfaceTemplateContextBuilder(self._opts, self._info _provider) | |
178 context = context_builder.create_interface_context(interface, interfaces ) | |
179 name = '%s%s' % (interface.name, 'Partial' if interface.is_partial else '') | |
180 self._interface_contexts[name] = context | |
181 include_file = 'bindings/%s/v8/%s.h' % (component, context['v8_name']) | |
182 self._include_files.add(include_file) | |
183 | |
184 def _create_template_context(self): | |
185 interfaces = [] | |
186 for name in sorted(self._interface_contexts): | |
187 interfaces.append(self._interface_contexts[name]) | |
188 return { | |
189 'class': 'V8ContextSnapshotExternalReferences', | |
190 'interfaces': interfaces, | |
191 'include_files': sorted(list(self._include_files)), | |
192 } | |
193 | |
194 def generate(self): | |
195 jinja_env = initialize_jinja_env(self._opts.cache_dir) | |
196 context = self._create_template_context() | |
197 cpp_template = jinja_env.get_template(TEMPLATE_FILE) | |
198 cpp_text = cpp_template.render(context) | |
199 return cpp_text | |
200 | |
201 | |
202 def main(): | |
203 opts, _ = parse_args() | |
204 # TODO(peria): get rid of |info_provider| | |
205 info_provider = create_component_info_provider( | |
206 opts.info_dir, opts.target_component) | |
207 generator = ExternalReferenceTableGenerator(opts, info_provider) | |
208 | |
209 idl_files = utilities.read_idl_files_list_from_file(opts.idl_files_list, Fal se) | |
210 for idl_file in idl_files: | |
211 generator.process_idl_file(idl_file) | |
212 output_code = generator.generate() | |
213 output_path = opts.output | |
214 write_file(output_code, output_path) | |
215 | |
216 | |
217 if __name__ == '__main__': | |
218 main() | |
OLD | NEW |