@theia/task 1.45.1 → 1.46.0-next.72

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.
Files changed (173) hide show
  1. package/README.md +193 -193
  2. package/lib/browser/index.d.ts +6 -6
  3. package/lib/browser/index.js +33 -33
  4. package/lib/browser/process/process-task-contribution.d.ts +6 -6
  5. package/lib/browser/process/process-task-contribution.js +43 -43
  6. package/lib/browser/process/process-task-frontend-module.d.ts +2 -2
  7. package/lib/browser/process/process-task-frontend-module.js +27 -27
  8. package/lib/browser/process/process-task-resolver.d.ts +17 -17
  9. package/lib/browser/process/process-task-resolver.js +101 -101
  10. package/lib/browser/provided-task-configurations.d.ts +43 -43
  11. package/lib/browser/provided-task-configurations.js +213 -213
  12. package/lib/browser/provided-task-configurations.spec.d.ts +1 -1
  13. package/lib/browser/provided-task-configurations.spec.js +43 -43
  14. package/lib/browser/quick-open-task.d.ts +144 -144
  15. package/lib/browser/quick-open-task.d.ts.map +1 -1
  16. package/lib/browser/quick-open-task.js +752 -748
  17. package/lib/browser/quick-open-task.js.map +1 -1
  18. package/lib/browser/task-configuration-manager.d.ts +64 -64
  19. package/lib/browser/task-configuration-manager.js +261 -261
  20. package/lib/browser/task-configuration-model.d.ts +32 -32
  21. package/lib/browser/task-configuration-model.js +79 -79
  22. package/lib/browser/task-configurations.d.ts +127 -127
  23. package/lib/browser/task-configurations.js +486 -486
  24. package/lib/browser/task-contribution.d.ts +182 -182
  25. package/lib/browser/task-contribution.js +206 -206
  26. package/lib/browser/task-definition-registry.d.ts +38 -38
  27. package/lib/browser/task-definition-registry.js +134 -134
  28. package/lib/browser/task-definition-registry.spec.d.ts +1 -1
  29. package/lib/browser/task-definition-registry.spec.js +170 -170
  30. package/lib/browser/task-frontend-contribution.d.ts +56 -56
  31. package/lib/browser/task-frontend-contribution.js +358 -358
  32. package/lib/browser/task-frontend-module.d.ts +5 -5
  33. package/lib/browser/task-frontend-module.js +79 -79
  34. package/lib/browser/task-name-resolver.d.ts +13 -13
  35. package/lib/browser/task-name-resolver.js +67 -67
  36. package/lib/browser/task-node.d.ts +9 -9
  37. package/lib/browser/task-node.js +17 -17
  38. package/lib/browser/task-preferences.d.ts +4 -4
  39. package/lib/browser/task-preferences.js +40 -40
  40. package/lib/browser/task-problem-matcher-registry.d.ts +40 -40
  41. package/lib/browser/task-problem-matcher-registry.js +309 -309
  42. package/lib/browser/task-problem-pattern-registry.d.ts +23 -23
  43. package/lib/browser/task-problem-pattern-registry.js +210 -210
  44. package/lib/browser/task-schema-updater.d.ts +58 -58
  45. package/lib/browser/task-schema-updater.js +688 -688
  46. package/lib/browser/task-service.d.ts +279 -279
  47. package/lib/browser/task-service.js +1119 -1119
  48. package/lib/browser/task-source-resolver.d.ts +9 -9
  49. package/lib/browser/task-source-resolver.js +51 -51
  50. package/lib/browser/task-templates.d.ts +13 -13
  51. package/lib/browser/task-templates.js +161 -161
  52. package/lib/browser/task-terminal-widget-manager.d.ts +44 -44
  53. package/lib/browser/task-terminal-widget-manager.js +228 -228
  54. package/lib/browser/tasks-monaco-contribution.d.ts +1 -1
  55. package/lib/browser/tasks-monaco-contribution.js +27 -27
  56. package/lib/common/index.d.ts +4 -4
  57. package/lib/common/index.js +31 -31
  58. package/lib/common/problem-matcher-protocol.d.ts +124 -124
  59. package/lib/common/problem-matcher-protocol.js +132 -132
  60. package/lib/common/process/task-protocol.d.ts +68 -68
  61. package/lib/common/process/task-protocol.js +33 -33
  62. package/lib/common/task-common-module.d.ts +7 -7
  63. package/lib/common/task-common-module.js +33 -33
  64. package/lib/common/task-protocol.d.ts +192 -192
  65. package/lib/common/task-protocol.js +137 -137
  66. package/lib/common/task-util.d.ts +22 -22
  67. package/lib/common/task-util.js +46 -46
  68. package/lib/common/task-watcher.d.ts +17 -17
  69. package/lib/common/task-watcher.js +86 -86
  70. package/lib/node/custom/custom-task-runner-backend-module.d.ts +2 -2
  71. package/lib/node/custom/custom-task-runner-backend-module.js +36 -36
  72. package/lib/node/custom/custom-task-runner-contribution.d.ts +6 -6
  73. package/lib/node/custom/custom-task-runner-contribution.js +42 -42
  74. package/lib/node/custom/custom-task-runner.d.ts +15 -15
  75. package/lib/node/custom/custom-task-runner.js +69 -69
  76. package/lib/node/custom/custom-task.d.ts +20 -20
  77. package/lib/node/custom/custom-task.js +78 -78
  78. package/lib/node/index.d.ts +3 -3
  79. package/lib/node/index.js +30 -30
  80. package/lib/node/process/process-task-runner-backend-module.d.ts +2 -2
  81. package/lib/node/process/process-task-runner-backend-module.js +36 -36
  82. package/lib/node/process/process-task-runner-contribution.d.ts +6 -6
  83. package/lib/node/process/process-task-runner-contribution.js +43 -43
  84. package/lib/node/process/process-task-runner.d.ts +60 -60
  85. package/lib/node/process/process-task-runner.js +355 -355
  86. package/lib/node/process/process-task.d.ts +26 -26
  87. package/lib/node/process/process-task.js +135 -135
  88. package/lib/node/process/process-task.spec.d.ts +1 -1
  89. package/lib/node/process/process-task.spec.js +29 -29
  90. package/lib/node/task-abstract-line-matcher.d.ts +49 -49
  91. package/lib/node/task-abstract-line-matcher.js +273 -273
  92. package/lib/node/task-backend-application-contribution.d.ts +8 -8
  93. package/lib/node/task-backend-application-contribution.js +48 -48
  94. package/lib/node/task-backend-module.d.ts +3 -3
  95. package/lib/node/task-backend-module.js +50 -50
  96. package/lib/node/task-line-matchers.d.ts +27 -27
  97. package/lib/node/task-line-matchers.js +121 -121
  98. package/lib/node/task-manager.d.ts +55 -55
  99. package/lib/node/task-manager.js +135 -135
  100. package/lib/node/task-problem-collector.d.ts +10 -10
  101. package/lib/node/task-problem-collector.js +57 -57
  102. package/lib/node/task-problem-collector.spec.d.ts +1 -1
  103. package/lib/node/task-problem-collector.spec.js +310 -310
  104. package/lib/node/task-runner-protocol.d.ts +16 -16
  105. package/lib/node/task-runner-protocol.js +19 -19
  106. package/lib/node/task-runner.d.ts +50 -50
  107. package/lib/node/task-runner.js +97 -97
  108. package/lib/node/task-server.d.ts +39 -39
  109. package/lib/node/task-server.js +237 -237
  110. package/lib/node/task-server.slow-spec.d.ts +1 -1
  111. package/lib/node/task-server.slow-spec.js +395 -395
  112. package/lib/node/task.d.ts +50 -50
  113. package/lib/node/task.js +77 -77
  114. package/lib/node/test/task-test-container.d.ts +2 -2
  115. package/lib/node/test/task-test-container.js +58 -58
  116. package/package.json +14 -14
  117. package/src/browser/index.ts +22 -22
  118. package/src/browser/process/process-task-contribution.ts +31 -31
  119. package/src/browser/process/process-task-frontend-module.ts +27 -27
  120. package/src/browser/process/process-task-resolver.ts +89 -89
  121. package/src/browser/provided-task-configurations.spec.ts +46 -46
  122. package/src/browser/provided-task-configurations.ts +213 -213
  123. package/src/browser/quick-open-task.ts +831 -827
  124. package/src/browser/style/index.css +19 -19
  125. package/src/browser/task-configuration-manager.ts +256 -256
  126. package/src/browser/task-configuration-model.ts +101 -101
  127. package/src/browser/task-configurations.ts +508 -508
  128. package/src/browser/task-contribution.ts +266 -266
  129. package/src/browser/task-definition-registry.spec.ts +203 -203
  130. package/src/browser/task-definition-registry.ts +131 -131
  131. package/src/browser/task-frontend-contribution.ts +402 -402
  132. package/src/browser/task-frontend-module.ts +86 -86
  133. package/src/browser/task-name-resolver.ts +55 -55
  134. package/src/browser/task-node.ts +37 -37
  135. package/src/browser/task-preferences.ts +40 -40
  136. package/src/browser/task-problem-matcher-registry.ts +308 -308
  137. package/src/browser/task-problem-pattern-registry.ts +196 -196
  138. package/src/browser/task-schema-updater.ts +701 -701
  139. package/src/browser/task-service.ts +1164 -1164
  140. package/src/browser/task-source-resolver.ts +36 -36
  141. package/src/browser/task-templates.ts +168 -168
  142. package/src/browser/task-terminal-widget-manager.ts +224 -224
  143. package/src/browser/tasks-monaco-contribution.ts +27 -27
  144. package/src/common/index.ts +20 -20
  145. package/src/common/problem-matcher-protocol.ts +234 -234
  146. package/src/common/process/task-protocol.ts +97 -97
  147. package/src/common/task-common-module.ts +34 -34
  148. package/src/common/task-protocol.ts +317 -317
  149. package/src/common/task-util.ts +43 -43
  150. package/src/common/task-watcher.ts +78 -78
  151. package/src/node/custom/custom-task-runner-backend-module.ts +37 -37
  152. package/src/node/custom/custom-task-runner-contribution.ts +30 -30
  153. package/src/node/custom/custom-task-runner.ts +60 -60
  154. package/src/node/custom/custom-task.ts +73 -73
  155. package/src/node/index.ts +19 -19
  156. package/src/node/process/process-task-runner-backend-module.ts +37 -37
  157. package/src/node/process/process-task-runner-contribution.ts +31 -31
  158. package/src/node/process/process-task-runner.ts +371 -371
  159. package/src/node/process/process-task.spec.ts +30 -30
  160. package/src/node/process/process-task.ts +144 -144
  161. package/src/node/task-abstract-line-matcher.ts +312 -312
  162. package/src/node/task-backend-application-contribution.ts +36 -36
  163. package/src/node/task-backend-module.ts +57 -57
  164. package/src/node/task-line-matchers.ts +127 -127
  165. package/src/node/task-manager.ts +129 -129
  166. package/src/node/task-problem-collector.spec.ts +338 -338
  167. package/src/node/task-problem-collector.ts +62 -62
  168. package/src/node/task-runner-protocol.ts +33 -33
  169. package/src/node/task-runner.ts +96 -96
  170. package/src/node/task-server.slow-spec.ts +444 -444
  171. package/src/node/task-server.ts +263 -263
  172. package/src/node/task.ts +103 -103
  173. package/src/node/test/task-test-container.ts +63 -63
