OLD | NEW |
| (Empty) |
1 // Copyright (c) 2013, the Dart project authors. Please see the AUTHORS file | |
2 // for details. All rights reserved. Use of this source code is governed by a | |
3 // BSD-style license that can be found in the LICENSE file. | |
4 | |
5 library analyzer; | |
6 | |
7 import 'dart:io'; | |
8 | |
9 import 'package:path/path.dart' as pathos; | |
10 | |
11 import 'src/error.dart'; | |
12 import 'src/generated/ast.dart'; | |
13 import 'src/generated/error.dart'; | |
14 import 'src/generated/parser.dart'; | |
15 import 'src/generated/scanner.dart'; | |
16 import 'src/generated/source_io.dart'; | |
17 import 'src/string_source.dart'; | |
18 | |
19 export 'src/error.dart'; | |
20 export 'src/generated/ast.dart'; | |
21 export 'src/generated/error.dart'; | |
22 export 'src/generated/utilities_dart.dart'; | |
23 | |
24 /// Parses a string of Dart code into an AST. | |
25 /// | |
26 /// If [name] is passed, it's used in error messages as the name of the code | |
27 /// being parsed. | |
28 /// | |
29 /// Throws an [AnalyzerErrorGroup] if any errors occurred, unless | |
30 /// [suppressErrors] is `true`, in which case any errors are discarded. | |
31 /// | |
32 /// If [parseFunctionBodies] is [false] then only function signatures will be | |
33 /// parsed. | |
34 CompilationUnit parseCompilationUnit(String contents, | |
35 {String name, bool suppressErrors: false, bool parseFunctionBodies: true}) { | |
36 if (name == null) name = '<unknown source>'; | |
37 var source = new StringSource(contents, name); | |
38 return _parseSource(contents, source, | |
39 suppressErrors: suppressErrors, parseFunctionBodies: parseFunctionBodies); | |
40 } | |
41 | |
42 /// Parses a Dart file into an AST. | |
43 /// | |
44 /// Throws an [AnalyzerErrorGroup] if any errors occurred, unless | |
45 /// [suppressErrors] is `true`, in which case any errors are discarded. | |
46 /// | |
47 /// If [parseFunctionBodies] is [false] then only function signatures will be | |
48 /// parsed. | |
49 CompilationUnit parseDartFile(String path, | |
50 {bool suppressErrors: false, bool parseFunctionBodies: true}) { | |
51 String contents = new File(path).readAsStringSync(); | |
52 var sourceFactory = new SourceFactory([new FileUriResolver()]); | |
53 | |
54 var absolutePath = pathos.absolute(path); | |
55 var source = sourceFactory.forUri(pathos.toUri(absolutePath).toString()); | |
56 if (source == null) { | |
57 throw new ArgumentError("Can't get source for path $path"); | |
58 } | |
59 if (!source.exists()) { | |
60 throw new ArgumentError("Source $source doesn't exist"); | |
61 } | |
62 | |
63 return _parseSource(contents, source, | |
64 suppressErrors: suppressErrors, parseFunctionBodies: parseFunctionBodies); | |
65 } | |
66 | |
67 CompilationUnit _parseSource(String contents, Source source, | |
68 {bool suppressErrors: false, bool parseFunctionBodies: true}) { | |
69 var reader = new CharSequenceReader(contents); | |
70 var errorCollector = new _ErrorCollector(); | |
71 var scanner = new Scanner(source, reader, errorCollector); | |
72 var token = scanner.tokenize(); | |
73 var parser = new Parser(source, errorCollector) | |
74 ..parseFunctionBodies = parseFunctionBodies; | |
75 var unit = parser.parseCompilationUnit(token) | |
76 ..lineInfo = new LineInfo(scanner.lineStarts); | |
77 | |
78 if (errorCollector.hasErrors && !suppressErrors) throw errorCollector.group; | |
79 | |
80 return unit; | |
81 } | |
82 | |
83 /// Parses the script tag and directives in a string of Dart code into an AST. | |
84 /// | |
85 /// Stops parsing when the first non-directive is encountered. The rest of the | |
86 /// string will not be parsed. | |
87 /// | |
88 /// If [name] is passed, it's used in error messages as the name of the code | |
89 /// being parsed. | |
90 /// | |
91 /// Throws an [AnalyzerErrorGroup] if any errors occurred, unless | |
92 /// [suppressErrors] is `true`, in which case any errors are discarded. | |
93 CompilationUnit parseDirectives(String contents, | |
94 {String name, bool suppressErrors: false}) { | |
95 if (name == null) name = '<unknown source>'; | |
96 var source = new StringSource(contents, name); | |
97 var errorCollector = new _ErrorCollector(); | |
98 var reader = new CharSequenceReader(contents); | |
99 var scanner = new Scanner(source, reader, errorCollector); | |
100 var token = scanner.tokenize(); | |
101 var parser = new Parser(source, errorCollector); | |
102 var unit = parser.parseDirectives(token); | |
103 unit.lineInfo = new LineInfo(scanner.lineStarts); | |
104 | |
105 if (errorCollector.hasErrors && !suppressErrors) throw errorCollector.group; | |
106 | |
107 return unit; | |
108 } | |
109 | |
110 /// Converts an AST node representing a string literal into a [String]. | |
111 String stringLiteralToString(StringLiteral literal) { | |
112 return literal.stringValue; | |
113 } | |
114 | |
115 /// A simple error listener that collects errors into an [AnalysisErrorGroup]. | |
116 class _ErrorCollector extends AnalysisErrorListener { | |
117 final _errors = <AnalysisError>[]; | |
118 | |
119 _ErrorCollector(); | |
120 | |
121 /// The group of errors collected. | |
122 AnalyzerErrorGroup get group => | |
123 new AnalyzerErrorGroup.fromAnalysisErrors(_errors); | |
124 | |
125 /// Whether any errors where collected. | |
126 bool get hasErrors => !_errors.isEmpty; | |
127 | |
128 void onError(AnalysisError error) => _errors.add(error); | |
129 } | |
OLD | NEW |