Require and resolve global modules like a boss
npm install requiregRequire and resolve global modules in node.js like a boss.
requireg tries to find modules in global locations which are
not natively supported by the node.js [module resolve algorithm][1].
It support both npm/yarn global packages installation paths.
Supported locations:
- $HOME/node_modules (instead of $HOME/.node_modules)
- $HOME/node_libraries (instead of $HOME/.node_libraries)
- $HOME/node_packages (specific of requireg)
- $PREFIX/lib/node_modules (instead of $PREFIX/lib/node)
- $NODE_MODULES (use the specific modules path environment variable)
1. Resolve via native require() (unless second parameter is true)
2. User home directory ($HOME or %USERPROFILE%)
3. Node installation path
4. $NODE_MODULES (can have different multiple paths, semicolon separated)
5. Common operative system installation paths
``bash`
$ npm install requireg --save[-dev]
`bash`
$ yarn add requireg
`js`
var requireg = require('requireg')
// require a globally installed package
var npm = requireg('npm')
`js`
var requireg = require('requireg')
// require a globally installed package and skip local packages
var eslint = requireg('eslint', true)
`js`
var modulePath = requireg.resolve('npm')
// returns '/usr/local/lib/node_modules/npm/lib/npm.js'
`js`
require('requireg').globalize()
Now it is globally available from any source file
`js`
var globalModule = requireg('npm')
requireg maintains the same behavior as the native require().Error
It will throw an exception if the module was not found
- Require global modules in node.js is considered anti-pattern.
Note that you can experiment unreliability or inconsistency across different environments.
I hope you know exactly what you do with requireg`
- Only node packages installed with npm or yarn are supported (which means only standardized NPM paths are supported)
- Custom environment variable with custom path to resolve global modules.
Released under MIT license
[1]: http://nodejs.org/docs/latest/api/modules.html#modules_all_together
[2]: http://travis-ci.org/h2non/requireg
[3]: http://badge.fury.io/js/requireg