@@ -1,312 +1,312 @@
1
- // *****************************************************************************
2
- // Copyright (C) 2019 Ericsson and others.
3
- //
4
- // This program and the accompanying materials are made available under the
5
- // terms of the Eclipse Public License v. 2.0 which is available at
6
- // http://www.eclipse.org/legal/epl-2.0.
7
- //
8
- // This Source Code may also be made available under the following Secondary
9
- // Licenses when the conditions for such availability set forth in the Eclipse
10
- // Public License v. 2.0 are satisfied: GNU General Public License, version 2
11
- // with the GNU Classpath Exception which is available at
12
- // https://www.gnu.org/software/classpath/license.html.
13
- //
14
- // SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-only WITH Classpath-exception-2.0
15
- // *****************************************************************************
16
-
17
- /*---------------------------------------------------------------------------------------------
18
- * Copyright (c) Microsoft Corporation. All rights reserved.
19
- * Licensed under the MIT License. See License.txt in the project root for license information.
20
- *--------------------------------------------------------------------------------------------*/
21
-
22
- import { EOL } from '@theia/core/lib/common/os';
23
- import { Diagnostic, DiagnosticSeverity, Range } from '@theia/core/shared/vscode-languageserver-protocol';
24
- import {
25
- FileLocationKind, ProblemMatcher, ProblemPattern,
26
- ProblemMatch, ProblemMatchData, ProblemLocationKind
27
- } from '../common/problem-matcher-protocol';
28
- import URI from '@theia/core/lib/common/uri';
29
- import { Severity } from '@theia/core/lib/common/severity';
30
- import { MAX_SAFE_INTEGER } from '@theia/core/lib/common/numbers';
31
- import { join } from 'path';
32
-
33
- const endOfLine: string = EOL;
34
-
35
- export interface ProblemData {
36
- kind?: ProblemLocationKind;
37
- file?: string;
38
- location?: string;
39
- line?: string;
40
- character?: string;
41
- endLine?: string;
42
- endCharacter?: string;
43
- message?: string;
44
- severity?: string;
45
- code?: string;
46
- }
47
-
48
- export abstract class AbstractLineMatcher {
49
-
50
- protected patterns: ProblemPattern[] = [];
51
- protected activePatternIndex: number = 0;
52
- protected activePattern: ProblemPattern | undefined;
53
- protected cachedProblemData: ProblemData;
54
-
55
- constructor(
56
- protected matcher: ProblemMatcher
57
- ) {
58
- if (Array.isArray(matcher.pattern)) {
59
- this.patterns = matcher.pattern;
60
- } else {
61
- this.patterns = [matcher.pattern];
62
- }
63
- this.cachedProblemData = this.getEmptyProblemData();
64
-
65
- if (this.patterns.slice(0, this.patternCount - 1).some(p => !!p.loop)) {
66
- console.error('Problem Matcher: Only the last pattern can loop');
67
- }
68
- }
69
-
70
- /**
71
- * Finds the problem identified by this line matcher.
72
- *
73
- * @param line the line of text to find the problem from
74
- * @return the identified problem. If the problem is not found, `undefined` is returned.
75
- */
76
- abstract match(line: string): ProblemMatch | undefined;
77
-
78
- /**
79
- * Number of problem patterns that the line matcher uses.
80
- */
81
- get patternCount(): number {
82
- return this.patterns.length;
83
- }
84
-
85
- protected getEmptyProblemData(): ProblemData {
86
- // eslint-disable-next-line no-null/no-null
87
- return Object.create(null) as ProblemData;
88
- }
89
-
90
- protected fillProblemData(data: ProblemData | null, pattern: ProblemPattern, matches: RegExpExecArray): data is ProblemData {
91
- if (data) {
92
- this.fillProperty(data, 'file', pattern, matches, true);
93
- this.appendProperty(data, 'message', pattern, matches, true);
94
- this.fillProperty(data, 'code', pattern, matches, true);
95
- this.fillProperty(data, 'severity', pattern, matches, true);
96
- this.fillProperty(data, 'location', pattern, matches, true);
97
- this.fillProperty(data, 'line', pattern, matches);
98
- this.fillProperty(data, 'character', pattern, matches);
99
- this.fillProperty(data, 'endLine', pattern, matches);
100
- this.fillProperty(data, 'endCharacter', pattern, matches);
101
- return true;
102
- }
103
- return false;
104
- }
105
-
106
- private appendProperty(data: ProblemData, property: keyof ProblemData, pattern: ProblemPattern, matches: RegExpExecArray, trim: boolean = false): void {
107
- const patternProperty = pattern[property];
108
- if (data[property] === undefined) {
109
- this.fillProperty(data, property, pattern, matches, trim);
110
- } else if (patternProperty !== undefined && patternProperty < matches.length) {
111
- let value = matches[patternProperty];
112
- if (trim) {
113
- value = value.trim();
114
- }
115
- (data[property] as string) += endOfLine + value;
116
- }
117
- }
118
-
119
- private fillProperty(data: ProblemData, property: keyof ProblemData, pattern: ProblemPattern, matches: RegExpExecArray, trim: boolean = false): void {
120
- const patternAtProperty = pattern[property];
121
- if (data[property] === undefined && patternAtProperty !== undefined && patternAtProperty < matches.length) {
122
- let value = matches[patternAtProperty];
123
- if (value !== undefined) {
124
- if (trim) {
125
- value = value.trim();
126
- }
127
- (data[property] as string) = value;
128
- }
129
- }
130
- }
131
-
132
- protected getMarkerMatch(data: ProblemData): ProblemMatch | undefined {
133
- try {
134
- const location = this.getLocation(data);
135
- if (data.file && location && data.message) {
136
- const marker: Diagnostic = {
137
- severity: this.getSeverity(data),
138
- range: location,
139
- message: data.message
140
- };
141
- if (data.code !== undefined) {
142
- marker.code = data.code;
143
- }
144
- if (this.matcher.source !== undefined) {
145
- marker.source = this.matcher.source;
146
- }
147
- return {
148
- description: this.matcher,
149
- resource: this.getResource(data.file, this.matcher),
150
- marker
151
- } as ProblemMatchData;
152
- }
153
- return {
154
- description: this.matcher
155
- };
156
- } catch (err) {
157
- console.error(`Failed to convert problem data into match: ${JSON.stringify(data)}`);
158
- }
159
- return undefined;
160
- }
161
-
162
- private getLocation(data: ProblemData): Range | null {
163
- if (data.kind === ProblemLocationKind.File) {
164
- return this.createRange(0, 0, 0, 0);
165
- }
166
- if (data.location) {
167
- return this.parseLocationInfo(data.location);
168
- }
169
- if (!data.line) {
170
- // eslint-disable-next-line no-null/no-null
171
- return null;
172
- }
173
- const startLine = parseInt(data.line);
174
- const startColumn = data.character ? parseInt(data.character) : undefined;
175
- const endLine = data.endLine ? parseInt(data.endLine) : undefined;
176
- const endColumn = data.endCharacter ? parseInt(data.endCharacter) : undefined;
177
- return this.createRange(startLine, startColumn, endLine, endColumn);
178
- }
179
-
180
- private parseLocationInfo(value: string): Range | null {
181
- if (!value || !value.match(/(\d+|\d+,\d+|\d+,\d+,\d+,\d+)/)) {
182
- // eslint-disable-next-line no-null/no-null
183
- return null;
184
- }
185
- const parts = value.split(',');
186
- const startLine = parseInt(parts[0]);
187
- const startColumn = parts.length > 1 ? parseInt(parts[1]) : undefined;
188
- if (parts.length > 3) {
189
- return this.createRange(startLine, startColumn, parseInt(parts[2]), parseInt(parts[3]));
190
- } else {
191
- return this.createRange(startLine, startColumn, undefined, undefined);
192
- }
193
- }
194
-
195
- private createRange(startLine: number, startColumn: number | undefined, endLine: number | undefined, endColumn: number | undefined): Range {
196
- let range: Range;
197
- if (startColumn !== undefined) {
198
- if (endColumn !== undefined) {
199
- range = Range.create(startLine, startColumn, endLine || startLine, endColumn);
200
- } else {
201
- range = Range.create(startLine, startColumn, startLine, startColumn);
202
- }
203
- } else {
204
- range = Range.create(startLine, 1, startLine, MAX_SAFE_INTEGER);
205
- }
206
-
207
- // range indexes should be zero-based
208
- return Range.create(
209
- this.getZeroBasedRangeIndex(range.start.line),
210
- this.getZeroBasedRangeIndex(range.start.character),
211
- this.getZeroBasedRangeIndex(range.end.line),
212
- this.getZeroBasedRangeIndex(range.end.character)
213
- );
214
- }
215
-
216
- private getZeroBasedRangeIndex(ind: number): number {
217
- return ind === 0 ? ind : ind - 1;
218
- }
219
-
220
- private getSeverity(data: ProblemData): DiagnosticSeverity {
221
- // eslint-disable-next-line no-null/no-null
222
- let result: Severity | null = null;
223
- if (data.severity) {
224
- const value = data.severity;
225
- if (value) {
226
- result = Severity.fromValue(value);
227
- if (result === Severity.Ignore) {
228
- if (value === 'E') {
229
- result = Severity.Error;
230
- } else if (value === 'W') {
231
- result = Severity.Warning;
232
- } else if (value === 'I') {
233
- result = Severity.Info;
234
- } else if (value.toLowerCase() === 'hint') {
235
- result = Severity.Info;
236
- } else if (value.toLowerCase() === 'note') {
237
- result = Severity.Info;
238
- }
239
- }
240
- }
241
- }
242
- // eslint-disable-next-line no-null/no-null
243
- if (result === null || result === Severity.Ignore) {
244
- result = this.matcher.severity || Severity.Error;
245
- }
246
- return Severity.toDiagnosticSeverity(result);
247
- }
248
-
249
- private getResource(filename: string, matcher: ProblemMatcher): URI {
250
- const kind = matcher.fileLocation;
251
- let fullPath: string | undefined;
252
- if (kind === FileLocationKind.Absolute) {
253
- fullPath = filename;
254
- } else if ((kind === FileLocationKind.Relative) && matcher.filePrefix) {
255
- let relativeFileName = filename.replace(/\\/g, '/');
256
- if (relativeFileName.startsWith('./')) {
257
- relativeFileName = relativeFileName.slice(2);
258
- }
259
- fullPath = join(matcher.filePrefix, relativeFileName);
260
- }
261
- if (fullPath === undefined) {
262
- throw new Error('FileLocationKind is not actionable. Does the matcher have a filePrefix? This should never happen.');
263
- }
264
- if (matcher.uriProvider !== undefined) {
265
- return matcher.uriProvider(fullPath);
266
- } else {
267
- return URI.fromFilePath(fullPath);
268
- }
269
- }
270
-
271
- protected resetActivePatternIndex(defaultIndex?: number): void {
272
- if (defaultIndex === undefined) {
273
- defaultIndex = 0;
274
- }
275
- this.activePatternIndex = defaultIndex;
276
- this.activePattern = this.patterns[defaultIndex];
277
- }
278
-
279
- protected nextProblemPattern(): void {
280
- this.activePatternIndex++;
281
- if (this.activePatternIndex > this.patternCount - 1) {
282
- this.resetActivePatternIndex();
283
- } else {
284
- this.activePattern = this.patterns[this.activePatternIndex];
285
- }
286
- }
287
-
288
- protected doOneLineMatch(line: string): boolean {
289
- if (this.activePattern) {
290
- const regexp = new RegExp(this.activePattern.regexp);
291
- const regexMatches = regexp.exec(line);
292
- if (regexMatches) {
293
- this.cachedProblemData.kind ??= this.activePattern.kind;
294
- return this.fillProblemData(this.cachedProblemData, this.activePattern, regexMatches);
295
- }
296
- }
297
- return false;
298
- }
299
-
300
- // check if active pattern is the last pattern
301
- protected isUsingTheLastPattern(): boolean {
302
- return this.patternCount > 0 && this.activePatternIndex === this.patternCount - 1;
303
- }
304
-
305
- protected isLastPatternLoop(): boolean {
306
- return this.patternCount > 0 && !!this.patterns[this.patternCount - 1].loop;
307
- }
308
-
309
- protected resetCachedProblemData(): void {
310
- this.cachedProblemData = this.getEmptyProblemData();
311
- }
312
- }
1
+ // *****************************************************************************
2
+ // Copyright (C) 2019 Ericsson and others.
3
+ //
4
+ // This program and the accompanying materials are made available under the
5
+ // terms of the Eclipse Public License v. 2.0 which is available at
6
+ // http://www.eclipse.org/legal/epl-2.0.
7
+ //
8
+ // This Source Code may also be made available under the following Secondary
9
+ // Licenses when the conditions for such availability set forth in the Eclipse
10
+ // Public License v. 2.0 are satisfied: GNU General Public License, version 2
11
+ // with the GNU Classpath Exception which is available at
12
+ // https://www.gnu.org/software/classpath/license.html.
13
+ //
14
+ // SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-only WITH Classpath-exception-2.0
15
+ // *****************************************************************************
16
+
17
+ /*---------------------------------------------------------------------------------------------
18
+ * Copyright (c) Microsoft Corporation. All rights reserved.
19
+ * Licensed under the MIT License. See License.txt in the project root for license information.
20
+ *--------------------------------------------------------------------------------------------*/
21
+
22
+ import { EOL } from '@theia/core/lib/common/os';
23
+ import { Diagnostic, DiagnosticSeverity, Range } from '@theia/core/shared/vscode-languageserver-protocol';
24
+ import {
25
+ FileLocationKind, ProblemMatcher, ProblemPattern,
26
+ ProblemMatch, ProblemMatchData, ProblemLocationKind
27
+ } from '../common/problem-matcher-protocol';
28
+ import URI from '@theia/core/lib/common/uri';
29
+ import { Severity } from '@theia/core/lib/common/severity';
30
+ import { MAX_SAFE_INTEGER } from '@theia/core/lib/common/numbers';
31
+ import { join } from 'path';
32
+
33
+ const endOfLine: string = EOL;
34
+
35
+ export interface ProblemData {
36
+ kind?: ProblemLocationKind;
37
+ file?: string;
38
+ location?: string;
39
+ line?: string;
40
+ character?: string;
41
+ endLine?: string;
42
+ endCharacter?: string;
43
+ message?: string;
44
+ severity?: string;
45
+ code?: string;
46
+ }
47
+
48
+ export abstract class AbstractLineMatcher {
49
+
50
+ protected patterns: ProblemPattern[] = [];
51
+ protected activePatternIndex: number = 0;
52
+ protected activePattern: ProblemPattern | undefined;
53
+ protected cachedProblemData: ProblemData;
54
+
55
+ constructor(
56
+ protected matcher: ProblemMatcher
57
+ ) {
58
+ if (Array.isArray(matcher.pattern)) {
59
+ this.patterns = matcher.pattern;
60
+ } else {
61
+ this.patterns = [matcher.pattern];
62
+ }
63
+ this.cachedProblemData = this.getEmptyProblemData();
64
+
65
+ if (this.patterns.slice(0, this.patternCount - 1).some(p => !!p.loop)) {
66
+ console.error('Problem Matcher: Only the last pattern can loop');
67
+ }
68
+ }
69
+
70
+ /**
71
+ * Finds the problem identified by this line matcher.
72
+ *
73
+ * @param line the line of text to find the problem from
74
+ * @return the identified problem. If the problem is not found, `undefined` is returned.
75
+ */
76
+ abstract match(line: string): ProblemMatch | undefined;
77
+
78
+ /**
79
+ * Number of problem patterns that the line matcher uses.
80
+ */
81
+ get patternCount(): number {
82
+ return this.patterns.length;
83
+ }
84
+
85
+ protected getEmptyProblemData(): ProblemData {
86
+ // eslint-disable-next-line no-null/no-null
87
+ return Object.create(null) as ProblemData;
88
+ }
89
+
90
+ protected fillProblemData(data: ProblemData | null, pattern: ProblemPattern, matches: RegExpExecArray): data is ProblemData {
91
+ if (data) {
92
+ this.fillProperty(data, 'file', pattern, matches, true);
93
+ this.appendProperty(data, 'message', pattern, matches, true);
94
+ this.fillProperty(data, 'code', pattern, matches, true);
95
+ this.fillProperty(data, 'severity', pattern, matches, true);
96
+ this.fillProperty(data, 'location', pattern, matches, true);
97
+ this.fillProperty(data, 'line', pattern, matches);
98
+ this.fillProperty(data, 'character', pattern, matches);
99
+ this.fillProperty(data, 'endLine', pattern, matches);
100
+ this.fillProperty(data, 'endCharacter', pattern, matches);
101
+ return true;
102
+ }
103
+ return false;
104
+ }
105
+
106
+ private appendProperty(data: ProblemData, property: keyof ProblemData, pattern: ProblemPattern, matches: RegExpExecArray, trim: boolean = false): void {
107
+ const patternProperty = pattern[property];
108
+ if (data[property] === undefined) {
109
+ this.fillProperty(data, property, pattern, matches, trim);
110
+ } else if (patternProperty !== undefined && patternProperty < matches.length) {
111
+ let value = matches[patternProperty];
112
+ if (trim) {
113
+ value = value.trim();
114
+ }
115
+ (data[property] as string) += endOfLine + value;
116
+ }
117
+ }
118
+
119
+ private fillProperty(data: ProblemData, property: keyof ProblemData, pattern: ProblemPattern, matches: RegExpExecArray, trim: boolean = false): void {
120
+ const patternAtProperty = pattern[property];
121
+ if (data[property] === undefined && patternAtProperty !== undefined && patternAtProperty < matches.length) {
122
+ let value = matches[patternAtProperty];
123
+ if (value !== undefined) {
124
+ if (trim) {
125
+ value = value.trim();
126
+ }
127
+ (data[property] as string) = value;
128
+ }
129
+ }
130
+ }
131
+
132
+ protected getMarkerMatch(data: ProblemData): ProblemMatch | undefined {
133
+ try {
134
+ const location = this.getLocation(data);
135
+ if (data.file && location && data.message) {
136
+ const marker: Diagnostic = {
137
+ severity: this.getSeverity(data),
138
+ range: location,
139
+ message: data.message
140
+ };
141
+ if (data.code !== undefined) {
142
+ marker.code = data.code;
143
+ }
144
+ if (this.matcher.source !== undefined) {
145
+ marker.source = this.matcher.source;
146
+ }
147
+ return {
148
+ description: this.matcher,
149
+ resource: this.getResource(data.file, this.matcher),
150
+ marker
151
+ } as ProblemMatchData;
152
+ }
153
+ return {
154
+ description: this.matcher
155
+ };
156
+ } catch (err) {
157
+ console.error(`Failed to convert problem data into match: ${JSON.stringify(data)}`);
158
+ }
159
+ return undefined;
160
+ }
161
+
162
+ private getLocation(data: ProblemData): Range | null {
163
+ if (data.kind === ProblemLocationKind.File) {
164
+ return this.createRange(0, 0, 0, 0);
165
+ }
166
+ if (data.location) {
167
+ return this.parseLocationInfo(data.location);
168
+ }
169
+ if (!data.line) {
170
+ // eslint-disable-next-line no-null/no-null
171
+ return null;
172
+ }
173
+ const startLine = parseInt(data.line);
174
+ const startColumn = data.character ? parseInt(data.character) : undefined;
175
+ const endLine = data.endLine ? parseInt(data.endLine) : undefined;
176
+ const endColumn = data.endCharacter ? parseInt(data.endCharacter) : undefined;
177
+ return this.createRange(startLine, startColumn, endLine, endColumn);
178
+ }
179
+
180
+ private parseLocationInfo(value: string): Range | null {
181
+ if (!value || !value.match(/(\d+|\d+,\d+|\d+,\d+,\d+,\d+)/)) {
182
+ // eslint-disable-next-line no-null/no-null
183
+ return null;
184
+ }
185
+ const parts = value.split(',');
186
+ const startLine = parseInt(parts[0]);
187
+ const startColumn = parts.length > 1 ? parseInt(parts[1]) : undefined;
188
+ if (parts.length > 3) {
189
+ return this.createRange(startLine, startColumn, parseInt(parts[2]), parseInt(parts[3]));
190
+ } else {
191
+ return this.createRange(startLine, startColumn, undefined, undefined);
192
+ }
193
+ }
194
+
195
+ private createRange(startLine: number, startColumn: number | undefined, endLine: number | undefined, endColumn: number | undefined): Range {
196
+ let range: Range;
197
+ if (startColumn !== undefined) {
198
+ if (endColumn !== undefined) {
199
+ range = Range.create(startLine, startColumn, endLine || startLine, endColumn);
200
+ } else {
201
+ range = Range.create(startLine, startColumn, startLine, startColumn);
202
+ }
203
+ } else {
204
+ range = Range.create(startLine, 1, startLine, MAX_SAFE_INTEGER);
205
+ }
206
+
207
+ // range indexes should be zero-based
208
+ return Range.create(
209
+ this.getZeroBasedRangeIndex(range.start.line),
210
+ this.getZeroBasedRangeIndex(range.start.character),
211
+ this.getZeroBasedRangeIndex(range.end.line),
212
+ this.getZeroBasedRangeIndex(range.end.character)
213
+ );
214
+ }
215
+
216
+ private getZeroBasedRangeIndex(ind: number): number {
217
+ return ind === 0 ? ind : ind - 1;
218
+ }
219
+
220
+ private getSeverity(data: ProblemData): DiagnosticSeverity {
221
+ // eslint-disable-next-line no-null/no-null
222
+ let result: Severity | null = null;
223
+ if (data.severity) {
224
+ const value = data.severity;
225
+ if (value) {
226
+ result = Severity.fromValue(value);
227
+ if (result === Severity.Ignore) {
228
+ if (value === 'E') {
229
+ result = Severity.Error;
230
+ } else if (value === 'W') {
231
+ result = Severity.Warning;
232
+ } else if (value === 'I') {
233
+ result = Severity.Info;
234
+ } else if (value.toLowerCase() === 'hint') {
235
+ result = Severity.Info;
236
+ } else if (value.toLowerCase() === 'note') {
237
+ result = Severity.Info;
238
+ }
239
+ }
240
+ }
241
+ }
242
+ // eslint-disable-next-line no-null/no-null
243
+ if (result === null || result === Severity.Ignore) {
244
+ result = this.matcher.severity || Severity.Error;
245
+ }
246
+ return Severity.toDiagnosticSeverity(result);
247
+ }
248
+
249
+ private getResource(filename: string, matcher: ProblemMatcher): URI {
250
+ const kind = matcher.fileLocation;
251
+ let fullPath: string | undefined;
252
+ if (kind === FileLocationKind.Absolute) {
253
+ fullPath = filename;
254
+ } else if ((kind === FileLocationKind.Relative) && matcher.filePrefix) {
255
+ let relativeFileName = filename.replace(/\\/g, '/');
256
+ if (relativeFileName.startsWith('./')) {
257
+ relativeFileName = relativeFileName.slice(2);
258
+ }
259
+ fullPath = join(matcher.filePrefix, relativeFileName);
260
+ }
261
+ if (fullPath === undefined) {
262
+ throw new Error('FileLocationKind is not actionable. Does the matcher have a filePrefix? This should never happen.');
263
+ }
264
+ if (matcher.uriProvider !== undefined) {
265
+ return matcher.uriProvider(fullPath);
266
+ } else {
267
+ return URI.fromFilePath(fullPath);
268
+ }
269
+ }
270
+
271
+ protected resetActivePatternIndex(defaultIndex?: number): void {
272
+ if (defaultIndex === undefined) {
273
+ defaultIndex = 0;
274
+ }
275
+ this.activePatternIndex = defaultIndex;
276
+ this.activePattern = this.patterns[defaultIndex];
277
+ }
278
+
279
+ protected nextProblemPattern(): void {
280
+ this.activePatternIndex++;
281
+ if (this.activePatternIndex > this.patternCount - 1) {
282
+ this.resetActivePatternIndex();
283
+ } else {
284
+ this.activePattern = this.patterns[this.activePatternIndex];
285
+ }
286
+ }
287
+
288
+ protected doOneLineMatch(line: string): boolean {
289
+ if (this.activePattern) {
290
+ const regexp = new RegExp(this.activePattern.regexp);
291
+ const regexMatches = regexp.exec(line);
292
+ if (regexMatches) {
293
+ this.cachedProblemData.kind ??= this.activePattern.kind;
294
+ return this.fillProblemData(this.cachedProblemData, this.activePattern, regexMatches);
295
+ }
296
+ }
297
+ return false;
298
+ }
299
+
300
+ // check if active pattern is the last pattern
301
+ protected isUsingTheLastPattern(): boolean {
302
+ return this.patternCount > 0 && this.activePatternIndex === this.patternCount - 1;
303
+ }
304
+
305
+ protected isLastPatternLoop(): boolean {
306
+ return this.patternCount > 0 && !!this.patterns[this.patternCount - 1].loop;
307
+ }
308
+
309
+ protected resetCachedProblemData(): void {
310
+ this.cachedProblemData = this.getEmptyProblemData();
311
+ }
312
+ }