https://github.com/shinnn/which-promise

Promisified version of node-which
https://github.com/shinnn/which-promise

Last synced: 27 days ago
JSON representation

Promisified version of node-which

• Host: GitHub
• URL: https://github.com/shinnn/which-promise
• Owner: shinnn
• License: unlicense
• Created: 2015-10-07T14:00:47.000Z (about 9 years ago)
• Default Branch: master
• Last Pushed: 2015-10-09T08:19:31.000Z (about 9 years ago)
• Last Synced: 2024-10-15T15:23:30.291Z (about 1 month ago)
• Language: JavaScript
• Size: 113 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# which-promise

[![NPM version](https://img.shields.io/npm/v/which-promise.svg)](https://www.npmjs.com/package/which-promise)

[![Build Status](https://travis-ci.org/shinnn/which-promise.svg?branch=master)](https://travis-ci.org/shinnn/which-promise)

[![Build status](https://ci.appveyor.com/api/projects/status/rru70vrrm83s9ddj?svg=true)](https://ci.appveyor.com/project/ShinnosukeWatanabe/which-promise)

[![Coverage Status](https://img.shields.io/coveralls/shinnn/which-promise.svg)](https://coveralls.io/r/shinnn/which-promise)

[![Dependency Status](https://img.shields.io/david/shinnn/which-promise.svg?label=deps)](https://david-dm.org/shinnn/which-promise)

[![devDependency Status](https://img.shields.io/david/dev/shinnn/which-promise.svg?label=devDeps)](https://david-dm.org/shinnn/which-promise#info=devDependencies)

[Promisified](https://promise-nuggets.github.io/articles/07-wrapping-callback-functions.html) version of [node-which](https://github.com/npm/node-which):

> Finds the first instance of a specified executable in the PATH environment variable.

```javascript

const whichPromise = require('which-promise');

whichPromise('ls').then(resolvedPath => {

  resolvedPath; //=> '/bin/ls'

});

whichPromise('ls', {path: './'}).catch(err => {

  err.message; //=> 'not found: ls'

});

```

## Installation

[Use npm.](https://docs.npmjs.com/cli/install)

```

npm install which-promise

```

## API

```javascript

const whichPromise = require('which-promise');

```

### whichPromise(*cmd* [, *options*])

*cmd*: `String` (directly passed to node-which's first argument)  

*options*: `Object` (used as node-which [options](https://github.com/npm/node-which/blob/5d832a3d32b21a7f110771a3c14d5e8ee90d6706/which.js#L40))  

Return: `Object` ([Promise](https://promisesaplus.com/))

## License

[The Unlicense](./LICENSE)