@opensumi/ide-utils 2.21.13 → 2.22.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/lib/arrays.d.ts +3 -3
- package/lib/arrays.d.ts.map +1 -1
- package/lib/arrays.js.map +1 -1
- package/lib/async.d.ts +3 -3
- package/lib/async.d.ts.map +1 -1
- package/lib/buffer.js +4 -4
- package/lib/buffer.js.map +1 -1
- package/lib/character-classifier.js +3 -3
- package/lib/character-classifier.js.map +1 -1
- package/lib/decorators.d.ts +1 -1
- package/lib/decorators.d.ts.map +1 -1
- package/lib/encoding.d.ts +7 -1
- package/lib/encoding.d.ts.map +1 -1
- package/lib/encoding.js +15 -2
- package/lib/encoding.js.map +1 -1
- package/lib/errors.d.ts +2 -2
- package/lib/errors.d.ts.map +1 -1
- package/lib/event.d.ts +2 -2
- package/lib/event.d.ts.map +1 -1
- package/lib/filters.d.ts +3 -3
- package/lib/filters.d.ts.map +1 -1
- package/lib/filters.js +25 -25
- package/lib/filters.js.map +1 -1
- package/lib/glob.d.ts +2 -2
- package/lib/glob.d.ts.map +1 -1
- package/lib/glob.js +1 -1
- package/lib/glob.js.map +1 -1
- package/lib/hash.js +10 -10
- package/lib/hash.js.map +1 -1
- package/lib/iterator.d.ts +1 -1
- package/lib/iterator.d.ts.map +1 -1
- package/lib/linked-text.d.ts +1 -1
- package/lib/linked-text.d.ts.map +1 -1
- package/lib/linked-text.js.map +1 -1
- package/lib/map.js +17 -17
- package/lib/map.js.map +1 -1
- package/lib/objects.d.ts +1 -0
- package/lib/objects.d.ts.map +1 -1
- package/lib/objects.js +38 -1
- package/lib/objects.js.map +1 -1
- package/lib/os.d.ts +1 -8
- package/lib/os.d.ts.map +1 -1
- package/lib/os.js +4 -8
- package/lib/os.js.map +1 -1
- package/lib/path.d.ts +1 -1
- package/lib/path.d.ts.map +1 -1
- package/lib/path.js +29 -29
- package/lib/path.js.map +1 -1
- package/lib/platform.js +8 -8
- package/lib/platform.js.map +1 -1
- package/lib/process.d.ts.map +1 -1
- package/lib/process.js +28 -13
- package/lib/process.js.map +1 -1
- package/lib/progress.js +3 -3
- package/lib/progress.js.map +1 -1
- package/lib/strings.js +9 -9
- package/lib/strings.js.map +1 -1
- package/lib/types.d.ts +5 -1
- package/lib/types.d.ts.map +1 -1
- package/lib/types.js +8 -1
- package/lib/types.js.map +1 -1
- package/lib/uint.js +4 -4
- package/lib/uint.js.map +1 -1
- package/lib/uri.js +8 -8
- package/lib/uri.js.map +1 -1
- package/lib/uuid.d.ts +1 -1
- package/lib/uuid.d.ts.map +1 -1
- package/lib/uuid.js +3 -2
- package/lib/uuid.js.map +1 -1
- package/package.json +8 -6
- package/src/ansi.ts +10 -0
- package/src/argv.ts +57 -0
- package/src/arrays.ts +328 -0
- package/src/async.ts +580 -0
- package/src/buffer.ts +290 -0
- package/src/cache.ts +37 -0
- package/src/cancellation.ts +136 -0
- package/src/charCode.ts +425 -0
- package/src/character-classifier.ts +82 -0
- package/src/const/encoding.ts +242 -0
- package/src/const/index.ts +1 -0
- package/src/date.ts +36 -0
- package/src/decorators.ts +166 -0
- package/src/disposable.ts +377 -0
- package/src/encoding.ts +278 -0
- package/src/errors.ts +192 -0
- package/src/event.ts +1024 -0
- package/src/file-uri.ts +41 -0
- package/src/filters.ts +887 -0
- package/src/functional.ts +43 -0
- package/src/glob.ts +752 -0
- package/src/hash.ts +336 -0
- package/src/iconLabels.ts +149 -0
- package/src/index.ts +40 -0
- package/src/iterator.ts +36 -0
- package/src/lifecycle.ts +48 -0
- package/src/linked-list.ts +144 -0
- package/src/linked-text.ts +55 -0
- package/src/lru-map.ts +133 -0
- package/src/map.ts +934 -0
- package/src/marshalling.ts +62 -0
- package/src/objects.ts +145 -0
- package/src/os.ts +76 -0
- package/src/path.ts +1885 -0
- package/src/platform.ts +194 -0
- package/src/process.ts +43 -0
- package/src/progress.ts +83 -0
- package/src/promises.ts +23 -0
- package/src/sequence.ts +28 -0
- package/src/strings.ts +1002 -0
- package/src/types.ts +214 -0
- package/src/uint.ts +59 -0
- package/src/uri.ts +298 -0
- package/src/uuid.ts +6 -0
package/src/glob.ts
ADDED
|
@@ -0,0 +1,752 @@
|
|
|
1
|
+
/* eslint-disable @typescript-eslint/consistent-type-assertions */
|
|
2
|
+
/* eslint-disable brace-style */
|
|
3
|
+
/* eslint-disable no-case-declarations */
|
|
4
|
+
/* ---------------------------------------------------------------------------------------------
|
|
5
|
+
* Copyright (c) Microsoft Corporation. All rights reserved.
|
|
6
|
+
* Licensed under the MIT License. See License.txt in the project root for license information.
|
|
7
|
+
*--------------------------------------------------------------------------------------------*/
|
|
8
|
+
// Some code copied and modified from https://github.com/microsoft/vscode/blob/1.44.0/src/vs/base/common/glob.ts
|
|
9
|
+
|
|
10
|
+
import { CharCode } from './charCode';
|
|
11
|
+
import { LRUCache } from './map';
|
|
12
|
+
import { Path, basename as getBaseName, extname } from './path';
|
|
13
|
+
import * as strings from './strings';
|
|
14
|
+
|
|
15
|
+
export interface IExpression {
|
|
16
|
+
[pattern: string]: boolean | SiblingClause;
|
|
17
|
+
}
|
|
18
|
+
|
|
19
|
+
export interface IRelativePattern {
|
|
20
|
+
base: string;
|
|
21
|
+
pattern: string;
|
|
22
|
+
}
|
|
23
|
+
|
|
24
|
+
export function getEmptyExpression(): IExpression {
|
|
25
|
+
return Object.create(null);
|
|
26
|
+
}
|
|
27
|
+
|
|
28
|
+
export interface SiblingClause {
|
|
29
|
+
when: string;
|
|
30
|
+
}
|
|
31
|
+
|
|
32
|
+
const GLOBSTAR = '**';
|
|
33
|
+
const GLOB_SPLIT = '/';
|
|
34
|
+
const PATH_REGEX = '[/\\\\]'; // any slash or backslash
|
|
35
|
+
const NO_PATH_REGEX = '[^/\\\\]'; // any non-slash and non-backslash
|
|
36
|
+
const ALL_FORWARD_SLASHES = /\//g;
|
|
37
|
+
|
|
38
|
+
function starsToRegExp(starCount: number): string {
|
|
39
|
+
switch (starCount) {
|
|
40
|
+
case 0:
|
|
41
|
+
return '';
|
|
42
|
+
case 1:
|
|
43
|
+
return `${NO_PATH_REGEX}*?`; // 1 star matches any number of characters except path separator (/ and \) - non greedy (?)
|
|
44
|
+
default:
|
|
45
|
+
// Matches: (Path Sep OR Path Val followed by Path Sep OR Path Sep followed by Path Val) 0-many times
|
|
46
|
+
// Group is non capturing because we don't need to capture at all (?:...)
|
|
47
|
+
// Overall we use non-greedy matching because it could be that we match too much
|
|
48
|
+
return `(?:${PATH_REGEX}|${NO_PATH_REGEX}+${PATH_REGEX}|${PATH_REGEX}${NO_PATH_REGEX}+)*?`;
|
|
49
|
+
}
|
|
50
|
+
}
|
|
51
|
+
|
|
52
|
+
export function splitGlobAware(pattern: string, splitChar: string): string[] {
|
|
53
|
+
if (!pattern) {
|
|
54
|
+
return [];
|
|
55
|
+
}
|
|
56
|
+
|
|
57
|
+
const segments: string[] = [];
|
|
58
|
+
|
|
59
|
+
let inBraces = false;
|
|
60
|
+
let inBrackets = false;
|
|
61
|
+
|
|
62
|
+
let curVal = '';
|
|
63
|
+
for (const char of pattern) {
|
|
64
|
+
switch (char) {
|
|
65
|
+
case splitChar:
|
|
66
|
+
if (!inBraces && !inBrackets) {
|
|
67
|
+
segments.push(curVal);
|
|
68
|
+
curVal = '';
|
|
69
|
+
|
|
70
|
+
continue;
|
|
71
|
+
}
|
|
72
|
+
break;
|
|
73
|
+
case '{':
|
|
74
|
+
inBraces = true;
|
|
75
|
+
break;
|
|
76
|
+
case '}':
|
|
77
|
+
inBraces = false;
|
|
78
|
+
break;
|
|
79
|
+
case '[':
|
|
80
|
+
inBrackets = true;
|
|
81
|
+
break;
|
|
82
|
+
case ']':
|
|
83
|
+
inBrackets = false;
|
|
84
|
+
break;
|
|
85
|
+
}
|
|
86
|
+
|
|
87
|
+
curVal += char;
|
|
88
|
+
}
|
|
89
|
+
|
|
90
|
+
// Tail
|
|
91
|
+
if (curVal) {
|
|
92
|
+
segments.push(curVal);
|
|
93
|
+
}
|
|
94
|
+
|
|
95
|
+
return segments;
|
|
96
|
+
}
|
|
97
|
+
|
|
98
|
+
function parseRegExp(pattern: string): string {
|
|
99
|
+
if (!pattern) {
|
|
100
|
+
return '';
|
|
101
|
+
}
|
|
102
|
+
|
|
103
|
+
let regEx = '';
|
|
104
|
+
|
|
105
|
+
// Split up into segments for each slash found
|
|
106
|
+
const segments = splitGlobAware(pattern, GLOB_SPLIT);
|
|
107
|
+
|
|
108
|
+
// Special case where we only have globstars
|
|
109
|
+
if (segments.every((s) => s === GLOBSTAR)) {
|
|
110
|
+
regEx = '.*';
|
|
111
|
+
}
|
|
112
|
+
|
|
113
|
+
// Build regex over segments
|
|
114
|
+
else {
|
|
115
|
+
let previousSegmentWasGlobStar = false;
|
|
116
|
+
segments.forEach((segment, index) => {
|
|
117
|
+
// Globstar is special
|
|
118
|
+
if (segment === GLOBSTAR) {
|
|
119
|
+
// if we have more than one globstar after another, just ignore it
|
|
120
|
+
if (!previousSegmentWasGlobStar) {
|
|
121
|
+
regEx += starsToRegExp(2);
|
|
122
|
+
previousSegmentWasGlobStar = true;
|
|
123
|
+
}
|
|
124
|
+
|
|
125
|
+
return;
|
|
126
|
+
}
|
|
127
|
+
|
|
128
|
+
// States
|
|
129
|
+
let inBraces = false;
|
|
130
|
+
let braceVal = '';
|
|
131
|
+
|
|
132
|
+
let inBrackets = false;
|
|
133
|
+
let bracketVal = '';
|
|
134
|
+
|
|
135
|
+
for (const char of segment) {
|
|
136
|
+
// Support brace expansion
|
|
137
|
+
if (char !== '}' && inBraces) {
|
|
138
|
+
braceVal += char;
|
|
139
|
+
continue;
|
|
140
|
+
}
|
|
141
|
+
|
|
142
|
+
// Support brackets
|
|
143
|
+
if (
|
|
144
|
+
inBrackets &&
|
|
145
|
+
(char !== ']' || !bracketVal) /* ] is literally only allowed as first character in brackets to match it */
|
|
146
|
+
) {
|
|
147
|
+
let res: string;
|
|
148
|
+
|
|
149
|
+
// range operator
|
|
150
|
+
if (char === '-') {
|
|
151
|
+
res = char;
|
|
152
|
+
}
|
|
153
|
+
|
|
154
|
+
// negation operator (only valid on first index in bracket)
|
|
155
|
+
else if ((char === '^' || char === '!') && !bracketVal) {
|
|
156
|
+
res = '^';
|
|
157
|
+
}
|
|
158
|
+
|
|
159
|
+
// glob split matching is not allowed within character ranges
|
|
160
|
+
// see http://man7.org/linux/man-pages/man7/glob.7.html
|
|
161
|
+
else if (char === GLOB_SPLIT) {
|
|
162
|
+
res = '';
|
|
163
|
+
}
|
|
164
|
+
|
|
165
|
+
// anything else gets escaped
|
|
166
|
+
else {
|
|
167
|
+
res = strings.escapeRegExpCharacters(char);
|
|
168
|
+
}
|
|
169
|
+
|
|
170
|
+
bracketVal += res;
|
|
171
|
+
continue;
|
|
172
|
+
}
|
|
173
|
+
|
|
174
|
+
switch (char) {
|
|
175
|
+
case '{':
|
|
176
|
+
inBraces = true;
|
|
177
|
+
continue;
|
|
178
|
+
|
|
179
|
+
case '[':
|
|
180
|
+
inBrackets = true;
|
|
181
|
+
continue;
|
|
182
|
+
|
|
183
|
+
case '}':
|
|
184
|
+
const choices = splitGlobAware(braceVal, ',');
|
|
185
|
+
|
|
186
|
+
// Converts {foo,bar} => [foo|bar]
|
|
187
|
+
const braceRegExp = `(?:${choices.map((c) => parseRegExp(c)).join('|')})`;
|
|
188
|
+
|
|
189
|
+
regEx += braceRegExp;
|
|
190
|
+
|
|
191
|
+
inBraces = false;
|
|
192
|
+
braceVal = '';
|
|
193
|
+
|
|
194
|
+
break;
|
|
195
|
+
|
|
196
|
+
case ']':
|
|
197
|
+
regEx += '[' + bracketVal + ']';
|
|
198
|
+
|
|
199
|
+
inBrackets = false;
|
|
200
|
+
bracketVal = '';
|
|
201
|
+
|
|
202
|
+
break;
|
|
203
|
+
|
|
204
|
+
case '?':
|
|
205
|
+
regEx += NO_PATH_REGEX; // 1 ? matches any single character except path separator (/ and \)
|
|
206
|
+
continue;
|
|
207
|
+
|
|
208
|
+
case '*':
|
|
209
|
+
regEx += starsToRegExp(1);
|
|
210
|
+
continue;
|
|
211
|
+
|
|
212
|
+
default:
|
|
213
|
+
regEx += strings.escapeRegExpCharacters(char);
|
|
214
|
+
}
|
|
215
|
+
}
|
|
216
|
+
|
|
217
|
+
// Tail: Add the slash we had split on if there is more to come and the remaining pattern is not a globstar
|
|
218
|
+
// For example if pattern: some/**/*.js we want the "/" after some to be included in the RegEx to prevent
|
|
219
|
+
// a folder called "something" to match as well.
|
|
220
|
+
// However, if pattern: some/**, we tolerate that we also match on "something" because our globstar behaviour
|
|
221
|
+
// is to match 0-N segments.
|
|
222
|
+
if (index < segments.length - 1 && (segments[index + 1] !== GLOBSTAR || index + 2 < segments.length)) {
|
|
223
|
+
regEx += PATH_REGEX;
|
|
224
|
+
}
|
|
225
|
+
|
|
226
|
+
// reset state
|
|
227
|
+
previousSegmentWasGlobStar = false;
|
|
228
|
+
});
|
|
229
|
+
}
|
|
230
|
+
|
|
231
|
+
return regEx;
|
|
232
|
+
}
|
|
233
|
+
|
|
234
|
+
// regexes to check for trival glob patterns that just check for String#endsWith
|
|
235
|
+
const T1 = /^\*\*\/\*\.[\w\.-]+$/; // **/*.something
|
|
236
|
+
const T2 = /^\*\*\/([\w\.-]+)\/?$/; // **/something
|
|
237
|
+
const T3 = /^{\*\*\/[\*\.]?[\w\.-]+\/?(,\*\*\/[\*\.]?[\w\.-]+\/?)*}$/; // {**/*.something,**/*.else} or {**/package.json,**/project.json}
|
|
238
|
+
const T3_2 = /^{\*\*\/[\*\.]?[\w\.-]+(\/(\*\*)?)?(,\*\*\/[\*\.]?[\w\.-]+(\/(\*\*)?)?)*}$/; // Like T3, with optional trailing /**
|
|
239
|
+
const T4 = /^\*\*((\/[\w\.-]+)+)\/?$/; // **/something/else
|
|
240
|
+
const T5 = /^([\w\.-]+(\/[\w\.-]+)*)\/?$/; // something/else
|
|
241
|
+
|
|
242
|
+
export type ParsedPattern = (path: string, basename?: string) => boolean;
|
|
243
|
+
|
|
244
|
+
// The ParsedExpression returns a Promise iff hasSibling returns a Promise.
|
|
245
|
+
export type ParsedExpression = (
|
|
246
|
+
path: string,
|
|
247
|
+
basename?: string,
|
|
248
|
+
hasSibling?: (name: string) => boolean | Promise<boolean>,
|
|
249
|
+
) => string | null | Promise<string | null> /* the matching pattern */;
|
|
250
|
+
|
|
251
|
+
export interface IGlobOptions {
|
|
252
|
+
/**
|
|
253
|
+
* Simplify patterns for use as exclusion filters during tree traversal to skip entire subtrees. Cannot be used outside of a tree traversal.
|
|
254
|
+
*/
|
|
255
|
+
trimForExclusions?: boolean;
|
|
256
|
+
}
|
|
257
|
+
|
|
258
|
+
interface ParsedStringPattern {
|
|
259
|
+
(path: string, basename?: string): string | null | Promise<string | null> /* the matching pattern */;
|
|
260
|
+
basenames?: string[];
|
|
261
|
+
patterns?: string[];
|
|
262
|
+
allBasenames?: string[];
|
|
263
|
+
allPaths?: string[];
|
|
264
|
+
}
|
|
265
|
+
interface ParsedExpressionPattern {
|
|
266
|
+
(path: string, basename?: string, name?: string, hasSibling?: (name: string) => boolean | Promise<boolean>):
|
|
267
|
+
| string
|
|
268
|
+
| null
|
|
269
|
+
| Promise<string | null> /* the matching pattern */;
|
|
270
|
+
requiresSiblings?: boolean;
|
|
271
|
+
allBasenames?: string[];
|
|
272
|
+
allPaths?: string[];
|
|
273
|
+
}
|
|
274
|
+
|
|
275
|
+
const CACHE = new LRUCache<string, ParsedStringPattern>(10000); // bounded to 10000 elements
|
|
276
|
+
|
|
277
|
+
const FALSE = function () {
|
|
278
|
+
return false;
|
|
279
|
+
};
|
|
280
|
+
|
|
281
|
+
const NULL = function (): string | null {
|
|
282
|
+
return null;
|
|
283
|
+
};
|
|
284
|
+
|
|
285
|
+
function parsePattern(arg1: string | IRelativePattern, options: IGlobOptions): ParsedStringPattern {
|
|
286
|
+
if (!arg1) {
|
|
287
|
+
return NULL;
|
|
288
|
+
}
|
|
289
|
+
|
|
290
|
+
// Handle relative patterns
|
|
291
|
+
let pattern: string;
|
|
292
|
+
if (typeof arg1 !== 'string') {
|
|
293
|
+
pattern = arg1.pattern;
|
|
294
|
+
} else {
|
|
295
|
+
pattern = arg1;
|
|
296
|
+
}
|
|
297
|
+
|
|
298
|
+
// Whitespace trimming
|
|
299
|
+
pattern = pattern.trim();
|
|
300
|
+
|
|
301
|
+
// Check cache
|
|
302
|
+
const patternKey = `${pattern}_${!!options.trimForExclusions}`;
|
|
303
|
+
let parsedPattern = CACHE.get(patternKey);
|
|
304
|
+
if (parsedPattern) {
|
|
305
|
+
return wrapRelativePattern(parsedPattern, arg1);
|
|
306
|
+
}
|
|
307
|
+
|
|
308
|
+
// Check for Trivials
|
|
309
|
+
let match: RegExpExecArray | null;
|
|
310
|
+
if (T1.test(pattern)) {
|
|
311
|
+
parsedPattern = trivia1(pattern.substr(4), pattern); // common pattern: **/*.txt just need endsWith check
|
|
312
|
+
} else if ((match = T2.exec(trimForExclusions(pattern, options)))) {
|
|
313
|
+
// common pattern: **/some.txt just need basename check
|
|
314
|
+
parsedPattern = trivia2(match[1], pattern);
|
|
315
|
+
} else if ((options.trimForExclusions ? T3_2 : T3).test(pattern)) {
|
|
316
|
+
// repetition of common patterns (see above) {**/*.txt,**/*.png}
|
|
317
|
+
parsedPattern = trivia3(pattern, options);
|
|
318
|
+
} else if ((match = T4.exec(trimForExclusions(pattern, options)))) {
|
|
319
|
+
// common pattern: **/something/else just need endsWith check
|
|
320
|
+
parsedPattern = trivia4and5(match[1].substr(1), pattern, true);
|
|
321
|
+
} else if ((match = T5.exec(trimForExclusions(pattern, options)))) {
|
|
322
|
+
// common pattern: something/else just need equals check
|
|
323
|
+
parsedPattern = trivia4and5(match[1], pattern, false);
|
|
324
|
+
}
|
|
325
|
+
|
|
326
|
+
// Otherwise convert to pattern
|
|
327
|
+
else {
|
|
328
|
+
parsedPattern = toRegExp(pattern);
|
|
329
|
+
}
|
|
330
|
+
|
|
331
|
+
// Cache
|
|
332
|
+
CACHE.set(patternKey, parsedPattern);
|
|
333
|
+
|
|
334
|
+
return wrapRelativePattern(parsedPattern, arg1);
|
|
335
|
+
}
|
|
336
|
+
|
|
337
|
+
function wrapRelativePattern(parsedPattern: ParsedStringPattern, arg2: string | IRelativePattern): ParsedStringPattern {
|
|
338
|
+
if (typeof arg2 === 'string') {
|
|
339
|
+
return parsedPattern;
|
|
340
|
+
}
|
|
341
|
+
|
|
342
|
+
return function (path, basename) {
|
|
343
|
+
const base = new Path(arg2.base);
|
|
344
|
+
const target = new Path(path);
|
|
345
|
+
if (!base.isEqualOrParent(target)) {
|
|
346
|
+
return null;
|
|
347
|
+
}
|
|
348
|
+
return parsedPattern(base.relative(target)?.toString() || '', basename);
|
|
349
|
+
};
|
|
350
|
+
}
|
|
351
|
+
|
|
352
|
+
function trimForExclusions(pattern: string, options: IGlobOptions): string {
|
|
353
|
+
return options.trimForExclusions && pattern.endsWith('/**') ? pattern.substr(0, pattern.length - 2) : pattern; // dropping **, tailing / is dropped later
|
|
354
|
+
}
|
|
355
|
+
|
|
356
|
+
// common pattern: **/*.txt just need endsWith check
|
|
357
|
+
function trivia1(base: string, pattern: string): ParsedStringPattern {
|
|
358
|
+
return function (path: string, basename?: string) {
|
|
359
|
+
return typeof path === 'string' && path.endsWith(base) ? pattern : null;
|
|
360
|
+
};
|
|
361
|
+
}
|
|
362
|
+
|
|
363
|
+
// common pattern: **/some.txt just need basename check
|
|
364
|
+
function trivia2(base: string, originalPattern: string): ParsedStringPattern {
|
|
365
|
+
const slashBase = `/${base}`;
|
|
366
|
+
const backslashBase = `\\${base}`;
|
|
367
|
+
const parsedPattern: ParsedStringPattern = function (path, basename) {
|
|
368
|
+
if (typeof path !== 'string') {
|
|
369
|
+
return null;
|
|
370
|
+
}
|
|
371
|
+
if (basename) {
|
|
372
|
+
return basename === base ? originalPattern : null;
|
|
373
|
+
}
|
|
374
|
+
return path === base || path.endsWith(slashBase) || path.endsWith(backslashBase) ? originalPattern : null;
|
|
375
|
+
};
|
|
376
|
+
const basenames = [base];
|
|
377
|
+
parsedPattern.basenames = basenames;
|
|
378
|
+
parsedPattern.patterns = [originalPattern];
|
|
379
|
+
parsedPattern.allBasenames = basenames;
|
|
380
|
+
return parsedPattern;
|
|
381
|
+
}
|
|
382
|
+
|
|
383
|
+
// repetition of common patterns (see above) {**/*.txt,**/*.png}
|
|
384
|
+
function trivia3(pattern: string, options: IGlobOptions): ParsedStringPattern {
|
|
385
|
+
const parsedPatterns = aggregateBasenameMatches(
|
|
386
|
+
pattern
|
|
387
|
+
.slice(1, -1)
|
|
388
|
+
.split(',')
|
|
389
|
+
.map((pattern) => parsePattern(pattern, options))
|
|
390
|
+
.filter((pattern) => pattern !== NULL),
|
|
391
|
+
pattern,
|
|
392
|
+
);
|
|
393
|
+
const n = parsedPatterns.length;
|
|
394
|
+
if (!n) {
|
|
395
|
+
return NULL;
|
|
396
|
+
}
|
|
397
|
+
if (n === 1) {
|
|
398
|
+
return <ParsedStringPattern>parsedPatterns[0];
|
|
399
|
+
}
|
|
400
|
+
const parsedPattern: ParsedStringPattern = function (path: string, basename?: string) {
|
|
401
|
+
for (let i = 0, n = parsedPatterns.length; i < n; i++) {
|
|
402
|
+
if ((<ParsedStringPattern>parsedPatterns[i])(path, basename)) {
|
|
403
|
+
return pattern;
|
|
404
|
+
}
|
|
405
|
+
}
|
|
406
|
+
return null;
|
|
407
|
+
};
|
|
408
|
+
const withBasenames = parsedPatterns.find((pattern) => !!(<ParsedStringPattern>pattern).allBasenames);
|
|
409
|
+
if (withBasenames) {
|
|
410
|
+
parsedPattern.allBasenames = (<ParsedStringPattern>withBasenames).allBasenames;
|
|
411
|
+
}
|
|
412
|
+
const allPaths = parsedPatterns.reduce(
|
|
413
|
+
(all, current) => (current.allPaths ? all.concat(current.allPaths) : all),
|
|
414
|
+
<string[]>[],
|
|
415
|
+
);
|
|
416
|
+
if (allPaths.length) {
|
|
417
|
+
parsedPattern.allPaths = allPaths;
|
|
418
|
+
}
|
|
419
|
+
return parsedPattern;
|
|
420
|
+
}
|
|
421
|
+
|
|
422
|
+
// common patterns: **/something/else just need endsWith check, something/else just needs and equals check
|
|
423
|
+
function trivia4and5(path: string, pattern: string, matchPathEnds: boolean): ParsedStringPattern {
|
|
424
|
+
const nativePath = Path.separator !== Path.nativeSeparator ? path.replace(ALL_FORWARD_SLASHES, Path.separator) : path;
|
|
425
|
+
const nativePathEnd = Path.separator + nativePath;
|
|
426
|
+
const parsedPattern: ParsedStringPattern = matchPathEnds
|
|
427
|
+
? function (path, basename) {
|
|
428
|
+
return typeof path === 'string' && (path === nativePath || path.endsWith(nativePathEnd)) ? pattern : null;
|
|
429
|
+
}
|
|
430
|
+
: function (path, basename) {
|
|
431
|
+
return typeof path === 'string' && path === nativePath ? pattern : null;
|
|
432
|
+
};
|
|
433
|
+
parsedPattern.allPaths = [(matchPathEnds ? '*/' : './') + path];
|
|
434
|
+
return parsedPattern;
|
|
435
|
+
}
|
|
436
|
+
|
|
437
|
+
function toRegExp(pattern: string): ParsedStringPattern {
|
|
438
|
+
try {
|
|
439
|
+
const regExp = new RegExp(`^${parseRegExp(pattern)}$`);
|
|
440
|
+
return function (path: string) {
|
|
441
|
+
regExp.lastIndex = 0; // reset RegExp to its initial state to reuse it!
|
|
442
|
+
return typeof path === 'string' && regExp.test(path) ? pattern : null;
|
|
443
|
+
};
|
|
444
|
+
} catch (error) {
|
|
445
|
+
return NULL;
|
|
446
|
+
}
|
|
447
|
+
}
|
|
448
|
+
|
|
449
|
+
/**
|
|
450
|
+
* Simplified glob matching. Supports a subset of glob patterns:
|
|
451
|
+
* - * matches anything inside a path segment
|
|
452
|
+
* - ? matches 1 character inside a path segment
|
|
453
|
+
* - ** matches anything including an empty path segment
|
|
454
|
+
* - simple brace expansion ({js,ts} => js or ts)
|
|
455
|
+
* - character ranges (using [...])
|
|
456
|
+
*/
|
|
457
|
+
export function match(pattern: string | IRelativePattern, path: string): boolean;
|
|
458
|
+
export function match(
|
|
459
|
+
expression: IExpression,
|
|
460
|
+
path: string,
|
|
461
|
+
hasSibling?: (name: string) => boolean,
|
|
462
|
+
): string; /* the matching pattern */
|
|
463
|
+
export function match(
|
|
464
|
+
arg1: string | IExpression | IRelativePattern,
|
|
465
|
+
path: string,
|
|
466
|
+
hasSibling?: (name: string) => boolean,
|
|
467
|
+
): boolean | string | null | Promise<string | null> {
|
|
468
|
+
if (!arg1 || typeof path !== 'string') {
|
|
469
|
+
return false;
|
|
470
|
+
}
|
|
471
|
+
|
|
472
|
+
return parseGlob(<IExpression>arg1)(path, undefined, hasSibling);
|
|
473
|
+
}
|
|
474
|
+
|
|
475
|
+
/**
|
|
476
|
+
* Simplified glob matching. Supports a subset of glob patterns:
|
|
477
|
+
* - * matches anything inside a path segment
|
|
478
|
+
* - ? matches 1 character inside a path segment
|
|
479
|
+
* - ** matches anything including an empty path segment
|
|
480
|
+
* - simple brace expansion ({js,ts} => js or ts)
|
|
481
|
+
* - character ranges (using [...])
|
|
482
|
+
*/
|
|
483
|
+
export function parseGlob(pattern: string | IRelativePattern, options?: IGlobOptions): ParsedPattern;
|
|
484
|
+
export function parseGlob(expression: IExpression, options?: IGlobOptions): ParsedExpression;
|
|
485
|
+
export function parseGlob(
|
|
486
|
+
arg1: string | IExpression | IRelativePattern,
|
|
487
|
+
options: IGlobOptions = {},
|
|
488
|
+
): ParsedPattern | ParsedExpression {
|
|
489
|
+
if (!arg1) {
|
|
490
|
+
return FALSE;
|
|
491
|
+
}
|
|
492
|
+
|
|
493
|
+
// Glob with String
|
|
494
|
+
if (typeof arg1 === 'string' || isRelativePattern(arg1)) {
|
|
495
|
+
const parsedPattern = parsePattern(arg1, options);
|
|
496
|
+
if (parsedPattern === NULL) {
|
|
497
|
+
return FALSE;
|
|
498
|
+
}
|
|
499
|
+
const resultPattern: ParsedPattern & { allBasenames?: string[]; allPaths?: string[] } = function (
|
|
500
|
+
path: string,
|
|
501
|
+
basename?: string,
|
|
502
|
+
) {
|
|
503
|
+
return !!parsedPattern(path, basename);
|
|
504
|
+
};
|
|
505
|
+
if (parsedPattern.allBasenames) {
|
|
506
|
+
resultPattern.allBasenames = parsedPattern.allBasenames;
|
|
507
|
+
}
|
|
508
|
+
if (parsedPattern.allPaths) {
|
|
509
|
+
resultPattern.allPaths = parsedPattern.allPaths;
|
|
510
|
+
}
|
|
511
|
+
return resultPattern;
|
|
512
|
+
}
|
|
513
|
+
|
|
514
|
+
// Glob with Expression
|
|
515
|
+
return parsedExpression(<IExpression>arg1, options);
|
|
516
|
+
}
|
|
517
|
+
|
|
518
|
+
export function hasSiblingPromiseFn(siblingsFn?: () => Promise<string[]>) {
|
|
519
|
+
if (!siblingsFn) {
|
|
520
|
+
return undefined;
|
|
521
|
+
}
|
|
522
|
+
|
|
523
|
+
let siblings: Promise<Record<string, true>>;
|
|
524
|
+
return (name: string) => {
|
|
525
|
+
if (!siblings) {
|
|
526
|
+
siblings = (siblingsFn() || Promise.resolve([])).then((list) => (list ? listToMap(list) : {}));
|
|
527
|
+
}
|
|
528
|
+
return siblings.then((map) => !!map[name]);
|
|
529
|
+
};
|
|
530
|
+
}
|
|
531
|
+
|
|
532
|
+
export function hasSiblingFn(siblingsFn?: () => string[]) {
|
|
533
|
+
if (!siblingsFn) {
|
|
534
|
+
return undefined;
|
|
535
|
+
}
|
|
536
|
+
|
|
537
|
+
let siblings: Record<string, true>;
|
|
538
|
+
return (name: string) => {
|
|
539
|
+
if (!siblings) {
|
|
540
|
+
const list = siblingsFn();
|
|
541
|
+
siblings = list ? listToMap(list) : {};
|
|
542
|
+
}
|
|
543
|
+
return !!siblings[name];
|
|
544
|
+
};
|
|
545
|
+
}
|
|
546
|
+
|
|
547
|
+
function listToMap(list: string[]) {
|
|
548
|
+
const map: Record<string, true> = {};
|
|
549
|
+
for (const key of list) {
|
|
550
|
+
map[key] = true;
|
|
551
|
+
}
|
|
552
|
+
return map;
|
|
553
|
+
}
|
|
554
|
+
|
|
555
|
+
export function isRelativePattern(obj: unknown): obj is IRelativePattern {
|
|
556
|
+
const rp = obj as IRelativePattern;
|
|
557
|
+
|
|
558
|
+
return rp && typeof rp.base === 'string' && typeof rp.pattern === 'string';
|
|
559
|
+
}
|
|
560
|
+
|
|
561
|
+
export function getBasenameTerms(patternOrExpression: ParsedPattern | ParsedExpression): string[] {
|
|
562
|
+
return (<ParsedStringPattern>patternOrExpression).allBasenames || [];
|
|
563
|
+
}
|
|
564
|
+
|
|
565
|
+
export function getPathTerms(patternOrExpression: ParsedPattern | ParsedExpression): string[] {
|
|
566
|
+
return (<ParsedStringPattern>patternOrExpression).allPaths || [];
|
|
567
|
+
}
|
|
568
|
+
|
|
569
|
+
function parsedExpression(expression: IExpression, options: IGlobOptions): ParsedExpression {
|
|
570
|
+
const parsedPatterns = aggregateBasenameMatches(
|
|
571
|
+
Object.getOwnPropertyNames(expression)
|
|
572
|
+
.map((pattern) => parseExpressionPattern(pattern, expression[pattern], options))
|
|
573
|
+
.filter((pattern) => pattern !== NULL),
|
|
574
|
+
);
|
|
575
|
+
|
|
576
|
+
const n = parsedPatterns.length;
|
|
577
|
+
if (!n) {
|
|
578
|
+
return NULL;
|
|
579
|
+
}
|
|
580
|
+
|
|
581
|
+
if (!parsedPatterns.some((parsedPattern) => !!(<ParsedExpressionPattern>parsedPattern).requiresSiblings)) {
|
|
582
|
+
if (n === 1) {
|
|
583
|
+
return <ParsedStringPattern>parsedPatterns[0];
|
|
584
|
+
}
|
|
585
|
+
|
|
586
|
+
const resultExpression: ParsedStringPattern = function (path: string, basename?: string) {
|
|
587
|
+
for (let i = 0, n = parsedPatterns.length; i < n; i++) {
|
|
588
|
+
// Pattern matches path
|
|
589
|
+
const result = (<ParsedStringPattern>parsedPatterns[i])(path, basename);
|
|
590
|
+
if (result) {
|
|
591
|
+
return result;
|
|
592
|
+
}
|
|
593
|
+
}
|
|
594
|
+
|
|
595
|
+
return null;
|
|
596
|
+
};
|
|
597
|
+
|
|
598
|
+
const withBasenames = parsedPatterns.find((pattern) => !!(<ParsedStringPattern>pattern).allBasenames);
|
|
599
|
+
if (withBasenames) {
|
|
600
|
+
resultExpression.allBasenames = (<ParsedStringPattern>withBasenames).allBasenames;
|
|
601
|
+
}
|
|
602
|
+
|
|
603
|
+
const allPaths = parsedPatterns.reduce(
|
|
604
|
+
(all, current) => (current.allPaths ? all.concat(current.allPaths) : all),
|
|
605
|
+
<string[]>[],
|
|
606
|
+
);
|
|
607
|
+
if (allPaths.length) {
|
|
608
|
+
resultExpression.allPaths = allPaths;
|
|
609
|
+
}
|
|
610
|
+
|
|
611
|
+
return resultExpression;
|
|
612
|
+
}
|
|
613
|
+
|
|
614
|
+
const resultExpression: ParsedStringPattern = function (
|
|
615
|
+
path: string,
|
|
616
|
+
basename?: string,
|
|
617
|
+
hasSibling?: (name: string) => boolean | Promise<boolean>,
|
|
618
|
+
) {
|
|
619
|
+
let name: string | undefined;
|
|
620
|
+
|
|
621
|
+
for (let i = 0, n = parsedPatterns.length; i < n; i++) {
|
|
622
|
+
// Pattern matches path
|
|
623
|
+
const parsedPattern = <ParsedExpressionPattern>parsedPatterns[i];
|
|
624
|
+
if (parsedPattern.requiresSiblings && hasSibling) {
|
|
625
|
+
if (!basename) {
|
|
626
|
+
basename = getBaseName(path);
|
|
627
|
+
}
|
|
628
|
+
if (!name) {
|
|
629
|
+
name = basename.substr(0, basename.length - extname(path).length);
|
|
630
|
+
}
|
|
631
|
+
}
|
|
632
|
+
const result = parsedPattern(path, basename, name, hasSibling);
|
|
633
|
+
if (result) {
|
|
634
|
+
return result;
|
|
635
|
+
}
|
|
636
|
+
}
|
|
637
|
+
|
|
638
|
+
return null;
|
|
639
|
+
};
|
|
640
|
+
|
|
641
|
+
const withBasenames = parsedPatterns.find((pattern) => !!(<ParsedStringPattern>pattern).allBasenames);
|
|
642
|
+
if (withBasenames) {
|
|
643
|
+
resultExpression.allBasenames = (<ParsedStringPattern>withBasenames).allBasenames;
|
|
644
|
+
}
|
|
645
|
+
|
|
646
|
+
const allPaths = parsedPatterns.reduce(
|
|
647
|
+
(all, current) => (current.allPaths ? all.concat(current.allPaths) : all),
|
|
648
|
+
<string[]>[],
|
|
649
|
+
);
|
|
650
|
+
if (allPaths.length) {
|
|
651
|
+
resultExpression.allPaths = allPaths;
|
|
652
|
+
}
|
|
653
|
+
|
|
654
|
+
return resultExpression;
|
|
655
|
+
}
|
|
656
|
+
|
|
657
|
+
function parseExpressionPattern(
|
|
658
|
+
pattern: string,
|
|
659
|
+
value: boolean | SiblingClause,
|
|
660
|
+
options: IGlobOptions,
|
|
661
|
+
): ParsedStringPattern | ParsedExpressionPattern {
|
|
662
|
+
if (value === false) {
|
|
663
|
+
return NULL; // pattern is disabled
|
|
664
|
+
}
|
|
665
|
+
|
|
666
|
+
const parsedPattern = parsePattern(pattern, options);
|
|
667
|
+
if (parsedPattern === NULL) {
|
|
668
|
+
return NULL;
|
|
669
|
+
}
|
|
670
|
+
|
|
671
|
+
// Expression Pattern is <boolean>
|
|
672
|
+
if (typeof value === 'boolean') {
|
|
673
|
+
return parsedPattern;
|
|
674
|
+
}
|
|
675
|
+
|
|
676
|
+
// Expression Pattern is <SiblingClause>
|
|
677
|
+
if (value) {
|
|
678
|
+
const when = (<SiblingClause>value).when;
|
|
679
|
+
if (typeof when === 'string') {
|
|
680
|
+
const result: ParsedExpressionPattern = (
|
|
681
|
+
path: string,
|
|
682
|
+
basename?: string,
|
|
683
|
+
name?: string,
|
|
684
|
+
hasSibling?: (name: string) => boolean | Promise<boolean>,
|
|
685
|
+
) => {
|
|
686
|
+
if (!hasSibling || !parsedPattern(path, basename)) {
|
|
687
|
+
return null;
|
|
688
|
+
}
|
|
689
|
+
|
|
690
|
+
const clausePattern = when.replace('$(basename)', name!);
|
|
691
|
+
const matched = hasSibling(clausePattern);
|
|
692
|
+
return matched instanceof Promise ? matched.then((m) => (m ? pattern : null)) : matched ? pattern : null;
|
|
693
|
+
};
|
|
694
|
+
result.requiresSiblings = true;
|
|
695
|
+
return result;
|
|
696
|
+
}
|
|
697
|
+
}
|
|
698
|
+
|
|
699
|
+
// Expression is Anything
|
|
700
|
+
return parsedPattern;
|
|
701
|
+
}
|
|
702
|
+
|
|
703
|
+
function aggregateBasenameMatches(
|
|
704
|
+
parsedPatterns: Array<ParsedStringPattern | ParsedExpressionPattern>,
|
|
705
|
+
result?: string,
|
|
706
|
+
): Array<ParsedStringPattern | ParsedExpressionPattern> {
|
|
707
|
+
const basenamePatterns = parsedPatterns.filter((parsedPattern) => !!(<ParsedStringPattern>parsedPattern).basenames);
|
|
708
|
+
if (basenamePatterns.length < 2) {
|
|
709
|
+
return parsedPatterns;
|
|
710
|
+
}
|
|
711
|
+
|
|
712
|
+
const basenames = basenamePatterns.reduce<string[]>((all, current) => {
|
|
713
|
+
const basenames = (<ParsedStringPattern>current).basenames;
|
|
714
|
+
return basenames ? all.concat(basenames) : all;
|
|
715
|
+
}, <string[]>[]);
|
|
716
|
+
let patterns: string[];
|
|
717
|
+
if (result) {
|
|
718
|
+
patterns = [];
|
|
719
|
+
for (let i = 0, n = basenames.length; i < n; i++) {
|
|
720
|
+
patterns.push(result);
|
|
721
|
+
}
|
|
722
|
+
} else {
|
|
723
|
+
patterns = basenamePatterns.reduce((all, current) => {
|
|
724
|
+
const patterns = (<ParsedStringPattern>current).patterns;
|
|
725
|
+
return patterns ? all.concat(patterns) : all;
|
|
726
|
+
}, <string[]>[]);
|
|
727
|
+
}
|
|
728
|
+
const aggregate: ParsedStringPattern = function (path, basename) {
|
|
729
|
+
if (typeof path !== 'string') {
|
|
730
|
+
return null;
|
|
731
|
+
}
|
|
732
|
+
if (!basename) {
|
|
733
|
+
let i: number;
|
|
734
|
+
for (i = path.length; i > 0; i--) {
|
|
735
|
+
const ch = path.charCodeAt(i - 1);
|
|
736
|
+
if (ch === CharCode.Slash || ch === CharCode.Backslash) {
|
|
737
|
+
break;
|
|
738
|
+
}
|
|
739
|
+
}
|
|
740
|
+
basename = path.substr(i);
|
|
741
|
+
}
|
|
742
|
+
const index = basenames.indexOf(basename);
|
|
743
|
+
return index !== -1 ? patterns[index] : null;
|
|
744
|
+
};
|
|
745
|
+
aggregate.basenames = basenames;
|
|
746
|
+
aggregate.patterns = patterns;
|
|
747
|
+
aggregate.allBasenames = basenames;
|
|
748
|
+
|
|
749
|
+
const aggregatedPatterns = parsedPatterns.filter((parsedPattern) => !(<ParsedStringPattern>parsedPattern).basenames);
|
|
750
|
+
aggregatedPatterns.push(aggregate);
|
|
751
|
+
return aggregatedPatterns;
|
|
752
|
+
}
|