73 lines
1.2 KiB
Markdown
73 lines
1.2 KiB
Markdown
|
# bin-version [](https://travis-ci.com/sindresorhus/bin-version)
|
||
|
|
|
||
|
|
> Get the version of a binary in [semver](https://github.com/npm/node-semver) format
|
||
|
|
|
||
|
|
|
||
|
|
## Install
|
||
|
|
|
||
|
|
```
|
||
|
|
$ npm install bin-version
|
||
|
|
```
|
||
|
|
|
||
|
|
|
||
|
|
## Usage
|
||
|
|
|
||
|
|
```
|
||
|
|
$ curl --version
|
||
|
|
curl 7.30.0 (x86_64-apple-darwin13.0)
|
||
|
|
```
|
||
|
|
|
||
|
|
```js
|
||
|
|
const binVersion = require('bin-version');
|
||
|
|
|
||
|
|
(async () => {
|
||
|
|
console.log(await binVersion('curl'));
|
||
|
|
//=> '7.30.0'
|
||
|
|
})();
|
||
|
|
```
|
||
|
|
|
||
|
|
```
|
||
|
|
$ openssl version
|
||
|
|
OpenSSL 1.0.2d 9 Jul 2015
|
||
|
|
```
|
||
|
|
|
||
|
|
```js
|
||
|
|
(async () => {
|
||
|
|
console.log(await binVersion('openssl', {args: ['version']}));
|
||
|
|
//=> '1.0.2'
|
||
|
|
})();
|
||
|
|
```
|
||
|
|
|
||
|
|
## API
|
||
|
|
|
||
|
|
### binVersion(binary, [options])
|
||
|
|
|
||
|
|
Returns a `Promise<string>` with the version of the `binary`.
|
||
|
|
|
||
|
|
#### binary
|
||
|
|
|
||
|
|
Type: `string`
|
||
|
|
|
||
|
|
The name of or path to the binary to get the version from.
|
||
|
|
|
||
|
|
#### options
|
||
|
|
|
||
|
|
Type: `object`
|
||
|
|
|
||
|
|
##### args
|
||
|
|
|
||
|
|
Type: `string[]`
|
||
|
|
Default: `['--version']`
|
||
|
|
|
||
|
|
The arguments to pass to `binary` so that it will print its version.
|
||
|
|
|
||
|
|
## Related
|
||
|
|
|
||
|
|
- [bin-version-cli](https://github.com/sindresorhus/bin-version-cli) - CLI for this module
|
||
|
|
- [find-versions](https://github.com/sindresorhus/find-versions) - Find semver versions in a string
|
||
|
|
|
||
|
|
|
||
|
|
## License
|
||
|
|
|
||
|
|
MIT © [Sindre Sorhus](https://sindresorhus.com)
|