Add a task for computing all constant values in a compilation unit.

pkg/analyzer/lib/task/dart.dart

 // Copyright (c) 2015, 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 analyzer.task.dart;
 
 import 'package:analyzer/src/generated/ast.dart';
 import 'package:analyzer/src/generated/element.dart';
 import 'package:analyzer/src/generated/error.dart';
 import 'package:analyzer/src/generated/scanner.dart';
 import 'package:analyzer/src/generated/source.dart';
 import 'package:analyzer/src/generated/utilities_general.dart';
 import 'package:analyzer/src/task/dart.dart';
 import 'package:analyzer/task/model.dart';
 
 /**
+ * The resolved [CompilationUnit] associated with a compilation unit, with
+ * constants resolved.
+ *
+ * The result is only available for [LibrarySpecificUnit]s.
+ */
+final ResultDescriptor<CompilationUnit> CONSTANT_RESOLVED_UNIT =
+    new ResultDescriptor<CompilationUnit>('CONSTANT_RESOLVED_UNIT', null,
+        cachingPolicy: AST_CACHING_POLICY);
+
+/**
  * The analysis errors associated with a [Source] representing a compilation
  * unit.
  */
 final ListResultDescriptor<AnalysisError> DART_ERRORS =
     new ListResultDescriptor<AnalysisError>(
         'DART_ERRORS', AnalysisError.NO_ERRORS);
 
 /**
  * The sources of the libraries that are explicitly imported into a library.
  *
@@ skipping 70 matching lines @@
  *
  * The AST structure will not have resolution information associated with it.
  *
  * The result is only available for [Source]s representing a compilation unit.
  */
 final ResultDescriptor<CompilationUnit> PARSED_UNIT =
     new ResultDescriptor<CompilationUnit>('PARSED_UNIT', null,
         cachingPolicy: AST_CACHING_POLICY);
 
 /**
- * The resolved [CompilationUnit] associated with a compilation unit.
+ * The resolved [CompilationUnit] associated with a compilation unit, with
+ * constants not yet resolved.

[Brian Wilkerson, 2015/05/11 20:48:45]

I have to wonder how many clients want an AST in which constants have not yet
been resolved.

It might be less confusing if RESOLVED_UNIT were renamed to RESOLVED_UNIT5,
moved to the internal library, and CONSTANT_RESOLVED_UNIT were renamed to
RESOLVED_UNIT.

[Paul Berry, 2015/05/11 22:07:39]

Good point.  I will do this in a follow-up CL.

  *
  * The result is only available for [LibrarySpecificUnit]s.
  */
 final ResultDescriptor<CompilationUnit> RESOLVED_UNIT =
     new ResultDescriptor<CompilationUnit>('RESOLVED_UNIT', null,
         cachingPolicy: AST_CACHING_POLICY);
 
 /**
  * The kind of a [Source].
  */
@@ skipping 58 matching lines @@
   @override
   bool operator ==(other) {
     return other is LibrarySpecificUnit &&
         other.library == library &&
         other.unit == unit;
   }
 
   @override
   String toString() => '$unit in $library';
 }