LICENSE.md

@@ -0,0 +1,22 @@
+(The MIT License)
+
+Copyright (c) 2012 Nathan Rajlich <nathan@tootallnate.net>
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+'Software'), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

README.md

@@ -1,15 +1,15 @@
 node-bindings
 =============
-### Helper module for loading your native module's .node file
+### Helper module for loading your native module's `.node` file
 
 This is a helper module for authors of Node.js native addon modules.
 It is basically the "swiss army knife" of `require()`ing your native module's
 `.node` file.
 
 Throughout the course of Node's native addon history, addons have ended up being
 compiled in a variety of different places, depending on which build tool and which
-version of node was used. To make matters worse, now the _gyp_ build tool can
-produce either a _Release_ or _Debug_ build, each being built into different
+version of node was used. To make matters worse, now the `gyp` build tool can
+produce either a __Release__ or __Debug__ build, each being built into different
 locations.
 
 This module checks _all_ the possible locations that a native addon would be built
@@ -22,10 +22,10 @@ Installation
 Install with `npm`:
 
 ``` bash
-$ npm install bindings
+$ npm install --save bindings
 ```
 
-Or add it to the `"dependencies"` section of your _package.json_ file.
+Or add it to the `"dependencies"` section of your `package.json` file.
 
 
 Example
