@theia/task 1.53.0-next.4 → 1.53.0-next.55

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 (60) hide show
  1. package/README.md +193 -193
  2. package/lib/browser/task-schema-updater.js +1 -1
  3. package/package.json +13 -13
  4. package/src/browser/index.ts +22 -22
  5. package/src/browser/process/process-task-contribution.ts +31 -31
  6. package/src/browser/process/process-task-frontend-module.ts +27 -27
  7. package/src/browser/process/process-task-resolver.ts +89 -89
  8. package/src/browser/provided-task-configurations.spec.ts +46 -46
  9. package/src/browser/provided-task-configurations.ts +213 -213
  10. package/src/browser/quick-open-task.ts +831 -831
  11. package/src/browser/style/index.css +19 -19
  12. package/src/browser/task-configuration-manager.ts +256 -256
  13. package/src/browser/task-configuration-model.ts +101 -101
  14. package/src/browser/task-configurations.ts +508 -508
  15. package/src/browser/task-contribution.ts +266 -266
  16. package/src/browser/task-definition-registry.spec.ts +203 -203
  17. package/src/browser/task-definition-registry.ts +131 -131
  18. package/src/browser/task-frontend-contribution.ts +402 -402
  19. package/src/browser/task-frontend-module.ts +86 -86
  20. package/src/browser/task-name-resolver.ts +55 -55
  21. package/src/browser/task-node.ts +37 -37
  22. package/src/browser/task-preferences.ts +40 -40
  23. package/src/browser/task-problem-matcher-registry.ts +308 -308
  24. package/src/browser/task-problem-pattern-registry.ts +196 -196
  25. package/src/browser/task-schema-updater.ts +701 -701
  26. package/src/browser/task-service.ts +1164 -1164
  27. package/src/browser/task-source-resolver.ts +36 -36
  28. package/src/browser/task-templates.ts +168 -168
  29. package/src/browser/task-terminal-widget-manager.ts +224 -224
  30. package/src/browser/tasks-monaco-contribution.ts +27 -27
  31. package/src/common/index.ts +20 -20
  32. package/src/common/problem-matcher-protocol.ts +234 -234
  33. package/src/common/process/task-protocol.ts +97 -97
  34. package/src/common/task-common-module.ts +34 -34
  35. package/src/common/task-protocol.ts +317 -317
  36. package/src/common/task-util.ts +43 -43
  37. package/src/common/task-watcher.ts +78 -78
  38. package/src/node/custom/custom-task-runner-backend-module.ts +37 -37
  39. package/src/node/custom/custom-task-runner-contribution.ts +30 -30
  40. package/src/node/custom/custom-task-runner.ts +60 -60
  41. package/src/node/custom/custom-task.ts +73 -73
  42. package/src/node/index.ts +19 -19
  43. package/src/node/process/process-task-runner-backend-module.ts +37 -37
  44. package/src/node/process/process-task-runner-contribution.ts +31 -31
  45. package/src/node/process/process-task-runner.ts +371 -371
  46. package/src/node/process/process-task.spec.ts +30 -30
  47. package/src/node/process/process-task.ts +144 -144
  48. package/src/node/task-abstract-line-matcher.ts +312 -312
  49. package/src/node/task-backend-application-contribution.ts +36 -36
  50. package/src/node/task-backend-module.ts +57 -57
  51. package/src/node/task-line-matchers.ts +127 -127
  52. package/src/node/task-manager.ts +129 -129
  53. package/src/node/task-problem-collector.spec.ts +338 -338
  54. package/src/node/task-problem-collector.ts +62 -62
  55. package/src/node/task-runner-protocol.ts +33 -33
  56. package/src/node/task-runner.ts +96 -96
  57. package/src/node/task-server.slow-spec.ts +444 -444
  58. package/src/node/task-server.ts +263 -263
  59. package/src/node/task.ts +103 -103
  60. package/src/node/test/task-test-container.ts +63 -63
