https://github.com/shinnn/real-executable-path-callback

Callback style version of real-executable-path
https://github.com/shinnn/real-executable-path-callback

Last synced: 27 days ago
JSON representation

Callback style version of real-executable-path

• Host: GitHub
• URL: https://github.com/shinnn/real-executable-path-callback
• Owner: shinnn
• License: isc
• Created: 2015-11-01T14:12:47.000Z (about 9 years ago)
• Default Branch: master
• Last Pushed: 2019-01-08T08:07:10.000Z (almost 6 years ago)
• Last Synced: 2024-09-15T01:25:56.664Z (2 months ago)
• Language: JavaScript
• Size: 75.2 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# real-executable-path-callback

[![npm version](https://img.shields.io/npm/v/real-executable-path-callback.svg)](https://www.npmjs.com/package/real-executable-path-callback)

[![Build Status](https://travis-ci.com/shinnn/real-executable-path-callback.svg?branch=master)](https://travis-ci.com/shinnn/real-executable-path-callback)

[![Coverage Status](https://img.shields.io/coveralls/shinnn/real-executable-path-callback.svg)](https://coveralls.io/github/shinnn/real-executable-path-callback)

[Callback](https://thenodeway.io/posts/understanding-error-first-callbacks/)-style version of [real-executable-path]:

> Find the first instance of an executable in the PATH, with expanding all symbolic links

```javascript

const realExecutablePathCallback = require('real-executable-path-callback');

const which = require('which');

realExecutablePathCallback('npm', (err, binPath) => {

  binPath; //=> '/usr/local/lib/node_modules/npm/bin/npm-cli.js'

});

```

## Installation

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

```

npm install real-executable-path-callback

```

## API

```javascript

const realExecutablePathCallback = require('real-executable-path-callback');

```

### realExecutablePathCallback(*binName* [, *options*], *callback*)

*binName*: `string` (an executable name in the PATH)  

*options*: `Object` ([`node-which` options](https://github.com/npm/node-which#options) except for `all`)  

*callback*: `Function` (called after the path is resolved)

It finds the first instance of the given executable in the [PATH](http://pubs.opengroup.org/onlinepubs/000095399/basedefs/xbd_chap08.html#tag_08_03) environment variable, expands all symbolic links and resolves the canonicalized absolute pathname.

```javascript

const realExecutablePathCallback = require('real-executable-path-callback');

realExecutablePathCallback('this_cmd_is_not_installed', err => {

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

  err.code; //=> 'ENOENT'

});

```

## Related project

* [real-executable-path] — `Promise` version

## License

[ISC License](./LICENSE) © 2017 - 2019 Shinnosuke Watanabe

[real-executable-path]: https://github.com/shinnn/real-executable-path