OLD | NEW |
| (Empty) |
1 // Copyright (c) 2014, 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 glob.single_component; | |
6 | |
7 import 'package:path/path.dart' as p; | |
8 import 'package:string_scanner/string_scanner.dart'; | |
9 | |
10 import 'ast.dart'; | |
11 import 'utils.dart'; | |
12 | |
13 const _HYPHEN = 0x2D; | |
14 const _SLASH = 0x2F; | |
15 | |
16 /// A parser for globs. | |
17 class Parser { | |
18 /// The scanner used to scan the source. | |
19 final StringScanner _scanner; | |
20 | |
21 /// The path context for the glob. | |
22 final p.Context _context; | |
23 | |
24 Parser(String component, this._context) | |
25 : _scanner = new StringScanner(component); | |
26 | |
27 /// Parses an entire glob. | |
28 SequenceNode parse() => _parseSequence(); | |
29 | |
30 /// Parses a [SequenceNode]. | |
31 /// | |
32 /// If [inOptions] is true, this is parsing within an [OptionsNode]. | |
33 SequenceNode _parseSequence({bool inOptions: false}) { | |
34 var nodes = []; | |
35 | |
36 if (_scanner.isDone) { | |
37 _scanner.error('expected a glob.', position: 0, length: 0); | |
38 } | |
39 | |
40 while (!_scanner.isDone) { | |
41 if (inOptions && (_scanner.matches(',') || _scanner.matches('}'))) break; | |
42 nodes.add(_parseNode(inOptions: inOptions)); | |
43 } | |
44 | |
45 return new SequenceNode(nodes); | |
46 } | |
47 | |
48 /// Parses an [AstNode]. | |
49 /// | |
50 /// If [inOptions] is true, this is parsing within an [OptionsNode]. | |
51 AstNode _parseNode({bool inOptions: false}) { | |
52 var star = _parseStar(); | |
53 if (star != null) return star; | |
54 | |
55 var anyChar = _parseAnyChar(); | |
56 if (anyChar != null) return anyChar; | |
57 | |
58 var range = _parseRange(); | |
59 if (range != null) return range; | |
60 | |
61 var options = _parseOptions(); | |
62 if (options != null) return options; | |
63 | |
64 return _parseLiteral(inOptions: inOptions); | |
65 } | |
66 | |
67 /// Tries to parse a [StarNode] or a [DoubleStarNode]. | |
68 /// | |
69 /// Returns `null` if there's not one to parse. | |
70 AstNode _parseStar() { | |
71 if (!_scanner.scan('*')) return null; | |
72 return _scanner.scan('*') ? new DoubleStarNode(_context) : new StarNode(); | |
73 } | |
74 | |
75 /// Tries to parse an [AnyCharNode]. | |
76 /// | |
77 /// Returns `null` if there's not one to parse. | |
78 AstNode _parseAnyChar() { | |
79 if (!_scanner.scan('?')) return null; | |
80 return new AnyCharNode(); | |
81 } | |
82 | |
83 /// Tries to parse an [RangeNode]. | |
84 /// | |
85 /// Returns `null` if there's not one to parse. | |
86 AstNode _parseRange() { | |
87 if (!_scanner.scan('[')) return null; | |
88 if (_scanner.matches(']')) _scanner.error('unexpected "]".'); | |
89 var negated = _scanner.scan('!') || _scanner.scan('^'); | |
90 | |
91 readRangeChar() { | |
92 var char = _scanner.readChar(); | |
93 if (negated || char != _SLASH) return char; | |
94 _scanner.error('"/" may not be used in a range.', | |
95 position: _scanner.position - 1); | |
96 } | |
97 | |
98 var ranges = []; | |
99 while (!_scanner.scan(']')) { | |
100 var start = _scanner.position; | |
101 // Allow a backslash to escape a character. | |
102 _scanner.scan('\\'); | |
103 var char = readRangeChar(); | |
104 | |
105 if (_scanner.scan('-')) { | |
106 if (_scanner.matches(']')) { | |
107 ranges.add(new Range.singleton(char)); | |
108 ranges.add(new Range.singleton(_HYPHEN)); | |
109 continue; | |
110 } | |
111 | |
112 // Allow a backslash to escape a character. | |
113 _scanner.scan('\\'); | |
114 | |
115 var end = readRangeChar(); | |
116 | |
117 if (end < char) { | |
118 _scanner.error("Range out of order.", | |
119 position: start, | |
120 length: _scanner.position - start); | |
121 } | |
122 ranges.add(new Range(char, end)); | |
123 } else { | |
124 ranges.add(new Range.singleton(char)); | |
125 } | |
126 } | |
127 | |
128 return new RangeNode(ranges, negated: negated); | |
129 } | |
130 | |
131 /// Tries to parse an [OptionsNode]. | |
132 /// | |
133 /// Returns `null` if there's not one to parse. | |
134 AstNode _parseOptions() { | |
135 if (!_scanner.scan('{')) return null; | |
136 if (_scanner.matches('}')) _scanner.error('unexpected "}".'); | |
137 | |
138 var options = []; | |
139 do { | |
140 options.add(_parseSequence(inOptions: true)); | |
141 } while (_scanner.scan(',')); | |
142 | |
143 // Don't allow single-option blocks. | |
144 if (options.length == 1) _scanner.expect(','); | |
145 _scanner.expect('}'); | |
146 | |
147 return new OptionsNode(options); | |
148 } | |
149 | |
150 /// Parses a [LiteralNode]. | |
151 AstNode _parseLiteral({bool inOptions: false}) { | |
152 // If we're in an options block, we want to stop parsing as soon as we hit a | |
153 // comma. Otherwise, commas are fair game for literals. | |
154 var regExp = new RegExp( | |
155 inOptions ? r'[^*{[?\\}\],()]*' : r'[^*{[?\\}\]()]*'); | |
156 | |
157 _scanner.scan(regExp); | |
158 var buffer = new StringBuffer()..write(_scanner.lastMatch[0]); | |
159 | |
160 while (_scanner.scan('\\')) { | |
161 buffer.writeCharCode(_scanner.readChar()); | |
162 _scanner.scan(regExp); | |
163 buffer.write(_scanner.lastMatch[0]); | |
164 } | |
165 | |
166 for (var char in const [']', '(', ')']) { | |
167 if (_scanner.matches(char)) _scanner.error('unexpected "$char"'); | |
168 } | |
169 if (!inOptions && _scanner.matches('}')) _scanner.error('unexpected "}"'); | |
170 | |
171 return new LiteralNode(buffer.toString(), _context); | |
172 } | |
173 } | |
OLD | NEW |