@@ -1,234 +1,234 @@
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
- // This file is inspired by VSCode https://github.com/Microsoft/vscode/blob/1.33.1/src/vs/workbench/contrib/tasks/common/problemMatcher.ts
18
- // 'problemMatcher.ts' copyright:
19
- /*---------------------------------------------------------------------------------------------
20
- * Copyright (c) Microsoft Corporation. All rights reserved.
21
- * Licensed under the MIT License. See License.txt in the project root for license information.
22
- *--------------------------------------------------------------------------------------------*/
23
-
24
- import { URI } from '@theia/core';
25
- import { Severity } from '@theia/core/lib/common/severity';
26
- import { Diagnostic } from '@theia/core/shared/vscode-languageserver-protocol';
27
-
28
- export enum ApplyToKind {
29
- allDocuments,
30
- openDocuments,
31
- closedDocuments
32
- }
33
-
34
- export namespace ApplyToKind {
35
- export function fromString(value: string | undefined): ApplyToKind | undefined {
36
- if (value) {
37
- value = value.toLowerCase();
38
- if (value === 'alldocuments') {
39
- return ApplyToKind.allDocuments;
40
- } else if (value === 'opendocuments') {
41
- return ApplyToKind.openDocuments;
42
- } else if (value === 'closeddocuments') {
43
- return ApplyToKind.closedDocuments;
44
- }
45
- }
46
- return undefined;
47
- }
48
- }
49
-
50
- export enum FileLocationKind {
51
- Auto,
52
- Relative,
53
- Absolute
54
- }
55
-
56
- export namespace FileLocationKind {
57
- export function fromString(value: string): FileLocationKind | undefined {
58
- value = value.toLowerCase();
59
- if (value === 'absolute') {
60
- return FileLocationKind.Absolute;
61
- } else if (value === 'relative') {
62
- return FileLocationKind.Relative;
63
- } else {
64
- return undefined;
65
- }
66
- }
67
- }
68
-
69
- export interface WatchingPattern {
70
- regexp: string;
71
- file?: number;
72
- }
73
-
74
- export interface WatchingMatcher {
75
- // If set to true the background monitor is in active mode when the task starts.
76
- // This is equals of issuing a line that matches the beginPattern
77
- activeOnStart: boolean;
78
- beginsPattern: WatchingPattern;
79
- endsPattern: WatchingPattern;
80
- }
81
- export namespace WatchingMatcher {
82
- export function fromWatchingMatcherContribution(value: WatchingMatcherContribution | undefined): WatchingMatcher | undefined {
83
- if (!value) {
84
- return undefined;
85
- }
86
- return {
87
- activeOnStart: !!value.activeOnStart,
88
- beginsPattern: typeof value.beginsPattern === 'string' ? { regexp: value.beginsPattern } : value.beginsPattern,
89
- endsPattern: typeof value.endsPattern === 'string' ? { regexp: value.endsPattern } : value.endsPattern
90
- };
91
- }
92
- }
93
-
94
- export enum ProblemLocationKind {
95
- File,
96
- Location
97
- }
98
-
99
- export namespace ProblemLocationKind {
100
- export function fromString(value: string): ProblemLocationKind | undefined {
101
- value = value.toLowerCase();
102
- if (value === 'file') {
103
- return ProblemLocationKind.File;
104
- } else if (value === 'location') {
105
- return ProblemLocationKind.Location;
106
- } else {
107
- return undefined;
108
- }
109
- }
110
- }
111
-
112
- export interface ProblemMatcher {
113
- deprecated?: boolean;
114
-
115
- owner: string;
116
- source?: string;
117
- applyTo: ApplyToKind;
118
- fileLocation: FileLocationKind;
119
- filePrefix?: string;
120
- pattern: ProblemPattern | ProblemPattern[];
121
- severity?: Severity;
122
- watching?: WatchingMatcher;
123
- uriProvider?: (path: string) => URI;
124
- }
125
-
126
- export interface NamedProblemMatcher extends ProblemMatcher {
127
- name: string;
128
- label: string;
129
- }
130
-
131
- export namespace ProblemMatcher {
132
- export function isWatchModeWatcher(matcher: ProblemMatcher): boolean {
133
- return !!matcher.watching;
134
- }
135
- }
136
-
137
- export interface ProblemPattern {
138
- name?: string;
139
-
140
- regexp: string;
141
-
142
- kind?: ProblemLocationKind;
143
- file?: number;
144
- message?: number;
145
- location?: number;
146
- line?: number;
147
- character?: number;
148
- endLine?: number;
149
- endCharacter?: number;
150
- code?: number;
151
- severity?: number;
152
- loop?: boolean;
153
- }
154
-
155
- export interface NamedProblemPattern extends ProblemPattern {
156
- name: string;
157
- }
158
-
159
- export namespace ProblemPattern {
160
- export function fromProblemPatternContribution(value: ProblemPatternContribution): ProblemPattern {
161
- return {
162
- name: value.name,
163
- regexp: value.regexp,
164
- kind: value.kind ? ProblemLocationKind.fromString(value.kind) : undefined,
165
- file: value.file,
166
- message: value.message,
167
- location: value.location,
168
- line: value.line,
169
- character: value.column || value.character,
170
- endLine: value.endLine,
171
- endCharacter: value.endColumn || value.endCharacter,
172
- code: value.code,
173
- severity: value.severity,
174
- loop: value.loop
175
- };
176
- }
177
- }
178
-
179
- export interface ProblemMatch {
180
- resource?: URI;
181
- description: ProblemMatcher;
182
- }
183
-
184
- export interface ProblemMatchData extends ProblemMatch {
185
- marker: Diagnostic;
186
- }
187
- export namespace ProblemMatchData {
188
- export function is(data: ProblemMatch): data is ProblemMatchData {
189
- return 'marker' in data;
190
- }
191
- }
192
-
193
- export interface WatchingMatcherContribution {
194
- // If set to true the background monitor is in active mode when the task starts.
195
- // This is equals of issuing a line that matches the beginPattern
196
- activeOnStart?: boolean;
197
- beginsPattern: string | WatchingPattern;
198
- endsPattern: string | WatchingPattern;
199
- }
200
-
201
- export interface ProblemMatcherContribution {
202
- base?: string;
203
- name?: string;
204
- label: string;
205
- deprecated?: boolean;
206
-
207
- owner: string;
208
- source?: string;
209
- applyTo?: string;
210
- fileLocation?: 'absolute' | 'relative' | string[];
211
- pattern: string | ProblemPatternContribution | ProblemPatternContribution[];
212
- severity?: string;
213
- watching?: WatchingMatcherContribution; // deprecated. Use `background`.
214
- background?: WatchingMatcherContribution;
215
- }
216
-
217
- export interface ProblemPatternContribution {
218
- name?: string;
219
- regexp: string;
220
-
221
- kind?: string;
222
- file?: number;
223
- message?: number;
224
- location?: number;
225
- line?: number;
226
- character?: number;
227
- column?: number;
228
- endLine?: number;
229
- endCharacter?: number;
230
- endColumn?: number;
231
- code?: number;
232
- severity?: number;
233
- loop?: boolean;
234
- }
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
+ // This file is inspired by VSCode https://github.com/Microsoft/vscode/blob/1.33.1/src/vs/workbench/contrib/tasks/common/problemMatcher.ts
18
+ // 'problemMatcher.ts' copyright:
19
+ /*---------------------------------------------------------------------------------------------
20
+ * Copyright (c) Microsoft Corporation. All rights reserved.
21
+ * Licensed under the MIT License. See License.txt in the project root for license information.
22
+ *--------------------------------------------------------------------------------------------*/
23
+
24
+ import { URI } from '@theia/core';
25
+ import { Severity } from '@theia/core/lib/common/severity';
26
+ import { Diagnostic } from '@theia/core/shared/vscode-languageserver-protocol';
27
+
28
+ export enum ApplyToKind {
29
+ allDocuments,
30
+ openDocuments,
31
+ closedDocuments
32
+ }
33
+
34
+ export namespace ApplyToKind {
35
+ export function fromString(value: string | undefined): ApplyToKind | undefined {
36
+ if (value) {
37
+ value = value.toLowerCase();
38
+ if (value === 'alldocuments') {
39
+ return ApplyToKind.allDocuments;
40
+ } else if (value === 'opendocuments') {
41
+ return ApplyToKind.openDocuments;
42
+ } else if (value === 'closeddocuments') {
43
+ return ApplyToKind.closedDocuments;
44
+ }
45
+ }
46
+ return undefined;
47
+ }
48
+ }
49
+
50
+ export enum FileLocationKind {
51
+ Auto,
52
+ Relative,
53
+ Absolute
54
+ }
55
+
56
+ export namespace FileLocationKind {
57
+ export function fromString(value: string): FileLocationKind | undefined {
58
+ value = value.toLowerCase();
59
+ if (value === 'absolute') {
60
+ return FileLocationKind.Absolute;
61
+ } else if (value === 'relative') {
62
+ return FileLocationKind.Relative;
63
+ } else {
64
+ return undefined;
65
+ }
66
+ }
67
+ }
68
+
69
+ export interface WatchingPattern {
70
+ regexp: string;
71
+ file?: number;
72
+ }
73
+
74
+ export interface WatchingMatcher {
75
+ // If set to true the background monitor is in active mode when the task starts.
76
+ // This is equals of issuing a line that matches the beginPattern
77
+ activeOnStart: boolean;
78
+ beginsPattern: WatchingPattern;
79
+ endsPattern: WatchingPattern;
80
+ }
81
+ export namespace WatchingMatcher {
82
+ export function fromWatchingMatcherContribution(value: WatchingMatcherContribution | undefined): WatchingMatcher | undefined {
83
+ if (!value) {
84
+ return undefined;
85
+ }
86
+ return {
87
+ activeOnStart: !!value.activeOnStart,
88
+ beginsPattern: typeof value.beginsPattern === 'string' ? { regexp: value.beginsPattern } : value.beginsPattern,
89
+ endsPattern: typeof value.endsPattern === 'string' ? { regexp: value.endsPattern } : value.endsPattern
90
+ };
91
+ }
92
+ }
93
+
94
+ export enum ProblemLocationKind {
95
+ File,
96
+ Location
97
+ }
98
+
99
+ export namespace ProblemLocationKind {
100
+ export function fromString(value: string): ProblemLocationKind | undefined {
101
+ value = value.toLowerCase();
102
+ if (value === 'file') {
103
+ return ProblemLocationKind.File;
104
+ } else if (value === 'location') {
105
+ return ProblemLocationKind.Location;
106
+ } else {
107
+ return undefined;
108
+ }
109
+ }
110
+ }
111
+
112
+ export interface ProblemMatcher {
113
+ deprecated?: boolean;
114
+
115
+ owner: string;
116
+ source?: string;
117
+ applyTo: ApplyToKind;
118
+ fileLocation: FileLocationKind;
119
+ filePrefix?: string;
120
+ pattern: ProblemPattern | ProblemPattern[];
121
+ severity?: Severity;
122
+ watching?: WatchingMatcher;
123
+ uriProvider?: (path: string) => URI;
124
+ }
125
+
126
+ export interface NamedProblemMatcher extends ProblemMatcher {
127
+ name: string;
128
+ label: string;
129
+ }
130
+
131
+ export namespace ProblemMatcher {
132
+ export function isWatchModeWatcher(matcher: ProblemMatcher): boolean {
133
+ return !!matcher.watching;
134
+ }
135
+ }
136
+
137
+ export interface ProblemPattern {
138
+ name?: string;
139
+
140
+ regexp: string;
141
+
142
+ kind?: ProblemLocationKind;
143
+ file?: number;
144
+ message?: number;
145
+ location?: number;
146
+ line?: number;
147
+ character?: number;
148
+ endLine?: number;
149
+ endCharacter?: number;
150
+ code?: number;
151
+ severity?: number;
152
+ loop?: boolean;
153
+ }
154
+
155
+ export interface NamedProblemPattern extends ProblemPattern {
156
+ name: string;
157
+ }
158
+
159
+ export namespace ProblemPattern {
160
+ export function fromProblemPatternContribution(value: ProblemPatternContribution): ProblemPattern {
161
+ return {
162
+ name: value.name,
163
+ regexp: value.regexp,
164
+ kind: value.kind ? ProblemLocationKind.fromString(value.kind) : undefined,
165
+ file: value.file,
166
+ message: value.message,
167
+ location: value.location,
168
+ line: value.line,
169
+ character: value.column || value.character,
170
+ endLine: value.endLine,
171
+ endCharacter: value.endColumn || value.endCharacter,
172
+ code: value.code,
173
+ severity: value.severity,
174
+ loop: value.loop
175
+ };
176
+ }
177
+ }
178
+
179
+ export interface ProblemMatch {
180
+ resource?: URI;
181
+ description: ProblemMatcher;
182
+ }
183
+
184
+ export interface ProblemMatchData extends ProblemMatch {
185
+ marker: Diagnostic;
186
+ }
187
+ export namespace ProblemMatchData {
188
+ export function is(data: ProblemMatch): data is ProblemMatchData {
189
+ return 'marker' in data;
190
+ }
191
+ }
192
+
193
+ export interface WatchingMatcherContribution {
194
+ // If set to true the background monitor is in active mode when the task starts.
195
+ // This is equals of issuing a line that matches the beginPattern
196
+ activeOnStart?: boolean;
197
+ beginsPattern: string | WatchingPattern;
198
+ endsPattern: string | WatchingPattern;
199
+ }
200
+
201
+ export interface ProblemMatcherContribution {
202
+ base?: string;
203
+ name?: string;
204
+ label: string;
205
+ deprecated?: boolean;
206
+
207
+ owner: string;
208
+ source?: string;
209
+ applyTo?: string;
210
+ fileLocation?: 'absolute' | 'relative' | string[];
211
+ pattern: string | ProblemPatternContribution | ProblemPatternContribution[];
212
+ severity?: string;
213
+ watching?: WatchingMatcherContribution; // deprecated. Use `background`.
214
+ background?: WatchingMatcherContribution;
215
+ }
216
+
217
+ export interface ProblemPatternContribution {
218
+ name?: string;
219
+ regexp: string;
220
+
221
+ kind?: string;
222
+ file?: number;
223
+ message?: number;
224
+ location?: number;
225
+ line?: number;
226
+ character?: number;
227
+ column?: number;
228
+ endLine?: number;
229
+ endCharacter?: number;
230
+ endColumn?: number;
231
+ code?: number;
232
+ severity?: number;
233
+ loop?: boolean;
234
+ }
@@ -1,97 +1,97 @@
1
- // *****************************************************************************
2
- // Copyright (C) 2018 Red Hat, Inc. 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
- import { TaskConfiguration, TaskInfo } from '../task-protocol';
18
- import { ApplicationError } from '@theia/core/lib/common/application-error';
19
-
20
- export type ProcessType = 'shell' | 'process';
21
-
22
- export interface CommandOptions {
23
- /**
24
- * The 'current working directory' the task will run in. Can be a uri-as-string
25
- * or plain string path. If the cwd is meant to be somewhere under the workspace,
26
- * one can use the variable `${workspaceFolder}`, which will be replaced by its path,
27
- * at runtime. If not specified, defaults to the workspace root.
28
- * ex: cwd: '${workspaceFolder}/foo'
29
- */
30
- cwd?: string;
31
-
32
- /**
33
- * The environment of the executed program or shell. If omitted the parent process' environment is used.
34
- */
35
- env?: { [key: string]: string | undefined; };
36
-
37
- /**
38
- * Configuration of the shell when task type is `shell`
39
- */
40
- shell?: {
41
- /**
42
- * The shell to use.
43
- */
44
- executable: string;
45
-
46
- /**
47
- * The arguments to be passed to the shell executable to run in command mode
48
- * (e.g ['-c'] for bash or ['/S', '/C'] for cmd.exe).
49
- */
50
- args?: string[];
51
- };
52
- }
53
-
54
- export interface CommandProperties {
55
- readonly command?: string;
56
- readonly args?: string[];
57
- readonly options?: CommandOptions;
58
- }
59
-
60
- /** Configuration of a Task that may be run as a process or a command inside a shell. */
61
- export interface ProcessTaskConfiguration extends TaskConfiguration, CommandProperties {
62
- readonly type: ProcessType;
63
-
64
- /**
65
- * Windows specific task configuration
66
- */
67
- readonly windows?: CommandProperties;
68
-
69
- /**
70
- * macOS specific task configuration
71
- */
72
- readonly osx?: CommandProperties;
73
-
74
- /**
75
- * Linux specific task configuration
76
- */
77
- readonly linux?: CommandProperties;
78
- }
79
-
80
- export interface ProcessTaskInfo extends TaskInfo {
81
- /** process id. Defined if task is run as a process */
82
- readonly processId?: number;
83
- /** process task command */
84
- readonly command?: string;
85
- }
86
- export namespace ProcessTaskInfo {
87
- export function is(info: TaskInfo): info is ProcessTaskInfo {
88
- return info['processId'] !== undefined;
89
- }
90
- }
91
-
92
- export namespace ProcessTaskError {
93
- export const CouldNotRun = ApplicationError.declare(1, (code: string) => ({
94
- message: `Error starting process (${code})`,
95
- data: { code }
96
- }));
97
- }
1
+ // *****************************************************************************
2
+ // Copyright (C) 2018 Red Hat, Inc. 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
+ import { TaskConfiguration, TaskInfo } from '../task-protocol';
18
+ import { ApplicationError } from '@theia/core/lib/common/application-error';
19
+
20
+ export type ProcessType = 'shell' | 'process';
21
+
22
+ export interface CommandOptions {
23
+ /**
24
+ * The 'current working directory' the task will run in. Can be a uri-as-string
25
+ * or plain string path. If the cwd is meant to be somewhere under the workspace,
26
+ * one can use the variable `${workspaceFolder}`, which will be replaced by its path,
27
+ * at runtime. If not specified, defaults to the workspace root.
28
+ * ex: cwd: '${workspaceFolder}/foo'
29
+ */
30
+ cwd?: string;
31
+
32
+ /**
33
+ * The environment of the executed program or shell. If omitted the parent process' environment is used.
34
+ */
35
+ env?: { [key: string]: string | undefined; };
36
+
37
+ /**
38
+ * Configuration of the shell when task type is `shell`
39
+ */
40
+ shell?: {
41
+ /**
42
+ * The shell to use.
43
+ */
44
+ executable: string;
45
+
46
+ /**
47
+ * The arguments to be passed to the shell executable to run in command mode
48
+ * (e.g ['-c'] for bash or ['/S', '/C'] for cmd.exe).
49
+ */
50
+ args?: string[];
51
+ };
52
+ }
53
+
54
+ export interface CommandProperties {
55
+ readonly command?: string;
56
+ readonly args?: string[];
57
+ readonly options?: CommandOptions;
58
+ }
59
+
60
+ /** Configuration of a Task that may be run as a process or a command inside a shell. */
61
+ export interface ProcessTaskConfiguration extends TaskConfiguration, CommandProperties {
62
+ readonly type: ProcessType;
63
+
64
+ /**
65
+ * Windows specific task configuration
66
+ */
67
+ readonly windows?: CommandProperties;
68
+
69
+ /**
70
+ * macOS specific task configuration
71
+ */
72
+ readonly osx?: CommandProperties;
73
+
74
+ /**
75
+ * Linux specific task configuration
76
+ */
77
+ readonly linux?: CommandProperties;
78
+ }
79
+
80
+ export interface ProcessTaskInfo extends TaskInfo {
81
+ /** process id. Defined if task is run as a process */
82
+ readonly processId?: number;
83
+ /** process task command */
84
+ readonly command?: string;
85
+ }
86
+ export namespace ProcessTaskInfo {
87
+ export function is(info: TaskInfo): info is ProcessTaskInfo {
88
+ return info['processId'] !== undefined;
89
+ }
90
+ }
91
+
92
+ export namespace ProcessTaskError {
93
+ export const CouldNotRun = ApplicationError.declare(1, (code: string) => ({
94
+ message: `Error starting process (${code})`,
95
+ data: { code }
96
+ }));
97
+ }