bin-links
is a standalone library that links
binaries and man pages for Javascript packages
$ npm install bin-links
const binLinks = require('bin-links')
const readPackageJson = require('read-package-json-fast')
binLinks({
path: '/path/to/node_modules/some-package',
pkg: readPackageJson('/path/to/node_modules/some-package/package.json'),
// true if it's a global install, false for local. default: false
global: true,
// true if it's the top level package being installed, false otherwise
top: true,
// true if you'd like to recklessly overwrite files.
force: true,
})
- Links bin files listed under the
bin
property of pkg to thenode_modules/.bin
directory of the installing environment. (Or${prefix}/bin
for top level global packages on unix, and${prefix}
for top level global packages on Windows.) - Links man files listed under the
man
property of pkg to the share/man directory. (This is only done for top-level global packages on Unix systems.)
The npm team enthusiastically welcomes contributions and project participation! There's a bunch of things you can do if you want to contribute! The Contributor Guide has all the information you need for everything from reporting bugs to contributing entire new features. Please don't hesitate to jump in if you'd like to, or even ask us questions if something isn't clear.
Returns a Promise that resolves when the requisite things have been linked.
Returns an array of all the paths of links and shims that might be created (assuming that they exist!) for the package at the specified path.
Does not touch the filesystem.
binLinks({path, pkg, force, global, top}).then(() => console.log('bins linked!'))