Bin-manager NPM

NodeJS Binary Manager

🌀 Binaries available as local nodeJS dependencies

Install

$ npm install --save bin-manager

Usage

const bmanager = require('bin-manager');

const base = 'https://github.com/imagemin/gifsicle-bin/raw/master/vendor';
const bin = bmanager('bin', 'gifsicle')
  .src(base + '/macos/gifsicle', 'darwin')
  .src(base + '/linux/x64/gifsicle', 'linux', 'x64')
  .src(base + '/win/x64/gifsicle.exe', 'win32', 'x64')
  .use(process.platform === 'win32' ? 'gifsicle.exe' : 'gifsicle');

bin.run(['--version'], (err, out) => {
  if (err) {
    console.log(error);
    return;
  }
  console.log(out.stdout);
});

API

bmanager(dist, slug)

Creates a new bmanager instance.

dist

Type: string Default: ''

Accepts a path where the binaries will be stored to.

slug

Type: string Default: ''

Accepts an unique slug for the binary. The binary will be downloaded inside the path: dist/slug

.src(url, os, arch)

Adds a source to download. If 0 arguments are passed, the array of current setted sources is returned.

url

Type: string

Accepts a URL pointing to a file to download.

os

Type: string

Tie the source to a specific OS.

arch

Type: string

Tie the source to a specific arch.

.dest(destination)

Adds a destination folder.

destination

Type: string

The path which the files will be downloaded to.

.use(binary)

Get or set the binary path of the extracted file.

binary

Type: string

Define which file to use as executable. If undefined the current setted value is returned.

.path()

Returns the full path where the binary will downloaded to.

.bin()

Returns the full path to your binary.

.remote()

Returns the URLs that will be used/was used to download the binaries for your platform.

.load(options, callback)

Runs the search for the binary. If no binary is found it will download it using the URL provided in .src(). It usese download under the hood. See here all available options.