| 'use strict'; | |
| 
 | |
| const path = require('path'); | |
| const resolveCommand = require('./util/resolveCommand'); | |
| const escape = require('./util/escape'); | |
| const readShebang = require('./util/readShebang'); | |
| 
 | |
| const isWin = process.platform === 'win32'; | |
| const isExecutableRegExp = /\.(?:com|exe)$/i; | |
| const isCmdShimRegExp = /node_modules[\\/].bin[\\/][^\\/]+\.cmd$/i; | |
| 
 | |
| function detectShebang(parsed) { | |
|     parsed.file = resolveCommand(parsed); | |
| 
 | |
|     const shebang = parsed.file && readShebang(parsed.file); | |
| 
 | |
|     if (shebang) { | |
|         parsed.args.unshift(parsed.file); | |
|         parsed.command = shebang; | |
| 
 | |
|         return resolveCommand(parsed); | |
|     } | |
| 
 | |
|     return parsed.file; | |
| } | |
| 
 | |
| function parseNonShell(parsed) { | |
|     if (!isWin) { | |
|         return parsed; | |
|     } | |
| 
 | |
|     // Detect & add support for shebangs | |
|     const commandFile = detectShebang(parsed); | |
| 
 | |
|     // We don't need a shell if the command filename is an executable | |
|     const needsShell = !isExecutableRegExp.test(commandFile); | |
| 
 | |
|     // If a shell is required, use cmd.exe and take care of escaping everything correctly | |
|     // Note that `forceShell` is an hidden option used only in tests | |
|     if (parsed.options.forceShell || needsShell) { | |
|         // Need to double escape meta chars if the command is a cmd-shim located in `node_modules/.bin/` | |
|         // The cmd-shim simply calls execute the package bin file with NodeJS, proxying any argument | |
|         // Because the escape of metachars with ^ gets interpreted when the cmd.exe is first called, | |
|         // we need to double escape them | |
|         const needsDoubleEscapeMetaChars = isCmdShimRegExp.test(commandFile); | |
| 
 | |
|         // Normalize posix paths into OS compatible paths (e.g.: foo/bar -> foo\bar) | |
|         // This is necessary otherwise it will always fail with ENOENT in those cases | |
|         parsed.command = path.normalize(parsed.command); | |
| 
 | |
|         // Escape command & arguments | |
|         parsed.command = escape.command(parsed.command); | |
|         parsed.args = parsed.args.map((arg) => escape.argument(arg, needsDoubleEscapeMetaChars)); | |
| 
 | |
|         const shellCommand = [parsed.command].concat(parsed.args).join(' '); | |
| 
 | |
|         parsed.args = ['/d', '/s', '/c', `"${shellCommand}"`]; | |
|         parsed.command = process.env.comspec || 'cmd.exe'; | |
|         parsed.options.windowsVerbatimArguments = true; // Tell node's spawn that the arguments are already escaped | |
|     } | |
| 
 | |
|     return parsed; | |
| } | |
| 
 | |
| function parse(command, args, options) { | |
|     // 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 = Object.assign({}, options); // Clone object to avoid changing the original | |
|  | |
|     // Build our parsed object | |
|     const parsed = { | |
|         command, | |
|         args, | |
|         options, | |
|         file: undefined, | |
|         original: { | |
|             command, | |
|             args, | |
|         }, | |
|     }; | |
| 
 | |
|     // Delegate further parsing to shell or non-shell | |
|     return options.shell ? parsed : parseNonShell(parsed); | |
| } | |
| 
 | |
| module.exports = parse;
 |