'use strict';
|
|
var resolveCommand = require('./util/resolveCommand');
|
var hasEmptyArgumentBug = require('./util/hasEmptyArgumentBug');
|
var escapeArgument = require('./util/escapeArgument');
|
var escapeCommand = require('./util/escapeCommand');
|
var readShebang = require('./util/readShebang');
|
|
var isWin = process.platform === 'win32';
|
var skipShellRegExp = /\.(?:com|exe)$/i;
|
|
// Supported in Node >= 6 and >= 4.8
|
var supportsShellOption = parseInt(process.version.substr(1).split('.')[0], 10) >= 6 ||
|
parseInt(process.version.substr(1).split('.')[0], 10) === 4 && parseInt(process.version.substr(1).split('.')[1], 10) >= 8;
|
|
function parseNonShell(parsed) {
|
var shebang;
|
var needsShell;
|
var applyQuotes;
|
|
if (!isWin) {
|
return parsed;
|
}
|
|
// Detect & add support for shebangs
|
parsed.file = resolveCommand(parsed.command);
|
parsed.file = parsed.file || resolveCommand(parsed.command, true);
|
shebang = parsed.file && readShebang(parsed.file);
|
|
if (shebang) {
|
parsed.args.unshift(parsed.file);
|
parsed.command = shebang;
|
needsShell = hasEmptyArgumentBug || !skipShellRegExp.test(resolveCommand(shebang) || resolveCommand(shebang, true));
|
} else {
|
needsShell = hasEmptyArgumentBug || !skipShellRegExp.test(parsed.file);
|
}
|
|
// If a shell is required, use cmd.exe and take care of escaping everything correctly
|
if (needsShell) {
|
// Escape command & arguments
|
applyQuotes = (parsed.command !== 'echo'); // Do not quote arguments for the special "echo" command
|
parsed.command = escapeCommand(parsed.command);
|
parsed.args = parsed.args.map(function (arg) {
|
return escapeArgument(arg, applyQuotes);
|
});
|
|
// Make use of cmd.exe
|
parsed.args = ['/d', '/s', '/c', '"' + parsed.command + (parsed.args.length ? ' ' + parsed.args.join(' ') : '') + '"'];
|
parsed.command = process.env.comspec || 'cmd.exe';
|
parsed.options.windowsVerbatimArguments = true; // Tell node's spawn that the arguments are already escaped
|
}
|
|
return parsed;
|
}
|
|
function parseShell(parsed) {
|
var shellCommand;
|
|
// If node supports the shell option, there's no need to mimic its behavior
|
if (supportsShellOption) {
|
return parsed;
|
}
|
|
// Mimic node shell option, see: https://github.com/nodejs/node/blob/b9f6a2dc059a1062776133f3d4fd848c4da7d150/lib/child_process.js#L335
|
shellCommand = [parsed.command].concat(parsed.args).join(' ');
|
|
if (isWin) {
|
parsed.command = typeof parsed.options.shell === 'string' ? parsed.options.shell : process.env.comspec || 'cmd.exe';
|
parsed.args = ['/d', '/s', '/c', '"' + shellCommand + '"'];
|
parsed.options.windowsVerbatimArguments = true; // Tell node's spawn that the arguments are already escaped
|
} else {
|
if (typeof parsed.options.shell === 'string') {
|
parsed.command = parsed.options.shell;
|
} else if (process.platform === 'android') {
|
parsed.command = '/system/bin/sh';
|
} else {
|
parsed.command = '/bin/sh';
|
}
|
|
parsed.args = ['-c', shellCommand];
|
}
|
|
return parsed;
|
}
|
|
// ------------------------------------------------
|
|
function parse(command, args, options) {
|
var parsed;
|
|
// Normalize arguments, similar to nodejs
|
if (args && !Array.isArray(args)) {
|
options = args;
|
args = null;
|
}
|
|
args = args ? args.slice(0) : []; // Clone array to avoid changing the original
|
options = options || {};
|
|
// Build our parsed object
|
parsed = {
|
command: command,
|
args: args,
|
options: options,
|
file: undefined,
|
original: command,
|
};
|
|
// Delegate further parsing to shell or non-shell
|
return options.shell ? parseShell(parsed) : parseNonShell(parsed);
|
}
|
|
module.exports = parse;
|
