Three new analysis server integration tests

pkg/analysis_server/test/integration/integration_tests.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.
 
 library test.integration.analysis;
 
 import 'dart:async';
 import 'dart:collection';
 import 'dart:convert';
 import 'dart:io';
@@ skipping 124 matching lines @@
     return server.kill().then((_) {
       sourceDirectory.deleteSync(recursive: true);
     });
   }
 }
 
 // Matchers for data types defined in the analysis server API
 // ==========================================================
 // TODO(paulberry): add more matchers.
 
-const Matcher isString = const isInstanceOf<String>('String');
-
-const Matcher isInt = const isInstanceOf<int>('int');
-
-const Matcher isBool = const isInstanceOf<bool>('bool');
+// Matchers common to all domains
+// ------------------------------
 
 const Matcher isResultResponse = const MatchesJsonObject('result response',
     const {
   'id': isString
 }, optionalFields: const {
   'result': anything
 });
 
 const Matcher isError = const MatchesJsonObject('Error', const {
   // TODO(paulberry): once we decide what the set of permitted error codes are,
@@ skipping 13 matching lines @@
   'id': isString,
   'error': isError
 });
 
 const Matcher isNotification = const MatchesJsonObject('notification', const {
   'event': isString
 }, optionalFields: const {
   'params': isMap
 });
 
+// Matchers for specific responses and notifications
+// -------------------------------------------------
+
+// server.getVersion
 const Matcher isServerGetVersionResult = const MatchesJsonObject(
     'server.getVersion result', const {
   'version': isString
 });
 
+// server.status
 const Matcher isServerStatusParams = const MatchesJsonObject(
     'server.status params', null, optionalFields: const {
   'analysis': isAnalysisStatus
 });
 
-final Matcher isErrorSeverity = isIn(['INFO', 'WARNING', 'ERROR']);
-
-final Matcher isErrorType = isIn(['COMPILE_TIME_ERROR', 'HINT',
-    'STATIC_TYPE_WARNING', 'STATIC_WARNING', 'SYNTACTIC_ERROR', 'TODO']);
-
-const Matcher isLocation = const MatchesJsonObject('Location', const {
-  'file': isString,
-  'offset': isInt,
-  'length': isInt,
-  'startLine': isInt,
-  'startColumn': isInt
+// analysis.getHover
+final Matcher isAnalysisGetHoverResult = new MatchesJsonObject(
+    'analysis.getHover result', {
+  'hovers': isListOf(isHoverInformation)
 });
 
+// Matchers for data types used in responses and notifications
+// -----------------------------------------------------------
+
+const Matcher isString = const isInstanceOf<String>('String');
+
+const Matcher isInt = const isInstanceOf<int>('int');
+
+const Matcher isBool = const isInstanceOf<bool>('bool');
+
+// AnalysisError
 final Matcher isAnalysisError = new MatchesJsonObject('AnalysisError', {
   'severity': isErrorSeverity,
   'type': isErrorType,
   'location': isLocation,
   'message': isString,
 }, optionalFields: {
   'correction': isString
 });
 
+// AnalysisStatus
 const Matcher isAnalysisStatus = const MatchesJsonObject('AnalysisStatus', const
     {
   'analyzing': isBool
 }, optionalFields: const {
   'analysisTarget': isString
 });
 
+// ErrorSeverity
+final Matcher isErrorSeverity = isIn(['INFO', 'WARNING', 'ERROR']);
+
+// ErrorType
+final Matcher isErrorType = isIn(['COMPILE_TIME_ERROR', 'HINT',
+    'STATIC_TYPE_WARNING', 'STATIC_WARNING', 'SYNTACTIC_ERROR', 'TODO']);
+
+// HoverInformation
+const Matcher isHoverInformation = const MatchesJsonObject('HoverInformation',
+    const {
+  'offset': isInt,
+  'length': isInt
+}, optionalFields: const {
+  'containingLibraryPath': isString,
+  'containingLibraryName': isString,
+  'dartdoc': isString,
+  'elementDescription': isString,
+  'elementKind': isString,
+  'parameter': isString,
+  'propagatedType': isString,
+  'staticType': isString
+});
+
+// Location
+const Matcher isLocation = const MatchesJsonObject('Location', const {
+  'file': isString,
+  'offset': isInt,
+  'length': isInt,
+  'startLine': isInt,
+  'startColumn': isInt
+});
+
 
 /**
  * Type of closures used by MatchesJsonObject to record field mismatches.
  */
 typedef Description MismatchDescriber(Description mismatchDescription, bool
     verbose);
 
 /**
  * Matcher that matches a JSON object, with a given set of required and
  * optional fields, and their associated types (expressed as [Matcher]s).
@@ skipping 104 matching lines @@
           mismatchDescription = mismatchDescription.add('; ').add(subDescription
               );
         }
         return mismatchDescription.add(')');
       });
     }
   }
 }
 
 /**
+ * Matcher that matches a list of objects, each of which satisfies the given
+ * matcher.
+ */
+class _ListOf extends Matcher {
+  /**
+   * Matcher which every element of the list must satisfy.
+   */
+  final Matcher elementMatcher;
+
+  /**
+   * Iterable matcher which we use to test the contents of the list.
+   */
+  final Matcher iterableMatcher;
+
+  _ListOf(elementMatcher)
+      : elementMatcher = elementMatcher,
+        iterableMatcher = everyElement(elementMatcher);
+
+  @override
+  bool matches(item, Map matchState) {
+    if (item is! List) {
+      return false;
+    }
+    return iterableMatcher.matches(item, matchState);
+  }
+
+  @override
+  Description describe(Description description) => description.add('List of '
+      ).addDescriptionOf(elementMatcher);
+
+  @override
+  Description describeMismatch(item, Description mismatchDescription, Map
+      matchState, bool verbose) {
+    if (item is! List) {
+      return super.describeMismatch(item, mismatchDescription, matchState,
+          verbose);
+    } else {
+      return iterableMatcher.describeMismatch(item, mismatchDescription,
+          matchState, verbose);
+    }
+  }
+}
+
+Matcher isListOf(Matcher elementMatcher) => new _ListOf(elementMatcher);
+
+/**
  * Instances of the class [Server] manage a connection to a server process, and
  * facilitate communication to and from the server.
  */
 class Server {
   /**
    * Server process object.
    */
   Process _process;
 
   /**
@@ skipping 174 matching lines @@
    * Record a message that was exchanged with the server, and print it out if
    * [debugStdio] has been called.
    */
   void _recordStdio(String line) {
     if (_debuggingStdio) {
       print(line);
     }
     _recordedStdio.add(line);
   }
 }