@@ -69,6 +69,7 @@ Error: Could not load the bindings file. Tried:
     ...
 ```
 
+The searching for the `.node` file will originate from the first directory in which has a `package.json` file is found.
 
 License
 -------

bindings.js

@@ -1,137 +1,186 @@
-
 /**
  * Module dependencies.
  */
 
-var fs = require('fs')
-  , path = require('path')
-  , join = path.join
-  , dirname = path.dirname
-  , exists = fs.existsSync || path.existsSync
-  , defaults = {
-        arrow: process.env.NODE_BINDINGS_ARROW || ' → '
-      , compiled: process.env.NODE_BINDINGS_COMPILED_DIR || 'compiled'
-      , platform: process.platform
-      , arch: process.arch
-      , version: process.versions.node
-      , bindings: 'bindings.node'
-      , try: [
-          // node-gyp's linked version in the "build" dir
-          [ 'module_root', 'build', 'bindings' ]
-          // node-waf and gyp_addon (a.k.a node-gyp)
-        , [ 'module_root', 'build', 'Debug', 'bindings' ]
-        , [ 'module_root', 'build', 'Release', 'bindings' ]
-          // Debug files, for development (legacy behavior, remove for node v0.9)
-        , [ 'module_root', 'out', 'Debug', 'bindings' ]
-        , [ 'module_root', 'Debug', 'bindings' ]
-          // Release files, but manually compiled (legacy behavior, remove for node v0.9)
-        , [ 'module_root', 'out', 'Release', 'bindings' ]
-        , [ 'module_root', 'Release', 'bindings' ]
-          // Legacy from node-waf, node <= 0.4.x
-        , [ 'module_root', 'build', 'default', 'bindings' ]
-          // Production "Release" buildtype binary (meh...)
-        , [ 'module_root', 'compiled', 'version', 'platform', 'arch', 'bindings' ]
-        ]
-    }
+var fs = require('fs'),
+  path = require('path'),
+  fileURLToPath = require('file-uri-to-path'),
+  join = path.join,
+  dirname = path.dirname,
+  exists =
+    (fs.accessSync &&
+      function(path) {
+        try {
+          fs.accessSync(path);
+        } catch (e) {
+          return false;
+        }
+        return true;
+      }) ||
+    fs.existsSync ||
+    path.existsSync,
+  defaults = {
+    arrow: process.env.NODE_BINDINGS_ARROW || ' → ',
+    compiled: process.env.NODE_BINDINGS_COMPILED_DIR || 'compiled',
+    platform: process.platform,
+    arch: process.arch,
+    nodePreGyp:
+      'node-v' +
+      process.versions.modules +
+      '-' +
+      process.platform +
+      '-' +
+      process.arch,
+    version: process.versions.node,
+    bindings: 'bindings.node',
+    try: [
+      // node-gyp's linked version in the "build" dir
+      ['module_root', 'build', 'bindings'],
+      // node-waf and gyp_addon (a.k.a node-gyp)
+      ['module_root', 'build', 'Debug', 'bindings'],
+      ['module_root', 'build', 'Release', 'bindings'],
+      // Debug files, for development (legacy behavior, remove for node v0.9)
+      ['module_root', 'out', 'Debug', 'bindings'],
+      ['module_root', 'Debug', 'bindings'],
+      // Release files, but manually compiled (legacy behavior, remove for node v0.9)
+      ['module_root', 'out', 'Release', 'bindings'],
+      ['module_root', 'Release', 'bindings'],
+      // Legacy from node-waf, node <= 0.4.x
+      ['module_root', 'build', 'default', 'bindings'],
+      // Production "Release" buildtype binary (meh...)
+      ['module_root', 'compiled', 'version', 'platform', 'arch', 'bindings'],
+      // node-qbs builds
+      ['module_root', 'addon-build', 'release', 'install-root', 'bindings'],
+      ['module_root', 'addon-build', 'debug', 'install-root', 'bindings'],
+      ['module_root', 'addon-build', 'default', 'install-root', 'bindings'],
+      // node-pre-gyp path ./lib/binding/{node_abi}-{platform}-{arch}
+      ['module_root', 'lib', 'binding', 'nodePreGyp', 'bindings']
+    ]
+  };
 
 /**
  * The main `bindings()` function loads the compiled bindings for a given module.
  * It uses V8's Error API to determine the parent filename that this function is
  * being invoked from, which is then used to find the root directory.
  */
 
-function bindings (opts) {
-
+function bindings(opts) {
   // Argument surgery
   if (typeof opts == 'string') {
-    opts = { bindings: opts }
+    opts = { bindings: opts };
   } else if (!opts) {
-    opts = {}
+    opts = {};
   }
-  opts.__proto__ = defaults
+
+  // maps `defaults` onto `opts` object
+  Object.keys(defaults).map(function(i) {
+    if (!(i in opts)) opts[i] = defaults[i];
+  });
 
   // Get the module root
   if (!opts.module_root) {
-    opts.module_root = exports.getRoot(exports.getFileName())
+    opts.module_root = exports.getRoot(exports.getFileName());
   }
 
   // Ensure the given bindings name ends with .node
   if (path.extname(opts.bindings) != '.node') {
-    opts.bindings += '.node'
+    opts.bindings += '.node';
   }
 
-  var tries = []
-    , i = 0
-    , l = opts.try.length
-    , n
-    , b
-    , err
-
-  for (; i<l; i++) {
-    n = join.apply(null, opts.try[i].map(function (p) {
-      return opts[p] || p
-    }))
-    tries.push(n)
+  // https://github.com/webpack/webpack/issues/4175#issuecomment-342931035
+  var requireFunc =
+    typeof __webpack_require__ === 'function'
+      ? __non_webpack_require__
+      : require;
+
+  var tries = [],
+    i = 0,
+    l = opts.try.length,
+    n,
+    b,
+    err;
+
+  for (; i < l; i++) {
+    n = join.apply(
+      null,
+      opts.try[i].map(function(p) {
+        return opts[p] || p;
+      })
+    );
+    tries.push(n);
     try {
-      b = opts.path ? require.resolve(n) : require(n)
+      b = opts.path ? requireFunc.resolve(n) : requireFunc(n);
       if (!opts.path) {
-        b.path = n
+        b.path = n;
       }
-      return b
+      return b;
     } catch (e) {
-      if (!/not find/i.test(e.message)) {
-        throw e
+      if (e.code !== 'MODULE_NOT_FOUND' &&
+          e.code !== 'QUALIFIED_PATH_RESOLUTION_FAILED' &&
+          !/not find/i.test(e.message)) {
+        throw e;
       }
     }
   }
 
-  err = new Error('Could not locate the bindings file. Tried:\n'
-    + tries.map(function (a) { return opts.arrow + a }).join('\n'))
-  err.tries = tries
-  throw err
+  err = new Error(
+    'Could not locate the bindings file. Tried:\n' +
+      tries
+        .map(function(a) {
+          return opts.arrow + a;
+        })
+        .join('\n')
+  );
+  err.tries = tries;
+  throw err;
 }
-module.exports = exports = bindings
-
+module.exports = exports = bindings;
 
 /**
  * Gets the filename of the JavaScript file that invokes this function.
  * Used to help find the root directory of a module.
  * Optionally accepts an filename argument to skip when searching for the invoking filename
  */
 
-exports.getFileName = function getFileName (calling_file) {
-  var origPST = Error.prepareStackTrace
-    , origSTL = Error.stackTraceLimit
-    , dummy = {}
-    , fileName
+exports.getFileName = function getFileName(calling_file) {
+  var origPST = Error.prepareStackTrace,
+    origSTL = Error.stackTraceLimit,
+    dummy = {},
+    fileName;
 
-  Error.stackTraceLimit = 10
+  Error.stackTraceLimit = 10;
 
-  Error.prepareStackTrace = function (e, st) {
-    for (var i=0, l=st.length; i<l; i++) {
-      fileName = st[i].getFileName()
+  Error.prepareStackTrace = function(e, st) {
+    for (var i = 0, l = st.length; i < l; i++) {
+      fileName = st[i].getFileName();
       if (fileName !== __filename) {
         if (calling_file) {
-            if (fileName !== calling_file) {
-              return
-            }
+          if (fileName !== calling_file) {
+            return;
+          }
         } else {
-          return
+          return;
         }
       }
     }
-  }
+  };
 
   // run the 'prepareStackTrace' function above
-  Error.captureStackTrace(dummy)
-  dummy.stack
+  Error.captureStackTrace(dummy);
+  dummy.stack;
 
   // cleanup
-  Error.prepareStackTrace = origPST
-  Error.stackTraceLimit = origSTL
+  Error.prepareStackTrace = origPST;
+  Error.stackTraceLimit = origSTL;
 
-  return fileName
-}
+  // handle filename that starts with "file://"
+  var fileSchema = 'file://';
+  if (fileName.indexOf(fileSchema) === 0) {
+    fileName = fileURLToPath(fileName);
+  }
+
+  return fileName;
+};
 
 /**
  * Gets the root directory of a module, given an arbitrary filename
@@ -142,25 +191,31 @@ exports.getFileName = function getFileName (calling_file) {
  *   Out: /home/nate/node-native-module
  */
 
-exports.getRoot = function getRoot (file) {
-  var dir = dirname(file)
-    , prev
+exports.getRoot = function getRoot(file) {
+  var dir = dirname(file),
+    prev;
   while (true) {
     if (dir === '.') {
       // Avoids an infinite loop in rare cases, like the REPL
-      dir = process.cwd()
+      dir = process.cwd();
     }
-    if (exists(join(dir, 'package.json')) || exists(join(dir, 'node_modules'))) {
+    if (
+      exists(join(dir, 'package.json')) ||
+      exists(join(dir, 'node_modules'))
+    ) {
       // Found the 'package.json' file or 'node_modules' dir; we're done
-      return dir
+      return dir;
     }
     if (prev === dir) {
       // Got to the top
-      throw new Error('Could not find module root given file: "' + file
-                    + '". Do you have a `package.json` file? ')
+      throw new Error(
+        'Could not find module root given file: "' +
+          file +
+          '". Do you have a `package.json` file? '
+      );
     }
     // Try the parent dir next
-    prev = dir
-    dir = join(dir, '..')
+    prev = dir;
+    dir = join(dir, '..');
   }
-}
+};

package.json

@@ -10,7 +10,7 @@
     "c",
     "c++"
   ],
-  "version": "1.2.1",
+  "version": "1.5.0",
   "author": "Nathan Rajlich <nathan@tootallnate.net> (http://tootallnate.net)",
   "repository": {
     "type": "git",
@@ -21,5 +21,8 @@
     "url": "https://github.com/TooTallNate/node-bindings/issues"
   },
   "homepage": "https://github.com/TooTallNate/node-bindings",
-  "license": "MIT"
+  "license": "MIT",
+  "dependencies": {
+    "file-uri-to-path": "1.0.0"
+  }
 }