Refactor analysis server code generation to re-use logic from analyzer.

pkg/analysis_server/tool/spec/to_html.dart

 // 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.
 
 /**
  * Code for displaying the API as HTML.  This is used both for generating a
  * full description of the API as a web page, and for generating doc comments
  * in generated code.
  */
 library to.html;
 
 import 'dart:convert';
 
+import 'package:analyzer/src/codegen/html.dart';
+import 'package:analyzer/src/codegen/tools.dart';
 import 'package:html/dom.dart' as dom;
 
 import 'api.dart';
-import 'codegen_tools.dart';
 import 'from_html.dart';
-import 'html_tools.dart';
 
 /**
  * Embedded stylesheet
  */
 final String stylesheet = '''
 body {
   font-family: sans-serif, serif;
   padding-left: 5%;
   padding-right: 5%;
 }
@@ skipping 44 matching lines @@
   margin-left: 0px;
 
   -webkit-margin-before: 0px;
   -webkit-margin-start: 0px;
   -webkit-padding-start: 0px;
 
   list-style-type: none;
 }
 '''.trim();
 
-final GeneratedFile target = new GeneratedFile('../../doc/api.html', () {
-  ToHtmlVisitor visitor = new ToHtmlVisitor(readApi());
+final GeneratedFile target =
+    new GeneratedFile('doc/api.html', (String pkgPath) {
+  ToHtmlVisitor visitor = new ToHtmlVisitor(readApi(pkgPath));
   dom.Document document = new dom.Document();
   document.append(new dom.DocumentType('html', null, null));
   for (dom.Node node in visitor.collectHtml(visitor.visitApi)) {
     document.append(node);
   }
   return document.outerHtml;
 });
 
 /**
- * Translate spec_input.html into api.html.
- */
-main() {
-  target.generate();
-}
-
-/**
  * Visitor that records the mapping from HTML elements to various kinds of API
  * nodes.
  */
 class ApiMappings extends HierarchicalApiVisitor {
   Map<dom.Element, Domain> domains = <dom.Element, Domain>{};
 
   ApiMappings(Api api) : super(api);
 
   @override
   void visitDomain(Domain domain) {
@@ skipping 85 matching lines @@
       if (subType == null) {
         p(() {
           write('none');
         });
       } else {
         visitTypeDecl(subType);
       }
     }
   }
 
+  void generateDomainIndex(Domain domain) {
+    h4(() {
+      write(domain.name);
+      write(' (');
+      link('domain_${domain.name}', () => write('\u2191'));
+      write(')');
+    });
+    if (domain.requests.length > 0) {
+      element('div', {'class': 'subindex'}, () {
+        generateRequestsIndex(domain.requests);
+        if (domain.notifications.length > 0) {
+          generateNotificationsIndex(domain.notifications);
+        }
+      });
+    } else if (domain.notifications.length > 0) {
+      element('div', {'class': 'subindex'}, () {
+        generateNotificationsIndex(domain.notifications);
+      });
+    }
+  }
+
+  void generateIndex() {
+    h3(() => write('Domains'));
+    for (var domain in api.domains) {
+      if (domain.requests.length == 0 && domain.notifications == 0) continue;
+      generateDomainIndex(domain);
+    }
+
+    generateTypesIndex(definedTypes);
+    generateRefactoringsIndex(api.refactorings);
+  }
+
+  void generateNotificationsIndex(Iterable<Notification> notifications) {
+    h5(() => write("Notifications"));
+    element('div', {'class': 'subindex'}, () {
+      element('ul', {}, () {
+        for (var notification in notifications) {
+          element(
+              'li',
+              {},
+              () => link('notification_${notification.longEvent}',
+                  () => write(notification.event)));
+        }
+      });
+    });
+  }
+
+  void generateRefactoringsIndex(Iterable<Refactoring> refactorings) {
+    h3(() {
+      write("Refactorings");
+      write(' (');
+      link('refactorings', () => write('\u2191'));
+      write(')');
+    });
+    // TODO: Individual refactorings are not yet hyperlinked.
+    element('div', {'class': 'subindex'}, () {
+      element('ul', {}, () {
+        for (var refactoring in refactorings) {
+          element(
+              'li',
+              {},
+              () => link('refactoring_${refactoring.kind}',
+                  () => write(refactoring.kind)));
+        }
+      });
+    });
+  }
+
+  void generateRequestsIndex(Iterable<Request> requests) {
+    h5(() => write("Requests"));
+    element('ul', {}, () {
+      for (var request in requests) {
+        element(
+            'li',
+            {},
+            () => link(
+                'request_${request.longMethod}', () => write(request.method)));
+      }
+    });
+  }
+
+  void generateTypesIndex(Set<String> types) {
+    h3(() {
+      write("Types");
+      write(' (');
+      link('types', () => write('\u2191'));
+      write(')');
+    });
+    element('div', {'class': 'subindex'}, () {
+      element('ul', {}, () {
+        for (var type in types) {
+          element('li', {}, () => link('type_$type', () => write(type)));
+        }
+      });
+    });
+  }
+
   void javadocParams(TypeObject typeObject) {
     if (typeObject != null) {
       for (TypeObjectField field in typeObject.fields) {
         hangingIndent(() {
           write('@param ${field.name} ');
           translateHtml(field.html, squashParagraphs: true);
         });
       }
     }
   }
@@ skipping 269 matching lines @@
   @override
   void visitTypeReference(TypeReference typeReference) {}
 
   @override
   void visitTypes(Types types) {
     translateHtml(types.html);
     dl(() {
       super.visitTypes(types);
     });
   }
-
-  void generateIndex() {
-    h3(() => write('Domains'));
-    for (var domain in api.domains) {
-      if (domain.requests.length == 0 && domain.notifications == 0) continue;
-      generateDomainIndex(domain);
-    }
-
-    generateTypesIndex(definedTypes);
-    generateRefactoringsIndex(api.refactorings);
-  }
-
-  void generateDomainIndex(Domain domain) {
-    h4(() {
-      write(domain.name);
-      write(' (');
-      link('domain_${domain.name}', () => write('\u2191'));
-      write(')');
-    });
-    if (domain.requests.length > 0) {
-      element('div', {'class': 'subindex'}, () {
-        generateRequestsIndex(domain.requests);
-        if (domain.notifications.length > 0) {
-          generateNotificationsIndex(domain.notifications);
-        }
-      });
-    } else if (domain.notifications.length > 0) {
-      element('div', {'class': 'subindex'}, () {
-        generateNotificationsIndex(domain.notifications);
-      });
-    }
-  }
-
-  void generateRequestsIndex(Iterable<Request> requests) {
-    h5(() => write("Requests"));
-    element('ul', {}, () {
-      for (var request in requests) {
-        element(
-            'li',
-            {},
-            () => link(
-                'request_${request.longMethod}', () => write(request.method)));
-      }
-    });
-  }
-
-  void generateNotificationsIndex(Iterable<Notification> notifications) {
-    h5(() => write("Notifications"));
-    element('div', {'class': 'subindex'}, () {
-      element('ul', {}, () {
-        for (var notification in notifications) {
-          element(
-              'li',
-              {},
-              () => link('notification_${notification.longEvent}',
-                  () => write(notification.event)));
-        }
-      });
-    });
-  }
-
-  void generateTypesIndex(Set<String> types) {
-    h3(() {
-      write("Types");
-      write(' (');
-      link('types', () => write('\u2191'));
-      write(')');
-    });
-    element('div', {'class': 'subindex'}, () {
-      element('ul', {}, () {
-        for (var type in types) {
-          element('li', {}, () => link('type_$type', () => write(type)));
-        }
-      });
-    });
-  }
-
-  void generateRefactoringsIndex(Iterable<Refactoring> refactorings) {
-    h3(() {
-      write("Refactorings");
-      write(' (');
-      link('refactorings', () => write('\u2191'));
-      write(')');
-    });
-    // TODO: Individual refactorings are not yet hyperlinked.
-    element('div', {'class': 'subindex'}, () {
-      element('ul', {}, () {
-        for (var refactoring in refactorings) {
-          element(
-              'li',
-              {},
-              () => link('refactoring_${refactoring.kind}',
-                  () => write(refactoring.kind)));
-        }
-      });
-    });
-  }
 }
 
 /**
  * Visitor that generates a compact representation of a type, such as:
  *
  * {
  *   "id": String
  *   "error": optional Error
  *   "result": {
  *     "version": String
@@ skipping 99 matching lines @@
     bool verticalBarNeeded = false;
     for (TypeDecl choice in typeUnion.choices) {
       if (verticalBarNeeded) {
         write(' | ');
       }
       visitTypeDecl(choice);
       verticalBarNeeded = true;
     }
   }
 }