https://github.com/IndigoUnited/node-cross-spawn

A cross platform solution to node's spawn and spawnSync
https://github.com/IndigoUnited/node-cross-spawn

cmd cross-platform exec path-ext shebang spawn windows

Last synced: about 2 months ago
JSON representation

A cross platform solution to node's spawn and spawnSync

• Host: GitHub
• URL: https://github.com/IndigoUnited/node-cross-spawn
• Owner: moxystudio
• License: mit
• Created: 2014-06-30T01:03:58.000Z (over 10 years ago)
• Default Branch: master
• Last Pushed: 2024-05-18T22:02:10.000Z (7 months ago)
• Last Synced: 2024-10-29T11:12:23.456Z (about 2 months ago)
• Topics: cmd, cross-platform, exec, path-ext, shebang, spawn, windows
• Language: JavaScript
• Homepage:
• Size: 619 KB
• Stars: 1,090
• Watchers: 24
• Forks: 73
• Open Issues: 21
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# cross-spawn

[![NPM version][npm-image]][npm-url] [![Downloads][downloads-image]][npm-url] [![Build Status][travis-image]][travis-url] [![Build status][appveyor-image]][appveyor-url] [![Coverage Status][codecov-image]][codecov-url] [![Dependency status][david-dm-image]][david-dm-url] [![Dev Dependency status][david-dm-dev-image]][david-dm-dev-url]

[npm-url]:https://npmjs.org/package/cross-spawn

[downloads-image]:https://img.shields.io/npm/dm/cross-spawn.svg

[npm-image]:https://img.shields.io/npm/v/cross-spawn.svg

[travis-url]:https://travis-ci.org/moxystudio/node-cross-spawn

[travis-image]:https://img.shields.io/travis/moxystudio/node-cross-spawn/master.svg

[appveyor-url]:https://ci.appveyor.com/project/satazor/node-cross-spawn

[appveyor-image]:https://img.shields.io/appveyor/ci/satazor/node-cross-spawn/master.svg

[codecov-url]:https://codecov.io/gh/moxystudio/node-cross-spawn

[codecov-image]:https://img.shields.io/codecov/c/github/moxystudio/node-cross-spawn/master.svg

[david-dm-url]:https://david-dm.org/moxystudio/node-cross-spawn

[david-dm-image]:https://img.shields.io/david/moxystudio/node-cross-spawn.svg

[david-dm-dev-url]:https://david-dm.org/moxystudio/node-cross-spawn?type=dev

[david-dm-dev-image]:https://img.shields.io/david/dev/moxystudio/node-cross-spawn.svg

A cross platform solution to node's spawn and spawnSync.

## Installation

Node.js version 8 and up:

`$ npm install cross-spawn`

Node.js version 7 and under:

`$ npm install cross-spawn@6`

## Why

Node has issues when using spawn on Windows:

- It ignores [PATHEXT](https://github.com/joyent/node/issues/2318)

- It does not support [shebangs](https://en.wikipedia.org/wiki/Shebang_(Unix))

- Has problems running commands with [spaces](https://github.com/nodejs/node/issues/7367)

- Has problems running commands with posix relative paths (e.g.: `./my-folder/my-executable`)

- Has an [issue](https://github.com/moxystudio/node-cross-spawn/issues/82) with command shims (files in `node_modules/.bin/`), where arguments with quotes and parenthesis would result in [invalid syntax error](https://github.com/moxystudio/node-cross-spawn/blob/e77b8f22a416db46b6196767bcd35601d7e11d54/test/index.test.js#L149)

- No `options.shell` support on node `` where `` must not contain any arguments.   

If you would like to have the shebang support improved, feel free to contribute via a pull-request.

Remember to always test your code on Windows!

## Tests

`$ npm test`   

`$ npm test -- --watch` during development

## License

Released under the [MIT License](https://www.opensource.org/licenses/mit-license.php).