Second half of HTML json docs. This reads the json file and inserts the docs.

tools/dom/scripts/htmleventgenerator.py

 #!/usr/bin/python
 # Copyright (c) 2012, 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.
 
 """This module provides functionality to generate dart:html event classes."""
 
 import logging
-from generator import FindCommonAnnotations, FormatAnnotations
+from generator import GetAnnotationsAndComments, FormatAnnotationsAndComments
 
 _logger = logging.getLogger('dartgenerator')
 
 # Events without onEventName attributes in the  IDL we want to support.
 # We can automatically extract most event names by checking for
 # onEventName methods in the IDL but some events aren't listed so we need
 # to manually add them here so that they are easy for users to find.
 _html_manual_events = {
   'Element': ['touchleave', 'touchenter', 'webkitTransitionEnd'],
   'Window': ['DOMContentLoaded']
@@ skipping 356 matching lines @@
 
 class HtmlEventGenerator(object):
 
   def __init__(self, database, renamer, template_loader):
     self._event_classes = set()
     self._database = database
     self._renamer = renamer
     self._template_loader = template_loader
 
   def EmitStreamProviders(self, interface, custom_events,
-      members_emitter):
+      members_emitter, library_name):
     events = self._GetEvents(interface, custom_events)
     if not events:
       return
 
     for event_info in events:
       (dom_name, html_name, event_type) = event_info
 
       # If we're using a different provider, then don't declare one.
       if self._GetEventRedirection(interface, html_name, event_type):
         continue
 
-      annotations = FormatAnnotations(
-          FindCommonAnnotations(interface.id, dom_name), '  ')
+      annotations = FormatAnnotationsAndComments(
+          GetAnnotationsAndComments(interface.id, dom_name, library_name), '  ')
 
       members_emitter.Emit(
           "\n"
           "  $(ANNOTATIONS)static const EventStreamProvider<$TYPE> "
           "$(NAME)Event = const EventStreamProvider<$TYPE>('$DOM_NAME');\n",
           ANNOTATIONS=annotations,
           NAME=html_name,
           DOM_NAME=dom_name,
           TYPE=event_type)
 
   def EmitStreamGetters(self, interface, custom_events,
-      members_emitter):
+      members_emitter, library_name):
     events = self._GetEvents(interface, custom_events)
     if not events:
       return
 
     for event_info in events:
       (dom_name, html_name, event_type) = event_info
       getter_name = 'on%s%s' % (html_name[:1].upper(), html_name[1:])
 
       # If the provider is declared elsewhere, point to that.
       redirection = self._GetEventRedirection(interface, html_name, event_type)
       if redirection:
         provider = '%s.%sEvent' % (redirection, html_name)
       else:
         provider = html_name + 'Event'
 
-      annotations = FormatAnnotations(
-          FindCommonAnnotations(interface.id, dom_name), '  ')
+      annotations = FormatAnnotationsAndComments(
+          GetAnnotationsAndComments(interface.id, dom_name, library_name), '  ')
 
       members_emitter.Emit(
           "\n"
           "  $(ANNOTATIONS)Stream<$TYPE> get $(NAME) => "
           "$PROVIDER.forTarget(this);\n",
           ANNOTATIONS=annotations,
           NAME=getter_name,
           PROVIDER=provider,
           TYPE=event_type)
 
@@ skipping 148 matching lines @@
     parent_events_class_name = 'Events'
     interfaces_with_events = set()
     for parent in self._database.Hierarchy(interface):
       if parent != interface and parent.id in self._event_classes:
         parent_name = self._renamer.RenameInterface(parent)
         parent_events_class_name = parent_name + 'Events'
         interfaces_with_events.add(parent)
     if len(interfaces_with_events) > 1:
       raise Exception('Only one parent event class allowed ' + interface.id)
     return parent_events_class_name