@theia/task 1.34.3 → 1.34.4

package/src/browser/process/process-task-resolver.ts

@@ -1,89 +1,89 @@
-// *****************************************************************************
-// Copyright (C) 2018 Red Hat, Inc. and others.
-//
-// This program and the accompanying materials are made available under the
-// terms of the Eclipse Public License v. 2.0 which is available at
-// http://www.eclipse.org/legal/epl-2.0.
-//
-// This Source Code may also be made available under the following Secondary
-// Licenses when the conditions for such availability set forth in the Eclipse
-// Public License v. 2.0 are satisfied: GNU General Public License, version 2
-// with the GNU Classpath Exception which is available at
-// https://www.gnu.org/software/classpath/license.html.
-//
-// SPDX-License-Identifier: EPL-2.0 OR GPL-2.0 WITH Classpath-exception-2.0
-// *****************************************************************************
-
-import { injectable, inject } from '@theia/core/shared/inversify';
-import { VariableResolverService } from '@theia/variable-resolver/lib/browser';
-import { TaskResolver } from '../task-contribution';
-import { TaskConfiguration } from '../../common/task-protocol';
-import { ProcessTaskConfiguration } from '../../common/process/task-protocol';
-import { TaskDefinitionRegistry } from '../task-definition-registry';
-import URI from '@theia/core/lib/common/uri';
-import { WorkspaceService } from '@theia/workspace/lib/browser';
-
-@injectable()
-export class ProcessTaskResolver implements TaskResolver {
-
-    @inject(VariableResolverService)
-    protected readonly variableResolverService: VariableResolverService;
-
-    @inject(TaskDefinitionRegistry)
-    protected readonly taskDefinitionRegistry: TaskDefinitionRegistry;
-
-    @inject(WorkspaceService)
-    protected readonly workspaceService: WorkspaceService;
-
-    /**
-     * Perform some adjustments to the task launch configuration, before sending
-     * it to the backend to be executed. We can make sure that parameters that
-     * are optional to the user but required by the server will be defined, with
-     * sane default values. Also, resolve all known variables, e.g. `${workspaceFolder}`.
-     */
-    async resolveTask(taskConfig: TaskConfiguration): Promise<TaskConfiguration> {
-        const type = taskConfig.taskType || taskConfig.type;
-        if (type !== 'process' && type !== 'shell') {
-            throw new Error('Unsupported task configuration type.');
-        }
-        const context = typeof taskConfig._scope === 'string' ? new URI(taskConfig._scope) : undefined;
-        const variableResolverOptions = {
-            context, configurationSection: 'tasks'
-        };
-        const processTaskConfig = taskConfig as ProcessTaskConfiguration;
-        let cwd = processTaskConfig.options && processTaskConfig.options.cwd;
-        if (!cwd) {
-            const rootURI = this.workspaceService.getWorkspaceRootUri(context);
-            if (rootURI) {
-                cwd = rootURI.toString();
-            }
-        }
-
-        const result: ProcessTaskConfiguration = {
-            ...processTaskConfig,
-            command: await this.variableResolverService.resolve(processTaskConfig.command, variableResolverOptions),
-            args: processTaskConfig.args ? await this.variableResolverService.resolve(processTaskConfig.args, variableResolverOptions) : undefined,
-            windows: processTaskConfig.windows ? {
-                command: await this.variableResolverService.resolve(processTaskConfig.windows.command, variableResolverOptions),
-                args: processTaskConfig.windows.args ? await this.variableResolverService.resolve(processTaskConfig.windows.args, variableResolverOptions) : undefined,
-                options: processTaskConfig.windows.options
-            } : undefined,
-            osx: processTaskConfig.osx ? {
-                command: await this.variableResolverService.resolve(processTaskConfig.osx.command, variableResolverOptions),
-                args: processTaskConfig.osx.args ? await this.variableResolverService.resolve(processTaskConfig.osx.args, variableResolverOptions) : undefined,
-                options: processTaskConfig.osx.options
-            } : undefined,
-            linux: processTaskConfig.linux ? {
-                command: await this.variableResolverService.resolve(processTaskConfig.linux.command, variableResolverOptions),
-                args: processTaskConfig.linux.args ? await this.variableResolverService.resolve(processTaskConfig.linux.args, variableResolverOptions) : undefined,
-                options: processTaskConfig.linux.options
-            } : undefined,
-            options: {
-                cwd: await this.variableResolverService.resolve(cwd, variableResolverOptions),
-                env: processTaskConfig.options?.env && await this.variableResolverService.resolve(processTaskConfig.options.env, variableResolverOptions),
-                shell: processTaskConfig.options && processTaskConfig.options.shell
-            }
-        };
-        return result;
-    }
-}
+// *****************************************************************************
+// Copyright (C) 2018 Red Hat, Inc. and others.
+//
+// This program and the accompanying materials are made available under the
+// terms of the Eclipse Public License v. 2.0 which is available at
+// http://www.eclipse.org/legal/epl-2.0.
+//
+// This Source Code may also be made available under the following Secondary
+// Licenses when the conditions for such availability set forth in the Eclipse
+// Public License v. 2.0 are satisfied: GNU General Public License, version 2
+// with the GNU Classpath Exception which is available at
+// https://www.gnu.org/software/classpath/license.html.
+//
+// SPDX-License-Identifier: EPL-2.0 OR GPL-2.0 WITH Classpath-exception-2.0
+// *****************************************************************************
+
+import { injectable, inject } from '@theia/core/shared/inversify';
+import { VariableResolverService } from '@theia/variable-resolver/lib/browser';
+import { TaskResolver } from '../task-contribution';
+import { TaskConfiguration } from '../../common/task-protocol';
+import { ProcessTaskConfiguration } from '../../common/process/task-protocol';
+import { TaskDefinitionRegistry } from '../task-definition-registry';
+import URI from '@theia/core/lib/common/uri';
+import { WorkspaceService } from '@theia/workspace/lib/browser';
+
+@injectable()
+export class ProcessTaskResolver implements TaskResolver {
+
+    @inject(VariableResolverService)
+    protected readonly variableResolverService: VariableResolverService;
+
+    @inject(TaskDefinitionRegistry)
+    protected readonly taskDefinitionRegistry: TaskDefinitionRegistry;
+
+    @inject(WorkspaceService)
+    protected readonly workspaceService: WorkspaceService;
+
+    /**
+     * Perform some adjustments to the task launch configuration, before sending
+     * it to the backend to be executed. We can make sure that parameters that
+     * are optional to the user but required by the server will be defined, with
+     * sane default values. Also, resolve all known variables, e.g. `${workspaceFolder}`.
+     */
+    async resolveTask(taskConfig: TaskConfiguration): Promise<TaskConfiguration> {
+        const type = taskConfig.taskType || taskConfig.type;
+        if (type !== 'process' && type !== 'shell') {
+            throw new Error('Unsupported task configuration type.');
+        }
+        const context = typeof taskConfig._scope === 'string' ? new URI(taskConfig._scope) : undefined;
+        const variableResolverOptions = {
+            context, configurationSection: 'tasks'
+        };
+        const processTaskConfig = taskConfig as ProcessTaskConfiguration;
+        let cwd = processTaskConfig.options && processTaskConfig.options.cwd;
+        if (!cwd) {
+            const rootURI = this.workspaceService.getWorkspaceRootUri(context);
+            if (rootURI) {
+                cwd = rootURI.toString();
+            }
+        }
+
+        const result: ProcessTaskConfiguration = {
+            ...processTaskConfig,
+            command: await this.variableResolverService.resolve(processTaskConfig.command, variableResolverOptions),
+            args: processTaskConfig.args ? await this.variableResolverService.resolve(processTaskConfig.args, variableResolverOptions) : undefined,
+            windows: processTaskConfig.windows ? {
+                command: await this.variableResolverService.resolve(processTaskConfig.windows.command, variableResolverOptions),
+                args: processTaskConfig.windows.args ? await this.variableResolverService.resolve(processTaskConfig.windows.args, variableResolverOptions) : undefined,
+                options: processTaskConfig.windows.options
+            } : undefined,
+            osx: processTaskConfig.osx ? {
+                command: await this.variableResolverService.resolve(processTaskConfig.osx.command, variableResolverOptions),
+                args: processTaskConfig.osx.args ? await this.variableResolverService.resolve(processTaskConfig.osx.args, variableResolverOptions) : undefined,
+                options: processTaskConfig.osx.options
+            } : undefined,
+            linux: processTaskConfig.linux ? {
+                command: await this.variableResolverService.resolve(processTaskConfig.linux.command, variableResolverOptions),
+                args: processTaskConfig.linux.args ? await this.variableResolverService.resolve(processTaskConfig.linux.args, variableResolverOptions) : undefined,
+                options: processTaskConfig.linux.options
+            } : undefined,
+            options: {
+                cwd: await this.variableResolverService.resolve(cwd, variableResolverOptions),
+                env: processTaskConfig.options?.env && await this.variableResolverService.resolve(processTaskConfig.options.env, variableResolverOptions),
+                shell: processTaskConfig.options && processTaskConfig.options.shell
+            }
+        };
+        return result;
+    }
+}

