| OLD | NEW |
| 1 #!/usr/bin/python | 1 #!/usr/bin/python |
| 2 # Copyright (c) 2012, the Dart project authors. Please see the AUTHORS file | 2 # Copyright (c) 2012, the Dart project authors. Please see the AUTHORS file |
| 3 # for details. All rights reserved. Use of this source code is governed by a | 3 # for details. All rights reserved. Use of this source code is governed by a |
| 4 # BSD-style license that can be found in the LICENSE file. | 4 # BSD-style license that can be found in the LICENSE file. |
| 5 | 5 |
| 6 """This module provides shared functionality for the system to generate | 6 """This module provides shared functionality for the system to generate |
| 7 dart:html APIs from the IDL database.""" | 7 dart:html APIs from the IDL database.""" |
| 8 | 8 |
| 9 from generator import AnalyzeOperation, ConstantOutputOrder, \ | 9 from generator import AnalyzeOperation, ConstantOutputOrder, \ |
| 10 DartDomNameOfAttribute, FindMatchingAttribute, IsDartCollectionType, \ | 10 DartDomNameOfAttribute, FindMatchingAttribute, IsDartCollectionType, \ |
| (...skipping 23 matching lines...) Expand all Loading... |
| 34 support_check = self.GetSupportCheck() | 34 support_check = self.GetSupportCheck() |
| 35 self._members_emitter.Emit('\n' | 35 self._members_emitter.Emit('\n' |
| 36 ' /// Checks if this type is supported on the current platform.\n' | 36 ' /// Checks if this type is supported on the current platform.\n' |
| 37 ' static bool get supported => $SUPPORT_CHECK;\n', | 37 ' static bool get supported => $SUPPORT_CHECK;\n', |
| 38 SUPPORT_CHECK=support_check) | 38 SUPPORT_CHECK=support_check) |
| 39 | 39 |
| 40 def EmitAttributeDocumentation(self, attribute): | 40 def EmitAttributeDocumentation(self, attribute): |
| 41 """ Emits the MDN dartdoc comment for an attribute. | 41 """ Emits the MDN dartdoc comment for an attribute. |
| 42 """ | 42 """ |
| 43 dom_name = DartDomNameOfAttribute(attribute) | 43 dom_name = DartDomNameOfAttribute(attribute) |
| 44 self._members_emitter.Emit('\n /// @domName $DOMINTERFACE.$DOMNAME;' | 44 self._members_emitter.Emit('\n /// @docsEditable true', |
| 45 ' @docsEditable true', | |
| 46 DOMINTERFACE=attribute.doc_js_interface_name, | 45 DOMINTERFACE=attribute.doc_js_interface_name, |
| 47 DOMNAME=dom_name) | 46 DOMNAME=dom_name) |
| 48 | 47 |
| 49 def EmitOperationDocumentation(self, operation): | 48 def EmitOperationDocumentation(self, operation): |
| 50 """ Emits the MDN dartdoc comment for an operation. | 49 """ Emits the MDN dartdoc comment for an operation. |
| 51 """ | 50 """ |
| 52 self._members_emitter.Emit('\n /// @domName $DOMINTERFACE.$DOMNAME;' | 51 self._members_emitter.Emit('\n /// @docsEditable true', |
| 53 ' @docsEditable true', | |
| 54 DOMINTERFACE=operation.overloads[0].doc_js_interface_name, | 52 DOMINTERFACE=operation.overloads[0].doc_js_interface_name, |
| 55 DOMNAME=operation.name) | 53 DOMNAME=operation.name) |
| 56 | 54 |
| 57 def EmitEventGetter(self, events_class_name): | 55 def EmitEventGetter(self, events_class_name): |
| 58 self._members_emitter.Emit( | 56 self._members_emitter.Emit( |
| 59 '\n /// @domName EventTarget.addEventListener, ' | 57 '\n /// @docsEditable true' |
| 60 'EventTarget.removeEventListener, EventTarget.dispatchEvent;' | 58 '\n @DomName("EventTarget.addEventListener, ' |
| 61 ' @docsEditable true' | 59 'EventTarget.removeEventListener, EventTarget.dispatchEvent")' |
| 62 '\n $TYPE get on =>\n new $TYPE(this);\n', | 60 '\n $TYPE get on =>\n new $TYPE(this);\n', |
| 63 TYPE=events_class_name) | 61 TYPE=events_class_name) |
| 64 | 62 |
| 65 def AddMembers(self, interface, declare_only=False): | 63 def AddMembers(self, interface, declare_only=False): |
| 66 for const in sorted(interface.constants, ConstantOutputOrder): | 64 for const in sorted(interface.constants, ConstantOutputOrder): |
| 67 self.AddConstant(const) | 65 self.AddConstant(const) |
| 68 | 66 |
| 69 for attr in sorted(interface.attributes, ConstantOutputOrder): | 67 for attr in sorted(interface.attributes, ConstantOutputOrder): |
| 70 if attr.type.id != 'EventListener': | 68 if attr.type.id != 'EventListener': |
| 71 self.AddAttribute(attr, declare_only) | 69 self.AddAttribute(attr, declare_only) |
| (...skipping 214 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 286 '\n' | 284 '\n' |
| 287 ' factory $CTOR.fromBuffer(ArrayBuffer buffer, ' | 285 ' factory $CTOR.fromBuffer(ArrayBuffer buffer, ' |
| 288 '[int byteOffset, int length]) => \n' | 286 '[int byteOffset, int length]) => \n' |
| 289 ' $FACTORY.create$(CTOR)_fromBuffer(buffer, byteOffset, length);\n'
, | 287 ' $FACTORY.create$(CTOR)_fromBuffer(buffer, byteOffset, length);\n'
, |
| 290 CTOR=self._interface.id, | 288 CTOR=self._interface.id, |
| 291 TYPE=self._DartType(typed_array_type), | 289 TYPE=self._DartType(typed_array_type), |
| 292 FACTORY=factory_name) | 290 FACTORY=factory_name) |
| 293 | 291 |
| 294 def _AddConstructor(self, | 292 def _AddConstructor(self, |
| 295 constructor_info, factory_name, factory_constructor_name): | 293 constructor_info, factory_name, factory_constructor_name): |
| 296 self._members_emitter.Emit('\n ///@docsEditable true'); | 294 self._members_emitter.Emit('\n /// @docsEditable true'); |
| 297 | 295 |
| 298 if not factory_constructor_name: | 296 if not factory_constructor_name: |
| 299 factory_constructor_name = '_create' | 297 factory_constructor_name = '_create' |
| 300 factory_parameters = constructor_info.ParametersAsArgumentList() | 298 factory_parameters = constructor_info.ParametersAsArgumentList() |
| 301 has_factory_provider = True | 299 has_factory_provider = True |
| 302 else: | 300 else: |
| 303 factory_parameters = ', '.join(constructor_info.factory_parameters) | 301 factory_parameters = ', '.join(constructor_info.factory_parameters) |
| 304 has_factory_provider = False | 302 has_factory_provider = False |
| 305 | 303 |
| 306 has_optional = any(param_info.is_optional | 304 has_optional = any(param_info.is_optional |
| (...skipping 155 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 462 walk(interface.parents) | 460 walk(interface.parents) |
| 463 else: | 461 else: |
| 464 walk(interface.parents[1:]) | 462 walk(interface.parents[1:]) |
| 465 return result | 463 return result |
| 466 | 464 |
| 467 def _DartType(self, type_name): | 465 def _DartType(self, type_name): |
| 468 return self._type_registry.DartType(type_name) | 466 return self._type_registry.DartType(type_name) |
| 469 | 467 |
| 470 def _IsPrivate(self, name): | 468 def _IsPrivate(self, name): |
| 471 return name.startswith('_') | 469 return name.startswith('_') |
| OLD | NEW |