@theia/process 1.48.0 → 1.48.1

package/lib/common/shell-quoting.d.ts

@@ -1,92 +1,92 @@
-/**
- * Defines how an argument should be quoted if it contains
- * spaces or unsupported characters.
- */
-export declare const enum ShellQuoting {
-    /**
-     * Character escaping should be used. This for example
-     * uses \ on bash and ` on PowerShell.
-     */
-    Escape = "escape",
-    /**
-     * Strong string quoting should be used. This for example
-     * uses " for Windows cmd and ' for bash and PowerShell.
-     * Strong quoting treats arguments as literal strings.
-     * Under PowerShell echo 'The value is $(2 * 3)' will
-     * print `The value is $(2 * 3)`
-     */
-    Strong = "strong",
-    /**
-     * Weak string quoting should be used. This for example
-     * uses " for Windows cmd, bash and PowerShell. Weak quoting
-     * still performs some kind of evaluation inside the quoted
-     * string.  Under PowerShell echo "The value is $(2 * 3)"
-     * will print `The value is 6`
-     */
-    Weak = "weak"
-}
-/**
- * A string that will be quoted depending on the used shell.
- */
-export interface ShellQuotedString {
-    /**
-     * The actual string value.
-     */
-    value: string;
-    /**
-     * The quoting style to use.
-     */
-    quoting: ShellQuoting;
-}
-/**
- * Functions that provide shell quoting capabilities.
- */
-export interface ShellQuotingFunctions {
-    characters: {
-        /** Characters that require quotes, white space is always implied. */
-        needQuotes?: string;
-        /** The character used to escape sequences. */
-        escape?: string;
-        /** The character used to quote sequences, preventing variable expansion. */
-        strong?: string;
-        /** The character used to quote sequences, allowing variable expansion. */
-        weak?: string;
-    };
-    /**
-     * Should add escape-characters in front of forbidden characters.
-     */
-    escape?(this: any, arg: string): string;
-    /**
-     * Should quote the argument in such a way that variables CANNOT be expanded.
-     */
-    strong?(this: any, arg: string): string;
-    /**
-     * Should quote the argument in such a way that variables CAN be expanded.
-     */
-    weak?(this: any, arg: string): string;
-}
-/**
- * Converts a list of args into an escaped shell command.
- *
- * There are two main use cases when handling command/arguments for a shell:
- * 1. User already wrote the escaped commandline, then just use that.
- * 2. User wants a specific process to be invoked with some arguments.
- *
- * The `createShellCommandLine` function is useful for the latter.
- *
- * @param args Standard list of spawn/exec arguments, first item is the command.
- * @param quotingFunctions Collection of functions to process arguments.
- */
-export declare function createShellCommandLine(args: Array<string | ShellQuotedString>, quotingFunctions?: ShellQuotingFunctions): string;
-/**
- * Escape (or quote) a given input.
- *
- * @param arg Input to escape.
- * @param quotingFunctions Collection of functions to process the given `arg`.
- * @param quotingType Override the quoting type specified by the given `arg`.
- */
-export declare function escapeForShell(arg: string | ShellQuotedString, quotingFunctions?: ShellQuotingFunctions, quotingType?: ShellQuoting): string;
-export declare const BashQuotingFunctions: Required<ShellQuotingFunctions>;
-export declare const CmdQuotingFunctions: Required<ShellQuotingFunctions>;
-export declare const PowershellQuotingFunctions: Required<ShellQuotingFunctions>;
+/**
+ * Defines how an argument should be quoted if it contains
+ * spaces or unsupported characters.
+ */
+export declare const enum ShellQuoting {
+    /**
+     * Character escaping should be used. This for example
+     * uses \ on bash and ` on PowerShell.
+     */
+    Escape = "escape",
+    /**
+     * Strong string quoting should be used. This for example
+     * uses " for Windows cmd and ' for bash and PowerShell.
+     * Strong quoting treats arguments as literal strings.
+     * Under PowerShell echo 'The value is $(2 * 3)' will
+     * print `The value is $(2 * 3)`
+     */
+    Strong = "strong",
+    /**
+     * Weak string quoting should be used. This for example
+     * uses " for Windows cmd, bash and PowerShell. Weak quoting
+     * still performs some kind of evaluation inside the quoted
+     * string.  Under PowerShell echo "The value is $(2 * 3)"
+     * will print `The value is 6`
+     */
+    Weak = "weak"
+}
+/**
+ * A string that will be quoted depending on the used shell.
+ */
+export interface ShellQuotedString {
+    /**
+     * The actual string value.
+     */
+    value: string;
+    /**
+     * The quoting style to use.
+     */
+    quoting: ShellQuoting;
+}
+/**
+ * Functions that provide shell quoting capabilities.
+ */
+export interface ShellQuotingFunctions {
+    characters: {
+        /** Characters that require quotes, white space is always implied. */
+        needQuotes?: string;
+        /** The character used to escape sequences. */
+        escape?: string;
+        /** The character used to quote sequences, preventing variable expansion. */
+        strong?: string;
+        /** The character used to quote sequences, allowing variable expansion. */
+        weak?: string;
+    };
+    /**
+     * Should add escape-characters in front of forbidden characters.
+     */
+    escape?(this: any, arg: string): string;
+    /**
+     * Should quote the argument in such a way that variables CANNOT be expanded.
+     */
+    strong?(this: any, arg: string): string;
+    /**
+     * Should quote the argument in such a way that variables CAN be expanded.
+     */
+    weak?(this: any, arg: string): string;
+}
+/**
+ * Converts a list of args into an escaped shell command.
+ *
+ * There are two main use cases when handling command/arguments for a shell:
+ * 1. User already wrote the escaped commandline, then just use that.
+ * 2. User wants a specific process to be invoked with some arguments.
+ *
+ * The `createShellCommandLine` function is useful for the latter.
+ *
+ * @param args Standard list of spawn/exec arguments, first item is the command.
+ * @param quotingFunctions Collection of functions to process arguments.
+ */
+export declare function createShellCommandLine(args: Array<string | ShellQuotedString>, quotingFunctions?: ShellQuotingFunctions): string;
+/**
+ * Escape (or quote) a given input.
+ *
+ * @param arg Input to escape.
+ * @param quotingFunctions Collection of functions to process the given `arg`.
+ * @param quotingType Override the quoting type specified by the given `arg`.
+ */
+export declare function escapeForShell(arg: string | ShellQuotedString, quotingFunctions?: ShellQuotingFunctions, quotingType?: ShellQuoting): string;
+export declare const BashQuotingFunctions: Required<ShellQuotingFunctions>;
+export declare const CmdQuotingFunctions: Required<ShellQuotingFunctions>;
+export declare const PowershellQuotingFunctions: Required<ShellQuotingFunctions>;
 //# sourceMappingURL=shell-quoting.d.ts.map

