0
0
mirror of https://github.com/nodejs/node.git synced 2024-12-01 16:10:02 +01:00
nodejs/deps/npm/node_modules/cmd-shim/README.md
Kat Marchán 4ed038808f deps: upgrade to npm 3.7.3
PR-URL: https://github.com/nodejs/node/pull/5369
Reviewed-By: James M Snell <jasnell@gmail.com>
Reviewed-By: Myles Borins <myles.borins@gmail.com>
2016-03-07 15:20:36 -08:00

45 lines
1.1 KiB
Markdown

# cmd-shim
The cmd-shim used in npm to create executable scripts on Windows,
since symlinks are not suitable for this purpose there.
On Unix systems, you should use a symbolic link instead.
[![Build Status](https://img.shields.io/travis/ForbesLindesay/cmd-shim/master.svg)](https://travis-ci.org/ForbesLindesay/cmd-shim)
[![Dependency Status](https://img.shields.io/david/ForbesLindesay/cmd-shim.svg)](https://david-dm.org/ForbesLindesay/cmd-shim)
[![NPM version](https://img.shields.io/npm/v/cmd-shim.svg)](https://www.npmjs.com/package/cmd-shim)
## Installation
```
npm install cmd-shim
```
## API
### cmdShim(from, to, cb)
Create a cmd shim at `to` for the command line program at `from`.
e.g.
```javascript
var cmdShim = require('cmd-shim');
cmdShim(__dirname + '/cli.js', '/usr/bin/command-name', function (err) {
if (err) throw err;
});
```
### cmdShim.ifExists(from, to, cb)
The same as above, but will just continue if the file does not exist.
Source:
```javascript
function cmdShimIfExists (from, to, cb) {
fs.stat(from, function (er) {
if (er) return cb()
cmdShim(from, to, cb)
})
}
```