package/src/browser/provided-task-configurations.spec.ts

@@ -1,46 +1,46 @@
-// *****************************************************************************
-// Copyright (C) 2019 Red Hat, Inc. and others.
-//
-// This program and the accompanying materials are made available under the
-// terms of the Eclipse Public License v. 2.0 which is available at
-// http://www.eclipse.org/legal/epl-2.0.
-//
-// This Source Code may also be made available under the following Secondary
-// Licenses when the conditions for such availability set forth in the Eclipse
-// Public License v. 2.0 are satisfied: GNU General Public License, version 2
-// with the GNU Classpath Exception which is available at
-// https://www.gnu.org/software/classpath/license.html.
-//
-// SPDX-License-Identifier: EPL-2.0 OR GPL-2.0 WITH Classpath-exception-2.0
-// *****************************************************************************
-
-import { assert } from 'chai';
-import { Container } from '@theia/core/shared/inversify';
-import { ProvidedTaskConfigurations } from './provided-task-configurations';
-import { TaskDefinitionRegistry } from './task-definition-registry';
-import { TaskProviderRegistry } from './task-contribution';
-import { TaskConfiguration } from '../common';
-
-describe('provided-task-configurations', () => {
-    let container: Container;
-    beforeEach(() => {
-        container = new Container();
-        container.bind(ProvidedTaskConfigurations).toSelf().inSingletonScope();
-        container.bind(TaskProviderRegistry).toSelf().inSingletonScope();
-        container.bind(TaskDefinitionRegistry).toSelf().inSingletonScope();
-    });
-
-    it('provided-task-search', async () => {
-        const providerRegistry = container.get(TaskProviderRegistry);
-        providerRegistry.register('test', {
-            provideTasks(): Promise<TaskConfiguration[]> {
-                return Promise.resolve([{ type: 'test', label: 'task from test', _source: 'test', _scope: 'test' } as TaskConfiguration]);
-            }
-        });
-
-        const task = await container.get(ProvidedTaskConfigurations).getTask(1, 'test', 'task from test', 'test');
-        assert.isOk(task);
-        assert.equal(task!.type, 'test');
-        assert.equal(task!.label, 'task from test');
-    });
-});
+// *****************************************************************************
+// Copyright (C) 2019 Red Hat, Inc. and others.
+//
+// This program and the accompanying materials are made available under the
+// terms of the Eclipse Public License v. 2.0 which is available at
+// http://www.eclipse.org/legal/epl-2.0.
+//
+// This Source Code may also be made available under the following Secondary
+// Licenses when the conditions for such availability set forth in the Eclipse
+// Public License v. 2.0 are satisfied: GNU General Public License, version 2
+// with the GNU Classpath Exception which is available at
+// https://www.gnu.org/software/classpath/license.html.
+//
+// SPDX-License-Identifier: EPL-2.0 OR GPL-2.0 WITH Classpath-exception-2.0
+// *****************************************************************************
+
+import { assert } from 'chai';
+import { Container } from '@theia/core/shared/inversify';
+import { ProvidedTaskConfigurations } from './provided-task-configurations';
+import { TaskDefinitionRegistry } from './task-definition-registry';
+import { TaskProviderRegistry } from './task-contribution';
+import { TaskConfiguration } from '../common';
+
+describe('provided-task-configurations', () => {
+    let container: Container;
+    beforeEach(() => {
+        container = new Container();
+        container.bind(ProvidedTaskConfigurations).toSelf().inSingletonScope();
+        container.bind(TaskProviderRegistry).toSelf().inSingletonScope();
+        container.bind(TaskDefinitionRegistry).toSelf().inSingletonScope();
+    });
+
+    it('provided-task-search', async () => {
+        const providerRegistry = container.get(TaskProviderRegistry);
+        providerRegistry.register('test', {
+            provideTasks(): Promise<TaskConfiguration[]> {
+                return Promise.resolve([{ type: 'test', label: 'task from test', _source: 'test', _scope: 'test' } as TaskConfiguration]);
+            }
+        });
+
+        const task = await container.get(ProvidedTaskConfigurations).getTask(1, 'test', 'task from test', 'test');
+        assert.isOk(task);
+        assert.equal(task!.type, 'test');
+        assert.equal(task!.label, 'task from test');
+    });
+});