package/lib/common/shell-quoting.js

@@ -1,146 +1,146 @@
-"use strict";
-// *****************************************************************************
-// Copyright (C) 2020 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-only WITH Classpath-exception-2.0
-// *****************************************************************************
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.PowershellQuotingFunctions = exports.CmdQuotingFunctions = exports.BashQuotingFunctions = exports.escapeForShell = exports.createShellCommandLine = void 0;
-/**
- * Converts a list of args into an escaped shell command.
- *
- * There are two main use cases when handling command/arguments for a shell:
- * 1. User already wrote the escaped commandline, then just use that.
- * 2. User wants a specific process to be invoked with some arguments.
- *
- * The `createShellCommandLine` function is useful for the latter.
- *
- * @param args Standard list of spawn/exec arguments, first item is the command.
- * @param quotingFunctions Collection of functions to process arguments.
- */
-function createShellCommandLine(args, quotingFunctions) {
-    return args.map(arg => escapeForShell(arg, quotingFunctions)).join(' ');
-}
-exports.createShellCommandLine = createShellCommandLine;
-/**
- * Escape (or quote) a given input.
- *
- * @param arg Input to escape.
- * @param quotingFunctions Collection of functions to process the given `arg`.
- * @param quotingType Override the quoting type specified by the given `arg`.
- */
-function escapeForShell(arg, quotingFunctions, quotingType) {
-    let value;
-    let quoting = quotingType;
-    if (typeof arg === 'string') {
-        if (!quoting) {
-            return arg;
-        }
-        value = arg;
-    }
-    else {
-        if (!quoting) {
-            quoting = arg.quoting;
-        }
-        value = arg.value;
-    }
-    if (quotingFunctions && typeof quotingFunctions[quoting] === 'function') {
-        return quotingFunctions[quoting](value);
-    }
-    return value;
-}
-exports.escapeForShell = escapeForShell;
-exports.BashQuotingFunctions = {
-    characters: {
-        needQuotes: '()',
-        escape: '\\',
-        strong: '\'',
-        weak: '"',
-    },
-    escape(arg) {
-        return arg
-            .replace(/[\s\\|(){}<>$&;"']/g, '\\$&');
-    },
-    strong(arg) {
-        // ('+) becomes ('"'+"')
-        return `'${arg
-            .replace(/'+/g, '\'"$&"\'')}'`;
-    },
-    weak(arg) {
-        return `"${arg
-            // Escape escape-characters.
-            .replace(/\\"/g, '\\\\"')
-            // Escape user-specified double-quotes.
-            .replace(/"/g, '\\"')
-            // Escape trailing (\), we don't want the user to escape our last quote.
-            .replace(/\\$/g, '\\\\')}"`;
-    },
-};
-exports.CmdQuotingFunctions = {
-    characters: {
-        weak: '"',
-    },
-    escape(arg) {
-        return arg
-            // Escape forbidden characters (see: cmd /?).
-            .replace(/[%&<>()@^|]/g, '^$&')
-            // Some characters must be escaped using `\`.
-            .replace(/[\\"]/g, '\\$&')
-            // Double-quote whitespaces, else we cannot escape it.
-            .replace(/\s+/g, '"$&"');
-    },
-    strong(arg) {
-        return this.weak(arg)
-            // Try to prevent variable expansion.
-            .replace(/%/g, '"%"');
-    },
-    weak(arg) {
-        return `"${arg
-            // Escape double quotes.
-            .replace(/\\"/g, '\\\\"')
-            .replace(/"/g, '\\"')
-            // Escape forbidden characters (see: cmd /?)
-            .replace(/[&<>()@^|]/g, '^$&')
-            // Escape trailing backslash, we don't want the user to escape our last quote.
-            .replace(/\\$/g, '\\\\')
-            // Escape line returns
-            .replace(/\r?\n/g, '^$&')}"`;
-    },
-};
-exports.PowershellQuotingFunctions = {
-    characters: {
-        needQuotes: '()',
-        escape: '`',
-        strong: '\'',
-        weak: '"',
-    },
-    escape(arg) {
-        return arg.replace(/[`|{}()<>;"' ]/g, '`$&');
-    },
-    strong(arg) {
-        // In powershell, one must write ('') for a single quote to be displayed
-        // within a single quoted string.
-        return `'${arg
-            .replace(/'/g, '\'\'')}'`;
-    },
-    weak(arg) {
-        return `"${arg
-            // Escape escape-characters.
-            .replace(/`"/g, '``"')
-            // Escape user-specified backticks.
-            .replace(/"/g, '`"')
-            // Escape trailing (`), we don't want the user to escape our last quote.
-            .replace(/`$/g, '``')}"`;
-    },
-};
+"use strict";
+// *****************************************************************************
+// Copyright (C) 2020 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-only WITH Classpath-exception-2.0
+// *****************************************************************************
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PowershellQuotingFunctions = exports.CmdQuotingFunctions = exports.BashQuotingFunctions = exports.escapeForShell = exports.createShellCommandLine = void 0;
+/**
+ * Converts a list of args into an escaped shell command.
+ *
+ * There are two main use cases when handling command/arguments for a shell:
+ * 1. User already wrote the escaped commandline, then just use that.
+ * 2. User wants a specific process to be invoked with some arguments.
+ *
+ * The `createShellCommandLine` function is useful for the latter.
+ *
+ * @param args Standard list of spawn/exec arguments, first item is the command.
+ * @param quotingFunctions Collection of functions to process arguments.
+ */
+function createShellCommandLine(args, quotingFunctions) {
+    return args.map(arg => escapeForShell(arg, quotingFunctions)).join(' ');
+}
+exports.createShellCommandLine = createShellCommandLine;
+/**
+ * Escape (or quote) a given input.
+ *
+ * @param arg Input to escape.
+ * @param quotingFunctions Collection of functions to process the given `arg`.
+ * @param quotingType Override the quoting type specified by the given `arg`.
+ */
+function escapeForShell(arg, quotingFunctions, quotingType) {
+    let value;
+    let quoting = quotingType;
+    if (typeof arg === 'string') {
+        if (!quoting) {
+            return arg;
+        }
+        value = arg;
+    }
+    else {
+        if (!quoting) {
+            quoting = arg.quoting;
+        }
+        value = arg.value;
+    }
+    if (quotingFunctions && typeof quotingFunctions[quoting] === 'function') {
+        return quotingFunctions[quoting](value);
+    }
+    return value;
+}
+exports.escapeForShell = escapeForShell;
+exports.BashQuotingFunctions = {
+    characters: {
+        needQuotes: '()',
+        escape: '\\',
+        strong: '\'',
+        weak: '"',
+    },
+    escape(arg) {
+        return arg
+            .replace(/[\s\\|(){}<>$&;"']/g, '\\$&');
+    },
+    strong(arg) {
+        // ('+) becomes ('"'+"')
+        return `'${arg
+            .replace(/'+/g, '\'"$&"\'')}'`;
+    },
+    weak(arg) {
+        return `"${arg
+            // Escape escape-characters.
+            .replace(/\\"/g, '\\\\"')
+            // Escape user-specified double-quotes.
+            .replace(/"/g, '\\"')
+            // Escape trailing (\), we don't want the user to escape our last quote.
+            .replace(/\\$/g, '\\\\')}"`;
+    },
+};
+exports.CmdQuotingFunctions = {
+    characters: {
+        weak: '"',
+    },
+    escape(arg) {
+        return arg
+            // Escape forbidden characters (see: cmd /?).
+            .replace(/[%&<>()@^|]/g, '^$&')
+            // Some characters must be escaped using `\`.
+            .replace(/[\\"]/g, '\\$&')
+            // Double-quote whitespaces, else we cannot escape it.
+            .replace(/\s+/g, '"$&"');
+    },
+    strong(arg) {
+        return this.weak(arg)
+            // Try to prevent variable expansion.
+            .replace(/%/g, '"%"');
+    },
+    weak(arg) {
+        return `"${arg
+            // Escape double quotes.
+            .replace(/\\"/g, '\\\\"')
+            .replace(/"/g, '\\"')
+            // Escape forbidden characters (see: cmd /?)
+            .replace(/[&<>()@^|]/g, '^$&')
+            // Escape trailing backslash, we don't want the user to escape our last quote.
+            .replace(/\\$/g, '\\\\')
+            // Escape line returns
+            .replace(/\r?\n/g, '^$&')}"`;
+    },
+};
+exports.PowershellQuotingFunctions = {
+    characters: {
+        needQuotes: '()',
+        escape: '`',
+        strong: '\'',
+        weak: '"',
+    },
+    escape(arg) {
+        return arg.replace(/[`|{}()<>;"' ]/g, '`$&');
+    },
+    strong(arg) {
+        // In powershell, one must write ('') for a single quote to be displayed
+        // within a single quoted string.
+        return `'${arg
+            .replace(/'/g, '\'\'')}'`;
+    },
+    weak(arg) {
+        return `"${arg
+            // Escape escape-characters.
+            .replace(/`"/g, '``"')
+            // Escape user-specified backticks.
+            .replace(/"/g, '`"')
+            // Escape trailing (`), we don't want the user to escape our last quote.
+            .replace(/`$/g, '``')}"`;
+    },
+};
 //# sourceMappingURL=shell-quoting.js.map

package/lib/common/shell-quoting.spec.d.ts

@@ -1,2 +1,2 @@
-export {};
+export {};
 //# sourceMappingURL=shell-quoting.spec.d.ts.map