Add a parseDartString method to pkg/analyzer.

pkg/analyzer_experimental/lib/analyzer.dart

 // Copyright (c) 2013, 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;
 
 import 'dart:io';
 
 import 'package:path/path.dart' as pathos;
 
 import 'src/error.dart';
 import 'src/generated/ast.dart';
 import 'src/generated/error.dart';
 import 'src/generated/parser.dart';
 import 'src/generated/scanner.dart';
 import 'src/generated/source_io.dart';
+import 'src/string_source.dart';
 
 export 'src/error.dart';
 export 'src/generated/ast.dart';
 export 'src/generated/error.dart';
 export 'src/generated/utilities_dart.dart';
 
 /// Parses a Dart file into an AST.
 CompilationUnit parseDartFile(String path) {
   var contents = new File(path).readAsStringSync();
   var errorCollector = new _ErrorCollector();
@@ skipping 12 matching lines @@
   var token = scanner.tokenize();
   var parser = new Parser(source, errorCollector);
   var unit = parser.parseCompilationUnit(token);
   unit.lineInfo = new LineInfo(scanner.lineStarts);
 
   if (errorCollector.hasErrors) throw errorCollector.group;
 
   return unit;
 }
 
+/// Parses a string of Dart code into an AST.
+///
+/// If [name] is passed, it's used in error messages as the name of the code
+/// being parsed.
+CompilationUnit parseCompilationUnit(String contents, {String name}) {
+  if (name == null) name = '<unknown source>';
+  var source = new StringSource(contents, name);
+  var errorCollector = new _ErrorCollector();
+  var scanner = new StringScanner(source, contents, errorCollector);
+  var token = scanner.tokenize();
+  var parser = new Parser(source, errorCollector);
+  var unit = parser.parseCompilationUnit(token);
+  unit.lineInfo = new LineInfo(scanner.lineStarts);
+
+  if (errorCollector.hasErrors) throw errorCollector.group;
+
+  return unit;
+}
+
 /// Converts an AST node representing a string literal into a [String].
 String stringLiteralToString(StringLiteral literal) {
   return literal.stringValue;
 }
 
 /// A simple error listener that collects errors into an [AnalysisErrorGroup].
 class _ErrorCollector extends AnalysisErrorListener {
   final _errors = <AnalysisError>[];
 
   /// Whether any errors where collected.
   bool get hasErrors => !_errors.isEmpty;
 
   /// The group of errors collected.
   AnalyzerErrorGroup get group =>
     new AnalyzerErrorGroup.fromAnalysisErrors(_errors);
 
   _ErrorCollector();
 
   void onError(AnalysisError error) => _errors.add(error);
 }