Remove use of global process.sass

This replaces the global `process.sass` with proper module exports.
Unfortunately `process.sass`, although undocumented, is available
to other modules. This patch keeps the existing public API available
until we bump the major.

bin/node-sass

@@ -8,6 +8,7 @@ var Emitter = require('events').EventEmitter,
     util = require('util'),
     path = require('path'),
     glob = require('glob'),
+    sass = require('../lib'),
     render = require('../lib/render'),
     stdin = require('get-stdin'),
     fs = require('fs');
@@ -18,7 +19,7 @@ var Emitter = require('events').EventEmitter,
 
 var cli = meow({
   pkg: '../package.json',
-  version: process.sass.versionInfo,
+  version: sass.info,
   help: [
     'Usage:',
     '  node-sass [options] <input.scss>',

lib/extensions.js

@@ -2,27 +2,28 @@
  * node-sass: lib/extensions.js
  */
 
-var flags = {},
+var eol = require('os').EOL,
     fs = require('fs'),
     pkg = require('../package.json'),
     path = require('path');
 
 /**
- * Collect Arguments
+ * Get the value of a CLI argument
  *
+ * @param {String} name
  * @param {Array} args
  * @api private
  */
 
-function collectArguments(args) {
-  for (var i = 0; i < args.length; i += 2) {
-    if (args[i].lastIndexOf('--', 0) !== 0) {
-      --i;
-      continue;
-    }
+function getArgument(name, args) {
+  var flags = args || process.argv.slice(2),
+      index = flags.lastIndexOf(name);
 
-    flags[args[i]] = args[i + 1];
+  if (index === -1 || index + 1 >= flags.length) {
+    return null;
   }
+
+  return flags[index + 1];
 }
 
 /**
@@ -33,14 +34,14 @@ function collectArguments(args) {
  * return it as is, otherwise make default binary
  * name: {platform}-{arch}-{v8 version}.node
  *
- * @api private
+ * @api public
  */
 
 function getBinaryName() {
   var binaryName;
 
-  if (flags['--sass-binary-name']) {
-    binaryName = flags['--sass-binary-name'];
+  if (getArgument('--sass-binary-name')) {
+    binaryName = getArgument('--sass-binary-name');
   } else if (process.env.SASS_BINARY_NAME) {
     binaryName = process.env.SASS_BINARY_NAME;
   } else if (process.env.npm_config_sass_binary_name) {
@@ -63,7 +64,7 @@ function getBinaryName() {
  *
  * The default URL can be overriden using
  * the environment variable SASS_BINARY_SITE,
-* .npmrc variable sass_binary_site or
+ * .npmrc variable sass_binary_site or
  * or a command line option --sass-binary-site:
  *
  *   node scripts/install.js --sass-binary-site http://example.com/
@@ -81,27 +82,19 @@ function getBinaryName() {
  *  v3.0.0/freebsd-x64-42_binding.node
  *  ... etc. for all supported versions and platforms
  *
- * @api private
+ * @api public
  */
 
 function getBinaryUrl() {
-  var site = flags['--sass-binary-site'] ||
+  var site = getArgument('--sass-binary-site') ||
              process.env.SASS_BINARY_SITE  ||
              process.env.npm_config_sass_binary_site ||
              (pkg.nodeSassConfig && pkg.nodeSassConfig.binarySite) ||
              'https://github.com/sass/node-sass/releases/download';
 
-	return [site, 'v' + pkg.version, sass.binaryName].join('/');
+	return [site, 'v' + pkg.version, getBinaryName()].join('/');
 }
 
-
-collectArguments(process.argv.slice(2));
-
-var sass = process.sass = {};
-
-sass.binaryName = getBinaryName();
-sass.binaryUrl = getBinaryUrl();
-
 /**
  * Get binary path.
  * If environment variable SASS_BINARY_PATH,
@@ -114,14 +107,14 @@ sass.binaryUrl = getBinaryUrl();
  * returning.
  *
  * @param {Boolean} throwIfNotExists
- * @api private
+ * @api public
  */
 
-sass.getBinaryPath = function(throwIfNotExists) {
+function getBinaryPath(throwIfNotExists) {
   var binaryPath;
 
-  if (flags['--sass-binary-path']) {
-    binaryPath = flags['--sass-binary-path'];
+  if (getArgument('--sass-binary-path')) {
+    binaryPath = getArgument('--sass-binary-path');
   } else if (process.env.SASS_BINARY_PATH) {
     binaryPath = process.env.SASS_BINARY_PATH;
   } else if (process.env.npm_config_sass_binary_path) {
@@ -129,7 +122,7 @@ sass.getBinaryPath = function(throwIfNotExists) {
   } else if (pkg.nodeSassConfig && pkg.nodeSassConfig.binaryPath) {
     binaryPath = pkg.nodeSassConfig.binaryPath;
   } else {
-    binaryPath = path.join(__dirname, '..', 'vendor', sass.binaryName.replace(/_/, '/'));
+    binaryPath = path.join(__dirname, '..', 'vendor', getBinaryName().replace(/_/, '/'));
   }
 
   if (!fs.existsSync(binaryPath) && throwIfNotExists) {
@@ -141,6 +134,22 @@ sass.getBinaryPath = function(throwIfNotExists) {
   }
 
   return binaryPath;
-};
+}
+
+/**
+ * Get Sass version information
+ *
+ * @api public
+ */
+
+function getVersionInfo(binding) {
+  return [
+           ['node-sass', pkg.version, '(Wrapper)', '[JavaScript]'].join('\t'),
+           ['libsass  ', binding.libsassVersion(), '(Sass Compiler)', '[C/C++]'].join('\t'),
+  ].join(eol);
+}
 
-sass.binaryPath = sass.getBinaryPath();
+module.exports.getBinaryUrl = getBinaryUrl;
+module.exports.getBinaryName = getBinaryName;
+module.exports.getBinaryPath = getBinaryPath;
+module.exports.getVersionInfo = getVersionInfo;

lib/index.js

@@ -2,31 +2,15 @@
  * node-sass: lib/index.js
  */
 
-var eol = require('os').EOL,
-    path = require('path'),
+var path = require('path'),
     util = require('util'),
-    pkg = require('../package.json');
-
-require('./extensions');
+    sass = require('./extensions');
 
 /**
  * Require binding
  */
 
-var binding = require(process.sass.getBinaryPath(true));
-
-/**
- * Get Sass version information
- *
- * @api private
- */
-
-function getVersionInfo(binding) {
-  return [
-           ['node-sass', pkg.version, '(Wrapper)', '[JavaScript]'].join('\t'),
-           ['libsass  ', binding.libsassVersion(), '(Sass Compiler)', '[C/C++]'].join('\t'),
-  ].join(eol);
-}
+var binding = require(sass.getBinaryPath(true));
 
 /**
  * Get input file
@@ -430,8 +414,7 @@ module.exports.renderSync = function(options) {
  * @api public
  */
 
-process.sass.versionInfo = getVersionInfo(binding);
-module.exports.info = process.sass.versionInfo;
+module.exports.info = sass.getVersionInfo(binding);
 
 /**
  * Expose sass types

scripts/build.js

@@ -7,9 +7,8 @@ var eol = require('os').EOL,
     fs = require('fs'),
     mkdir = require('mkdirp'),
     path = require('path'),
-    spawn = require('cross-spawn-async');
-
-require('../lib/extensions');
+    spawn = require('cross-spawn-async'),
+    sass = require('../lib/extensions');
 
 /**
  * After build
@@ -19,7 +18,7 @@ require('../lib/extensions');
  */
 
 function afterBuild(options) {
-  var install = process.sass.binaryPath;
+  var install = sass.getBinaryPath();
   var target = path.join(__dirname, '..', 'build',
     options.debug ? 'Debug' : process.config.target_defaults.default_configuration,
     'binding.node');
@@ -197,13 +196,11 @@ function testBinary(options) {
     return build(options);
   }
 
-  try {
-    process.sass.getBinaryPath(true);
-  } catch (e) {
+  if (!sass.getBinaryPath()) {
     return build(options);
   }
 
-  console.log('`', process.sass.binaryPath, '` exists.', eol, 'testing binary.');
+  console.log('`', sass.getBinaryPath(), '` exists.', eol, 'testing binary.');
 
   try {
     require('../').renderSync({

scripts/install.js

@@ -7,9 +7,8 @@ var fs = require('fs'),
     mkdir = require('mkdirp'),
     path = require('path'),
     got = require('got'),
-    pkg = require('../package.json');
-
-require('../lib/extensions');
+    pkg = require('../package.json'),
+    sass = require('../lib/extensions');
 
 /**
  * Download file, if succeeds save, if not delete
@@ -82,24 +81,23 @@ function applyProxy(options, cb) {
  */
 
 function checkAndDownloadBinary() {
-  try {
-    process.sass.getBinaryPath(true);
+  if (sass.getBinaryPath()) {
     return;
-  } catch (e) { }
+  }
 
-  mkdir(path.dirname(process.sass.binaryPath), function(err) {
+  mkdir(path.dirname(sass.getBinaryPath()), function(err) {
     if (err) {
       console.error(err);
       return;
     }
 
-    download(process.sass.binaryUrl, process.sass.binaryPath, function(err) {
+    download(sass.getBinaryUrl(), sass.getBinaryPath(), function(err) {
       if (err) {
         console.error(err);
         return;
       }
 
-      console.log('Binary downloaded and installed at', process.sass.binaryPath);
+      console.log('Binary downloaded and installed at', sass.binaryPath());
     });
   });
 }

test/lowlevel.js

 process.env.NODESASS_COV ? require('../lib-cov') : require('../lib');
 
 var assert = require('assert'),
-    binding = require(process.sass.binaryPath);
+    sass = require('../lib/extensions'),
+    binding = require(sass.getBinaryPath());
 
 describe('lowlevel', function() {
   it('fail with options not an object', function(done) {

test/runtime.js

 var assert = require('assert'),
-    fs = require('fs');
+    fs = require('fs'),
+    extensionsPath = process.env.NODESASS_COV
+      ? require.resolve('../lib-cov/extensions')
+      : require.resolve('../lib/extensions');
 
 describe('runtime parameters', function() {
     var packagePath = require.resolve('../package'),
-        extensionsPath = process.env.NODESASS_COV
-          ? require.resolve('../lib-cov/extensions')
-          : require.resolve('../lib/extensions'),
         // Let's use JSON to fake a deep copy
         savedArgv = JSON.stringify(process.argv),
         savedEnv = JSON.stringify(process.env);
@@ -21,7 +21,6 @@ describe('runtime parameters', function() {
       process.argv = JSON.parse(savedArgv);
       process.env = JSON.parse(savedEnv);
       require(packagePath);
-      require(extensionsPath);
     });
 
     describe('configuration precedence should be respected', function() {
@@ -35,29 +34,29 @@ describe('runtime parameters', function() {
         });
 
         it('command line argument', function() {
-          require(extensionsPath);
-          assert.equal(process.sass.binaryName, 'aaa_binding.node');
+          var sass = require(extensionsPath);
+          assert.equal(sass.getBinaryName(), 'aaa_binding.node');
         });
 
         it('environment variable', function() {
           process.argv = [];
-          require(extensionsPath);
-          assert.equal(process.sass.binaryName, 'bbb_binding.node');
+          var sass = require(extensionsPath);
+          assert.equal(sass.getBinaryName(), 'bbb_binding.node');
         });
 
         it('npm config variable', function() {
           process.argv = [];
           process.env.SASS_BINARY_NAME = null;
-          require(extensionsPath);
-          assert.equal(process.sass.binaryName, 'ccc_binding.node');
+          var sass = require(extensionsPath);
+          assert.equal(sass.getBinaryName(), 'ccc_binding.node');
         });
 
         it('package.json', function() {
           process.argv = [];
           process.env.SASS_BINARY_NAME = null;
           process.env.npm_config_sass_binary_name = null;
-          require(extensionsPath);
-          assert.equal(process.sass.binaryName, 'ddd_binding.node');
+          var sass = require(extensionsPath);
+          assert.equal(sass.getBinaryName(), 'ddd_binding.node');
         });
       });
 
@@ -70,33 +69,33 @@ describe('runtime parameters', function() {
         });
 
         it('command line argument', function() {
-          require(extensionsPath);
+          var sass = require(extensionsPath);
           var URL = 'http://aaa.example.com:9999';
-          assert.equal(process.sass.binaryUrl.substr(0, URL.length), URL);
+          assert.equal(sass.getBinaryUrl().substr(0, URL.length), URL);
         });
 
         it('environment variable', function() {
           process.argv = [];
-          require(extensionsPath);
+          var sass = require(extensionsPath);
           var URL = 'http://bbb.example.com:8888';
-          assert.equal(process.sass.binaryUrl.substr(0, URL.length), URL);
+          assert.equal(sass.getBinaryUrl().substr(0, URL.length), URL);
         });
 
         it('npm config variable', function() {
           process.argv = [];
           process.env.SASS_BINARY_SITE = null;
-          require(extensionsPath);
+          var sass = require(extensionsPath);
           var URL = 'http://ccc.example.com:7777';
-          assert.equal(process.sass.binaryUrl.substr(0, URL.length), URL);
+          assert.equal(sass.getBinaryUrl().substr(0, URL.length), URL);
         });
 
         it('package.json', function() {
           process.argv = [];
           process.env.SASS_BINARY_SITE = null;
           process.env.npm_config_sass_binary_site = null;
-          require(extensionsPath);
+          var sass = require(extensionsPath);
           var URL = 'http://ddd.example.com:6666';
-          assert.equal(process.sass.binaryUrl.substr(0, URL.length), URL);
+          assert.equal(sass.getBinaryUrl().substr(0, URL.length), URL);
         });
       });
 
@@ -109,29 +108,29 @@ describe('runtime parameters', function() {
         });
 
         it('command line argument', function() {
-          require(extensionsPath);
-          assert.equal(process.sass.binaryPath, 'aaa_binding.node');
+          var sass = require(extensionsPath);
+          assert.equal(sass.getBinaryPath(), 'aaa_binding.node');
         });
 
         it('environment variable', function() {
           process.argv = [];
-          require(extensionsPath);
-          assert.equal(process.sass.binaryPath, 'bbb_binding.node');
+          var sass = require(extensionsPath);
+          assert.equal(sass.getBinaryPath(), 'bbb_binding.node');
         });
 
         it('npm config variable', function() {
           process.argv = [];
           process.env.SASS_BINARY_PATH = null;
-          require(extensionsPath);
-          assert.equal(process.sass.binaryPath, 'ccc_binding.node');
+          var sass = require(extensionsPath);
+          assert.equal(sass.getBinaryPath(), 'ccc_binding.node');
         });
 
         it('package.json', function() {
           process.argv = [];
           process.env.SASS_BINARY_PATH = null;
           process.env.npm_config_sass_binary_path = null;
-          require(extensionsPath);
-          assert.equal(process.sass.binaryPath, 'ddd_binding.node');
+          var sass = require(extensionsPath);
+          assert.equal(sass.getBinaryPath(), 'ddd_binding.node');
         });
       });
 
@@ -140,12 +139,13 @@ describe('runtime parameters', function() {
 
 describe('library detection', function() {
   it('should throw error when libsass binary is missing.', function() {
-    var originalBin = process.sass.binaryPath,
+    var sass = require(extensionsPath),
+        originalBin = sass.getBinaryPath(),
         renamedBin = [originalBin, '_moved'].join('');
 
     assert.throws(function() {
       fs.renameSync(originalBin, renamedBin);
-      process.sass.getBinaryPath(true);
+      sass.getBinaryPath(true);
     }, /The `libsass` binding was not found/);
 
     fs.renameSync(renamedBin, originalBin);