package/src/browser/provided-task-configurations.ts

@@ -1,170 +1,170 @@
-// *****************************************************************************
-// Copyright (C) 2019 Ericsson and others.
-//
-// This program and the accompanying materials are made available under the
-// terms of the Eclipse Public License v. 2.0 which is available at
-// http://www.eclipse.org/legal/epl-2.0.
-//
-// This Source Code may also be made available under the following Secondary
-// Licenses when the conditions for such availability set forth in the Eclipse
-// Public License v. 2.0 are satisfied: GNU General Public License, version 2
-// with the GNU Classpath Exception which is available at
-// https://www.gnu.org/software/classpath/license.html.
-//
-// SPDX-License-Identifier: EPL-2.0 OR GPL-2.0 WITH Classpath-exception-2.0
-// *****************************************************************************
-
-import { inject, injectable } from '@theia/core/shared/inversify';
-import { TaskProviderRegistry } from './task-contribution';
-import { TaskDefinitionRegistry } from './task-definition-registry';
-import { TaskConfiguration, TaskCustomization, TaskOutputPresentation, TaskConfigurationScope, TaskScope } from '../common';
-
-@injectable()
-export class ProvidedTaskConfigurations {
-    /**
-     * Map of source (name of extension, or path of root folder that the task config comes from) and `task config map`.
-     * For the second level of inner map, the key is task label.
-     * For the third level of inner map, the key is the task scope and value TaskConfiguration.
-     */
-    protected tasksMap = new Map<string, Map<string, Map<string | undefined, TaskConfiguration>>>();
-
-    @inject(TaskProviderRegistry)
-    protected readonly taskProviderRegistry: TaskProviderRegistry;
-
-    @inject(TaskDefinitionRegistry)
-    protected readonly taskDefinitionRegistry: TaskDefinitionRegistry;
-
-    private currentToken: number = 0;
-    private nextToken = 1;
-
-    startUserAction(): number {
-        return this.nextToken++;
-    }
-
-    /** returns a list of provided tasks */
-    async getTasks(token: number): Promise<TaskConfiguration[]> {
-        await this.refreshTasks(token);
-        const tasks: TaskConfiguration[] = [];
-        for (const taskLabelMap of this.tasksMap!.values()) {
-            for (const taskScopeMap of taskLabelMap.values()) {
-                for (const task of taskScopeMap.values()) {
-                    tasks.push(task);
-                }
-            }
-        }
-        return tasks;
-    }
-
-    protected async refreshTasks(token: number): Promise<void> {
-        if (token !== this.currentToken) {
-            this.currentToken = token;
-            const providers = await this.taskProviderRegistry.getProviders();
-            const providedTasks: TaskConfiguration[] = (await Promise.all(providers.map(p => p.provideTasks())))
-                .reduce((acc, taskArray) => acc.concat(taskArray), [])
-                // Global/User tasks from providers are not supported.
-                .filter(task => task.scope !== TaskScope.Global)
-                .map(providedTask => {
-                    const originalPresentation = providedTask.presentation || {};
-                    return {
-                        ...providedTask,
-                        presentation: {
-                            ...TaskOutputPresentation.getDefault(),
-                            ...originalPresentation
-                        }
-                    };
-                });
-            this.cacheTasks(providedTasks);
-        }
-    }
-
-    /** returns the task configuration for a given source and label or undefined if none */
-    async getTask(token: number, source: string, taskLabel: string, scope: TaskConfigurationScope): Promise<TaskConfiguration | undefined> {
-        await this.refreshTasks(token);
-        return this.getCachedTask(source, taskLabel, scope);
-    }
-
-    /**
-     * Finds the detected task for the given task customization.
-     * The detected task is considered as a "match" to the task customization if it has all the `required` properties.
-     * In case that more than one customization is found, return the one that has the biggest number of matched properties.
-     *
-     * @param customization the task customization
-     * @return the detected task for the given task customization. If the task customization is not found, `undefined` is returned.
-     */
-    async getTaskToCustomize(token: number, customization: TaskCustomization, scope: TaskConfigurationScope): Promise<TaskConfiguration | undefined> {
-        const definition = this.taskDefinitionRegistry.getDefinition(customization);
-        if (!definition) {
-            return undefined;
-        }
-
-        const matchedTasks: TaskConfiguration[] = [];
-        let highest = -1;
-        const tasks = await this.getTasks(token);
-        for (const task of tasks) { // find detected tasks that match the `definition`
-            const required = definition.properties.required || [];
-            if (!required.every(requiredProp => customization[requiredProp] !== undefined)) {
-                continue;
-            }
-            let score = required.length; // number of required properties
-            const requiredProps = new Set(required);
-            // number of optional properties
-            score += definition.properties.all.filter(p => !requiredProps.has(p) && customization[p] !== undefined).length;
-            if (score >= highest) {
-                if (score > highest) {
-                    highest = score;
-                    matchedTasks.length = 0;
-                }
-                matchedTasks.push(task);
-            }
-        }
-
-        // Tasks with scope set to 'Workspace' can be customized in a workspace root, and will not match
-        // providers scope 'TaskScope.Workspace' unless specifically included as below.
-        const scopes = [scope, TaskScope.Workspace];
-        // find the task that matches the `customization`.
-        // The scenario where more than one match is found should not happen unless users manually enter multiple customizations for one type of task
-        // If this does happen, return the first match
-        const matchedTask = matchedTasks.find(t =>
-            scopes.some(scp => scp === t._scope) && definition.properties.all.every(p => t[p] === customization[p])
-        );
-        return matchedTask;
-    }
-
-    protected getCachedTask(source: string, taskLabel: string, scope?: TaskConfigurationScope): TaskConfiguration | undefined {
-        const labelConfigMap = this.tasksMap.get(source);
-        if (labelConfigMap) {
-            const scopeConfigMap = labelConfigMap.get(taskLabel);
-            if (scopeConfigMap) {
-                if (scope) {
-                    return scopeConfigMap.get(scope.toString());
-                }
-                return Array.from(scopeConfigMap.values())[0];
-            }
-        }
-    }
-
-    protected cacheTasks(tasks: TaskConfiguration[]): void {
-        this.tasksMap.clear();
-        for (const task of tasks) {
-            const label = task.label;
-            const source = task._source;
-            const scope = task._scope;
-            if (this.tasksMap.has(source)) {
-                const labelConfigMap = this.tasksMap.get(source)!;
-                if (labelConfigMap.has(label)) {
-                    labelConfigMap.get(label)!.set(scope.toString(), task);
-                } else {
-                    const newScopeConfigMap = new Map<undefined | string, TaskConfiguration>();
-                    newScopeConfigMap.set(scope.toString(), task);
-                    labelConfigMap.set(label, newScopeConfigMap);
-                }
-            } else {
-                const newLabelConfigMap = new Map<string, Map<undefined | string, TaskConfiguration>>();
-                const newScopeConfigMap = new Map<undefined | string, TaskConfiguration>();
-                newScopeConfigMap.set(scope.toString(), task);
-                newLabelConfigMap.set(label, newScopeConfigMap);
-                this.tasksMap.set(source, newLabelConfigMap);
-            }
-        }
-    }
-}
+// *****************************************************************************
+// Copyright (C) 2019 Ericsson and others.
+//
+// This program and the accompanying materials are made available under the
+// terms of the Eclipse Public License v. 2.0 which is available at
+// http://www.eclipse.org/legal/epl-2.0.
+//
+// This Source Code may also be made available under the following Secondary
+// Licenses when the conditions for such availability set forth in the Eclipse
+// Public License v. 2.0 are satisfied: GNU General Public License, version 2
+// with the GNU Classpath Exception which is available at
+// https://www.gnu.org/software/classpath/license.html.
+//
+// SPDX-License-Identifier: EPL-2.0 OR GPL-2.0 WITH Classpath-exception-2.0
+// *****************************************************************************
+
+import { inject, injectable } from '@theia/core/shared/inversify';
+import { TaskProviderRegistry } from './task-contribution';
+import { TaskDefinitionRegistry } from './task-definition-registry';
+import { TaskConfiguration, TaskCustomization, TaskOutputPresentation, TaskConfigurationScope, TaskScope } from '../common';
+
+@injectable()
+export class ProvidedTaskConfigurations {
+    /**
+     * Map of source (name of extension, or path of root folder that the task config comes from) and `task config map`.
+     * For the second level of inner map, the key is task label.
+     * For the third level of inner map, the key is the task scope and value TaskConfiguration.
+     */
+    protected tasksMap = new Map<string, Map<string, Map<string | undefined, TaskConfiguration>>>();
+
+    @inject(TaskProviderRegistry)
+    protected readonly taskProviderRegistry: TaskProviderRegistry;
+
+    @inject(TaskDefinitionRegistry)
+    protected readonly taskDefinitionRegistry: TaskDefinitionRegistry;
+
+    private currentToken: number = 0;
+    private nextToken = 1;
+
+    startUserAction(): number {
+        return this.nextToken++;
+    }
+
+    /** returns a list of provided tasks */
+    async getTasks(token: number): Promise<TaskConfiguration[]> {
+        await this.refreshTasks(token);
+        const tasks: TaskConfiguration[] = [];
+        for (const taskLabelMap of this.tasksMap!.values()) {
+            for (const taskScopeMap of taskLabelMap.values()) {
+                for (const task of taskScopeMap.values()) {
+                    tasks.push(task);
+                }
+            }
+        }
+        return tasks;
+    }
+
+    protected async refreshTasks(token: number): Promise<void> {
+        if (token !== this.currentToken) {
+            this.currentToken = token;
+            const providers = await this.taskProviderRegistry.getProviders();
+            const providedTasks: TaskConfiguration[] = (await Promise.all(providers.map(p => p.provideTasks())))
+                .reduce((acc, taskArray) => acc.concat(taskArray), [])
+                // Global/User tasks from providers are not supported.
+                .filter(task => task.scope !== TaskScope.Global)
+                .map(providedTask => {
+                    const originalPresentation = providedTask.presentation || {};
+                    return {
+                        ...providedTask,
+                        presentation: {
+                            ...TaskOutputPresentation.getDefault(),
+                            ...originalPresentation
+                        }
+                    };
+                });
+            this.cacheTasks(providedTasks);
+        }
+    }
+
+    /** returns the task configuration for a given source and label or undefined if none */
+    async getTask(token: number, source: string, taskLabel: string, scope: TaskConfigurationScope): Promise<TaskConfiguration | undefined> {
+        await this.refreshTasks(token);
+        return this.getCachedTask(source, taskLabel, scope);
+    }
+
+    /**
+     * Finds the detected task for the given task customization.
+     * The detected task is considered as a "match" to the task customization if it has all the `required` properties.
+     * In case that more than one customization is found, return the one that has the biggest number of matched properties.
+     *
+     * @param customization the task customization
+     * @return the detected task for the given task customization. If the task customization is not found, `undefined` is returned.
+     */
+    async getTaskToCustomize(token: number, customization: TaskCustomization, scope: TaskConfigurationScope): Promise<TaskConfiguration | undefined> {
+        const definition = this.taskDefinitionRegistry.getDefinition(customization);
+        if (!definition) {
+            return undefined;
+        }
+
+        const matchedTasks: TaskConfiguration[] = [];
+        let highest = -1;
+        const tasks = await this.getTasks(token);
+        for (const task of tasks) { // find detected tasks that match the `definition`
+            const required = definition.properties.required || [];
+            if (!required.every(requiredProp => customization[requiredProp] !== undefined)) {
+                continue;
+            }
+            let score = required.length; // number of required properties
+            const requiredProps = new Set(required);
+            // number of optional properties
+            score += definition.properties.all.filter(p => !requiredProps.has(p) && customization[p] !== undefined).length;
+            if (score >= highest) {
+                if (score > highest) {
+                    highest = score;
+                    matchedTasks.length = 0;
+                }
+                matchedTasks.push(task);
+            }
+        }
+
+        // Tasks with scope set to 'Workspace' can be customized in a workspace root, and will not match
+        // providers scope 'TaskScope.Workspace' unless specifically included as below.
+        const scopes = [scope, TaskScope.Workspace];
+        // find the task that matches the `customization`.
+        // The scenario where more than one match is found should not happen unless users manually enter multiple customizations for one type of task
+        // If this does happen, return the first match
+        const matchedTask = matchedTasks.find(t =>
+            scopes.some(scp => scp === t._scope) && definition.properties.all.every(p => t[p] === customization[p])
+        );
+        return matchedTask;
+    }
+
+    protected getCachedTask(source: string, taskLabel: string, scope?: TaskConfigurationScope): TaskConfiguration | undefined {
+        const labelConfigMap = this.tasksMap.get(source);
+        if (labelConfigMap) {
+            const scopeConfigMap = labelConfigMap.get(taskLabel);
+            if (scopeConfigMap) {
+                if (scope) {
+                    return scopeConfigMap.get(scope.toString());
+                }
+                return Array.from(scopeConfigMap.values())[0];
+            }
+        }
+    }
+
+    protected cacheTasks(tasks: TaskConfiguration[]): void {
+        this.tasksMap.clear();
+        for (const task of tasks) {
+            const label = task.label;
+            const source = task._source;
+            const scope = task._scope;
+            if (this.tasksMap.has(source)) {
+                const labelConfigMap = this.tasksMap.get(source)!;
+                if (labelConfigMap.has(label)) {
+                    labelConfigMap.get(label)!.set(scope.toString(), task);
+                } else {
+                    const newScopeConfigMap = new Map<undefined | string, TaskConfiguration>();
+                    newScopeConfigMap.set(scope.toString(), task);
+                    labelConfigMap.set(label, newScopeConfigMap);
+                }
+            } else {
+                const newLabelConfigMap = new Map<string, Map<undefined | string, TaskConfiguration>>();
+                const newScopeConfigMap = new Map<undefined | string, TaskConfiguration>();
+                newScopeConfigMap.set(scope.toString(), task);
+                newLabelConfigMap.set(label, newScopeConfigMap);
+                this.tasksMap.set(source, newLabelConfigMap);
+            }
+        }
+    }
+}