Initial cut at generating the AnalysisServer.java interface. Currently this generates a commented o…

pkg/analysis_server/tool/spec/codegen_inttest_methods.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 generation for the file "integration_test_methods.dart".
  */
 library codegenInttestMethods;
 
 import 'dart:convert';
@@ skipping 25 matching lines @@
    */
   List<String> notificationSwitchContents = <String>[];
 
   CodegenInttestMethodsVisitor(Api api)
       : super(api),
         toHtmlVisitor = new ToHtmlVisitor(api);
 
   @override
   visitApi() {
     outputHeader();
+    writeln();
     writeln('/**');
     writeln(' * Convenience methods for running integration tests');
     writeln(' */');
     writeln('library test.integration.methods;');
     writeln();
     writeln("import 'dart:async';");
     writeln();
     writeln("import 'package:unittest/unittest.dart';");
     writeln();
     writeln("import 'integration_tests.dart';");
     writeln("import 'protocol_matchers.dart';");
     writeln();
     writeln();
     writeln('/**');
     writeln(' * Convenience methods for running integration tests');
     writeln(' */');
     writeln('abstract class IntegrationTestMixin {');
     indent(() {
       writeln('Server get server;');
       super.visitApi();
       writeln();
       docComment(toHtmlVisitor.collectHtml(() {
         toHtmlVisitor.writeln('Initialize the fields in InttestMixin, and');
         toHtmlVisitor.writeln('ensure that notifications will be handled.');
-      }), false);
+      }));
       writeln('void initializeInttestMixin() {');
       indent(() {
         write(fieldInitializationCode.join());
       });
       writeln('}');
       writeln();
       docComment(toHtmlVisitor.collectHtml(() {
         toHtmlVisitor.writeln('Dispatch the notification named [event], and');
         toHtmlVisitor.writeln('containing parameters [params], to the');
         toHtmlVisitor.writeln('appropriate stream.');
-      }), false);
+      }));
       writeln('void dispatchNotification(String event, params) {');
       indent(() {
         writeln('switch (event) {');
         indent(() {
           write(notificationSwitchContents.join());
           writeln('default:');
           indent(() {
             writeln("fail('Unexpected notification: \$event');");
             writeln('break;');
           });
         });
         writeln('}');
       });
       writeln('}');
     });
     writeln('}');
   }
 
   @override
   visitNotification(Notification notification) {
     String streamName = camelJoin(['on', notification.domainName, notification.event]);
     writeln();
     docComment(toHtmlVisitor.collectHtml(() {
       toHtmlVisitor.translateHtml(notification.html);
       toHtmlVisitor.describePayload(notification.params, 'Parameters');
-    }), false);
+    }));
     writeln('Stream $streamName;');
     writeln();
     docComment(toHtmlVisitor.collectHtml(() {
       toHtmlVisitor.write('Stream controller for [$streamName].');
-    }), false);
+    }));
     writeln('StreamController _$streamName;');
     fieldInitializationCode.add(collectCode(() {
       writeln('_$streamName = new StreamController(sync: true);');
       writeln('$streamName = _$streamName.stream.asBroadcastStream();');
     }));
     notificationSwitchContents.add(collectCode(() {
       writeln('case ${JSON.encode(notification.longEvent)}:');
       indent(() {
         String paramsValidator = camelJoin(['is', notification.domainName,
             notification.event, 'params']);
@@ skipping 18 matching lines @@
         }
       }
     }
     optionalArgs.add('bool checkTypes: true');
     args.add('{${optionalArgs.join(', ')}}');
     writeln();
     docComment(toHtmlVisitor.collectHtml(() {
       toHtmlVisitor.translateHtml(request.html);
       toHtmlVisitor.describePayload(request.params, 'Parameters');
       toHtmlVisitor.describePayload(request.result, 'Returns');
-    }), false);
+    }));
     writeln('Future $methodName(${args.join(', ')}) {');
     indent(() {
       String paramsValidator = camelJoin(['is', request.domainName,
           request.method, 'params']);
       String resultValidator = camelJoin(['is', request.domainName,
           request.method, 'result']);
       String paramsVar = 'null';
       if (request.params != null) {
         paramsVar = 'params';
         writeln('Map<String, dynamic> params = {};');
@@ skipping 80 matching lines @@
  * Translate spec_input.html into protocol_matchers.dart.
  */
 main() {
   CodegenInttestMethodsVisitor visitor = new CodegenInttestMethodsVisitor(
       readApi());
   String code = visitor.collectCode(visitor.visitApi);
   File outputFile = new File(
       '../../test/integration/integration_test_methods.dart');
   outputFile.writeAsStringSync(code);
 }