execjs-xtrn 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 6ea23f93401560e87c30a5e58f9b859021af74fe
+  data.tar.gz: ff537afc206da297fc767c8364605c64b4bb3822
+SHA512:
+  metadata.gz: 305a66d5d0f545b7e328715436436a2b32ed3a21a5363d5d67d1835b147f105e84005dda3a63e5f3a275a88c4bef07483c87ef91f3abb29aa8f0edde7ce8bb09
+  data.tar.gz: 6dd4f27cd97237f42e8fd6d2a98ba2ee6a700e8105be90066cc0cd7ca46eeadc79e2f8ae358599086d948a331f82407e9efcf4d8590d3728a0b23d383969492e

data/.gitignore

@@ -0,0 +1,18 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+node_modules

data/.travis.yml

@@ -0,0 +1,12 @@
+language: ruby
+rvm:
+  - 2.1.1
+  - 2.0.0
+  - 1.9.3
+  - 1.9.2
+before_install:
+  - sudo apt-get update -qq
+  - sudo apt-get install -y npm
+install:
+  - bundle install
+  - bundle exec rake npm

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in execjs-xtrn.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2014 Stas Ukolov
+
+MIT License
+
+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.

data/README.md

@@ -0,0 +1,171 @@
+# ExecJS::Xtrn
+
+[![Build Status](https://travis-ci.org/ukoloff/execjs-xtrn.svg?branch=master)](https://travis-ci.org/ukoloff/execjs-xtrn)
+[![Gem Version](https://badge.fury.io/rb/execjs-xtrn.svg)](http://badge.fury.io/rb/execjs-xtrn)
+
+Drop-in replacement for ExecJS. The latter spawns separate process for every JavaScript compilation
+(when using external runtime),
+while ExecJS::Xtrn spawn long running JavaScript process and communicates with it via stdin & stderr.
+
+This is just proof of concept, not suitable for production.
+
+When not on MS Windows, one definitely should use ExecJS with excellent `therubyracer` gem instead.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'execjs-xtrn'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install execjs-xtrn
+
+## Usage
+
+Just add/require this gem after/instead (implicit) `execjs` gem.
+The latter will be monkey-patched.
+
+## Engines
+
+ExecJS::Xtrn uses two external JavaScript runners:
+
+  * Windows Script Host
+  * Node.js in two modes:
+    - Simple (1 execution context = 1 external process)
+    - Nvm (all execution contexts share single external process using [vm API](http://nodejs.org/api/vm.html))
+
+So, there exist *four* engines:
+
+  * Engine - absctract engine (smart enough to execute blank lines)
+  * Wsh - engine using WSH (CScript)
+  * Node - engine using Node.js (separate process for every execution context)
+  * Nvm - engine using Node.js and vm API (single process)
+
+All engines autodetect their availability at startup (on `require 'execjs/xtrn'`) and sets `Valid` constants.
+Eg on MS Windows ExecJS::Xtrn::Wsh::Valid = true, on Linux - false
+
+One of available engines is made default engine for ExecJS.
+If Node.js is available it is Nvm.
+Else, if running on Windows it is Wsh.
+Else it is Engine, so ExecJS is made unusable.
+
+Default engine can be shown/changed at any moment with `ExecJS::Xtrn.engine` accessor, eg
+
+```ruby
+ExecJS::Xtrn.engine=ExecJS::Xtrn::Node
+```
+
+## API
+
+ExecJS::Xtrn is primarily designed to power other gems that use popular ExecJS.
+
+But it has his own API (similar to ExecJS' API) and can be used itself.
+
+In general one should create instance of an Engine and then feed it with JavaScript code:
+
+```ruby
+ctx=ExecJS::Xtrn::Wsh.new
+ctx.exec 'fact = function(n){return n>1 ? n*fact(n-1) : 1}'
+puts "10!=#{ctx.call 'fact', 10}"
+```
+Every execution context has three methods:
+  * exec('`code`') -  executes arbitrary JavaScript code. To get result `return` must be called.
+  * eval('`expression`') - evaluate JavaScript expression. `return` is not needed
+  * call(`function`, arguments...) - special form of eval for function call
+
+Engine class also has exec and eval methods, they just create brand new execution context,
+pass argument to it, destroy that context and return its result. Using these class methods
+is not recommended, since it's just what ExecJS does (except for Nvm engine).
+
+Engine class also has compile method that combines `new` and `exec` and returns execution context.
+This is how ExecJS is used in most cases.
+
+```ruby
+ctx=ExecJS::Xtrn::Wsh.compile 'fact = function(n){return n>1 ? n*fact(n-1) : 1}'
+puts "10!=#{ctx.call 'fact', 10}"
+```
+
+And finally ExecJS::Xtrn patches ExecJS and installs those 3 class methods (exec, eval, compile) in it.
+So, `ExecJS.compile` is `ExecJS::Xtrn::Nvm.compile` if Nvm engine is available.
+
+## Overriding ExecJS
+
+Sometimes ExecJS is required after ExecJS::Xtrn. In that case you can call ExecJS::Xtrn.init and
+it will overwrite ExecJS' methods again.
+
+To test whether JavaScript is served by ExecJS::Xtrn, it's convenient to look at ExecJS::Xtrn statistics.
+
+## Statistics
+
+Every engine gathers it's own usage statistics. Eg:
+
+```ruby
+> ExecJS::Xtrn::Node.stats # or ExecJS::Xtrn::Nvm.stats or ExecJS::Xtrn::Wsh.stats
+=> {:c=>2, :n=>2, :o=>8, :i=>6, :t=>0.131013}
+```
+Here:
+  * c = number of child processes spawned (for Nvm c should always be 1)
+  * n = number of request made
+  * o = bytes sent to child process(es)
+  * i = bytes got from child process(es)
+  * t = seconds spent communicating with child process(es)
+  * m = number of VMs created (Nvm only)
+  * x = number of VMs destroyed (Nvm only)
+
+ExecJS::Xtrn.stats combines statistics for all its engines, even unused.
+
+ExecJS.stats shows statistics for current engine only.
+
+Every execution context has his own statistics too. Eg
+
+```ruby
+s=ExecJS::Xtrn::Nvm.compile '...'
+s.exec '...'
+s.stats
+```
+but c (and m, x) fields are omitted there.
+
+## Compatibilty
+
+Not every JavaScript code behaves identically in ExecJS and ExecJS::Xtrn. In most cases it depends on how
+global JavaScript variables are used. For most modern code it is the same though.
+
+As a rule of thumb, JavaScript code must survive after wrapping in anonymous function (`(function(){...})()`).
+
+For instance, old versions of `handlebars_assets` didn't work
+in ExecJS::Xtrn (and worked in ExecJS).
+
+The following packages have been tested to run under ExecJS::Xtrn out-of-box:
+
+  * [CoffeeScript](http://coffeescript.org/) via [coffee-script](https://rubygems.org/gems/coffee-script) and [coffee-rails](https://rubygems.org/gems/coffee-rails) gems
+  * [UglifyJS2](https://github.com/mishoo/UglifyJS2) via [uglifier](https://github.com/lautis/uglifier)
+  * [Handlebars](http://handlebarsjs.com/) via [handlebars_assets](https://github.com/leshill/handlebars_assets) gem
+
+## Testing
+
+After git checkout, required NPM modules must be installed. Simply run:
+
+```
+bundle install
+bundle exec rake npm
+```
+
+The testing itself is
+
+```
+bundle exec rake
+```
+
+And `bundle exec` may be ommited in most cases.
+
+## Credits
+
+  * [ExecJS](https://github.com/sstephenson/execjs)
+  * [therubyracer](https://github.com/cowboyd/therubyracer)
+  * [Node.js](http://nodejs.org/)
+  * [Windows Script Host](http://en.wikipedia.org/wiki/Windows_Script_Host)

data/Rakefile

@@ -0,0 +1,17 @@
+require "bundler/gem_tasks"
+
+desc 'Install NPM modules'
+task :npm do
+  system "npm", "install", chdir: "lib/execjs/node"
+end
+
+desc 'Run tests'
+task :test do
+  require "minitest/autorun"
+
+  require 'execjs/xtrn'
+
+  Dir.glob('./test/*.rb'){|f| require f}
+end
+
+task default: :test

data/execjs-xtrn.gemspec

@@ -0,0 +1,27 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'execjs/xtrn/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "execjs-xtrn"
+  spec.version       = ExecJS::Xtrn::VERSION
+  spec.authors       = ["Stas Ukolov"]
+  spec.email         = ["ukoloff@gmail.com"]
+  spec.description   = "Drop-in replacement for ExecJS with persistent external runtime"
+  spec.summary       = "Proof-of-concept: make ExecJS fast even without therubyracer"
+  spec.homepage      = "https://github.com/ukoloff/execjs-xtrn"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files`.split($/)+
+                       Dir.glob('**/node_modules/*/*.js')
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.3"
+  spec.add_development_dependency "rake"
+  spec.add_development_dependency "minitest"
+  spec.add_development_dependency "coffee-script"
+  spec.add_development_dependency "uglifier"
+end

data/lib/execjs/node/index.js

@@ -0,0 +1,71 @@
+var
+  s=require('split'),
+  vm = require('vm'),
+  vms = {}
+
+process.stdin
+.pipe(s(cmd))
+.pipe(process.stderr)
+
+function cmd(s)
+{
+  return wrap(s)+'\n'
+}
+
+function wrap(s)
+{
+  try { s=compile(s) }
+  catch(e) { s={err: e.message || 'General error'} }
+
+  try { return JSON.stringify(s) }
+  catch(e) { return '{"err":"JSON.stringify error"}' }
+}
+
+function compile(s)
+{
+  s = JSON.parse(s)
+  if('object'==typeof s)
+    return vmCmd(s)
+  if('string'!=typeof s)
+    throw Error('String expected!')
+  return ok(new Function(s)())
+}
+
+function ok(v)
+{
+  return 'undefined'==typeof v ? {} : {ok: v}
+}
+
+function vmCmd(s)
+{
+  if(!('vm' in s))
+    throw Error('VM command expected!')
+  if('js' in s)
+    return vmEval(s)
+  if(!s.vm)
+    return {vm: vmNew()}
+  delete vms[s.vm]
+  return {}
+}
+
+function vmEval(s)
+{
+  var z = vms[s.vm]
+  if(!z)
+    throw Error('VM not found')
+  if('string'!=typeof s.js)
+    throw Error('String expected!')
+  return ok(vm.runInContext('new Function('+JSON.stringify(s.js)+')()', z))
+}
+
+function vmNew()
+{
+  var i, r
+  for(i = 10; i>0; i--)
+    if((r = /\d{3,}/.exec(Math.random())) && !vms[r = r[0]])
+    {
+      vms[r] = vm.createContext()
+      return r
+    }
+  throw Error('Cannot generate random number')
+}

data/lib/execjs/node/package.json

@@ -0,0 +1,6 @@
+{
+  "dependencies": {
+    "split": "^0.3.0",
+    "through": "^2.3.6"
+  }
+}

data/lib/execjs/wsh/json2.js

@@ -0,0 +1,481 @@
+/*
+    http://www.JSON.org/json2.js
+    2011-01-18
+
+    Public Domain.
+
+    NO WARRANTY EXPRESSED OR IMPLIED. USE AT YOUR OWN RISK.
+
+    See http://www.JSON.org/js.html
+
+
+    This code should be minified before deployment.
+    See http://javascript.crockford.com/jsmin.html
+
+    USE YOUR OWN COPY. IT IS EXTREMELY UNWISE TO LOAD CODE FROM SERVERS YOU DO
+    NOT CONTROL.
+
+
+    This file creates a global JSON object containing two methods: stringify
+    and parse.
+
+        JSON.stringify(value, replacer, space)
+            value       any JavaScript value, usually an object or array.
+
+            replacer    an optional parameter that determines how object
+                        values are stringified for objects. It can be a
+                        function or an array of strings.
+
+            space       an optional parameter that specifies the indentation
+                        of nested structures. If it is omitted, the text will
+                        be packed without extra whitespace. If it is a number,
+                        it will specify the number of spaces to indent at each
+                        level. If it is a string (such as '\t' or ' '),
+                        it contains the characters used to indent at each level.
+
+            This method produces a JSON text from a JavaScript value.
+
+            When an object value is found, if the object contains a toJSON
+            method, its toJSON method will be called and the result will be
+            stringified. A toJSON method does not serialize: it returns the
+            value represented by the name/value pair that should be serialized,
+            or undefined if nothing should be serialized. The toJSON method
+            will be passed the key associated with the value, and this will be
+            bound to the value
+
+            For example, this would serialize Dates as ISO strings.
+
+                Date.prototype.toJSON = function (key) {
+                    function f(n) {
+                        // Format integers to have at least two digits.
+                        return n < 10 ? '0' + n : n;
+                    }
+
+                    return this.getUTCFullYear()   + '-' +
+                         f(this.getUTCMonth() + 1) + '-' +
+                         f(this.getUTCDate())      + 'T' +
+                         f(this.getUTCHours())     + ':' +
+                         f(this.getUTCMinutes())   + ':' +
+                         f(this.getUTCSeconds())   + 'Z';
+                };
+
+            You can provide an optional replacer method. It will be passed the
+            key and value of each member, with this bound to the containing
+            object. The value that is returned from your method will be
+            serialized. If your method returns undefined, then the member will
+            be excluded from the serialization.
+
+            If the replacer parameter is an array of strings, then it will be
+            used to select the members to be serialized. It filters the results
+            such that only members with keys listed in the replacer array are
+            stringified.
+
+            Values that do not have JSON representations, such as undefined or
+            functions, will not be serialized. Such values in objects will be
+            dropped; in arrays they will be replaced with null. You can use
+            a replacer function to replace those with JSON values.
+            JSON.stringify(undefined) returns undefined.
+
+            The optional space parameter produces a stringification of the
+            value that is filled with line breaks and indentation to make it
+            easier to read.
+
+            If the space parameter is a non-empty string, then that string will
+            be used for indentation. If the space parameter is a number, then
+            the indentation will be that many spaces.
+
+            Example:
+
+            text = JSON.stringify(['e', {pluribus: 'unum'}]);
+            // text is '["e",{"pluribus":"unum"}]'
+
+
+            text = JSON.stringify(['e', {pluribus: 'unum'}], null, '\t');
+            // text is '[\n\t"e",\n\t{\n\t\t"pluribus": "unum"\n\t}\n]'
+
+            text = JSON.stringify([new Date()], function (key, value) {
+                return this[key] instanceof Date ?
+                    'Date(' + this[key] + ')' : value;
+            });
+            // text is '["Date(---current time---)"]'
+
+
+        JSON.parse(text, reviver)
+            This method parses a JSON text to produce an object or array.
+            It can throw a SyntaxError exception.
+
+            The optional reviver parameter is a function that can filter and
+            transform the results. It receives each of the keys and values,
+            and its return value is used instead of the original value.
+            If it returns what it received, then the structure is not modified.
+            If it returns undefined then the member is deleted.
+
+            Example:
+
+            // Parse the text. Values that look like ISO date strings will
+            // be converted to Date objects.
+
+            myData = JSON.parse(text, function (key, value) {
+                var a;
+                if (typeof value === 'string') {
+                    a =
+/^(\d{4})-(\d{2})-(\d{2})T(\d{2}):(\d{2}):(\d{2}(?:\.\d*)?)Z$/.exec(value);
+                    if (a) {
+                        return new Date(Date.UTC(+a[1], +a[2] - 1, +a[3], +a[4],
+                            +a[5], +a[6]));
+                    }
+                }
+                return value;
+            });
+
+            myData = JSON.parse('["Date(09/09/2001)"]', function (key, value) {
+                var d;
+                if (typeof value === 'string' &&
+                        value.slice(0, 5) === 'Date(' &&
+                        value.slice(-1) === ')') {
+                    d = new Date(value.slice(5, -1));
+                    if (d) {
+                        return d;
+                    }
+                }
+                return value;
+            });
+
+
+    This is a reference implementation. You are free to copy, modify, or
+    redistribute.
+*/
+
+/*jslint evil: true, strict: false, regexp: false */
+
+/*members "", "\b", "\t", "\n", "\f", "\r", "\"", JSON, "\\", apply,
+    call, charCodeAt, getUTCDate, getUTCFullYear, getUTCHours,
+    getUTCMinutes, getUTCMonth, getUTCSeconds, hasOwnProperty, join,
+    lastIndex, length, parse, prototype, push, replace, slice, stringify,
+    test, toJSON, toString, valueOf
+*/
+
+
+// Create a JSON object only if one does not already exist. We create the
+// methods in a closure to avoid creating global variables.
+
+(function (global) {
+    if (!global.JSON) {
+        global.JSON = {};
+    }
+
+    var JSON = global.JSON;
+
+    "use strict";
+
+    function f(n) {
+        // Format integers to have at least two digits.
+        return n < 10 ? '0' + n : n;
+    }
+
+    if (typeof Date.prototype.toJSON !== 'function') {
+
+        Date.prototype.toJSON = function (key) {
+
+            return isFinite(this.valueOf()) ?
+                this.getUTCFullYear()     + '-' +
+                f(this.getUTCMonth() + 1) + '-' +
+                f(this.getUTCDate())      + 'T' +
+                f(this.getUTCHours())     + ':' +
+                f(this.getUTCMinutes())   + ':' +
+                f(this.getUTCSeconds())   + 'Z' : null;
+        };
+
+        String.prototype.toJSON      =
+            Number.prototype.toJSON  =
+            Boolean.prototype.toJSON = function (key) {
+                return this.valueOf();
+            };
+    }
+
+    var cx = /[\u0000\u00ad\u0600-\u0604\u070f\u17b4\u17b5\u200c-\u200f\u2028-\u202f\u2060-\u206f\ufeff\ufff0-\uffff]/g,
+        escapable = /[\\\"\x00-\x1f\x7f-\x9f\u00ad\u0600-\u0604\u070f\u17b4\u17b5\u200c-\u200f\u2028-\u202f\u2060-\u206f\ufeff\ufff0-\uffff]/g,
+        gap,
+        indent,
+        meta = {    // table of character substitutions
+            '\b': '\\b',
+            '\t': '\\t',
+            '\n': '\\n',
+            '\f': '\\f',
+            '\r': '\\r',
+            '"' : '\\"',
+            '\\': '\\\\'
+        },
+        rep;
+
+
+    function quote(string) {
+
+// If the string contains no control characters, no quote characters, and no
+// backslash characters, then we can safely slap some quotes around it.
+// Otherwise we must also replace the offending characters with safe escape
+// sequences.
+
+        escapable.lastIndex = 0;
+        return escapable.test(string) ? '"' + string.replace(escapable, function (a) {
+            var c = meta[a];
+            return typeof c === 'string' ? c :
+                '\\u' + ('0000' + a.charCodeAt(0).toString(16)).slice(-4);
+        }) + '"' : '"' + string + '"';
+    }
+
+
+    function str(key, holder) {
+
+// Produce a string from holder[key].
+
+        var i,          // The loop counter.
+            k,          // The member key.
+            v,          // The member value.
+            length,
+            mind = gap,
+            partial,
+            value = holder[key];
+
+// If the value has a toJSON method, call it to obtain a replacement value.
+
+        if (value && typeof value === 'object' &&
+                typeof value.toJSON === 'function') {
+            value = value.toJSON(key);
+        }
+
+// If we were called with a replacer function, then call the replacer to
+// obtain a replacement value.
+
+        if (typeof rep === 'function') {
+            value = rep.call(holder, key, value);
+        }
+
+// What happens next depends on the value's type.
+
+        switch (typeof value) {
+        case 'string':
+            return quote(value);
+
+        case 'number':
+
+// JSON numbers must be finite. Encode non-finite numbers as null.
+
+            return isFinite(value) ? String(value) : 'null';
+
+        case 'boolean':
+        case 'null':
+
+// If the value is a boolean or null, convert it to a string. Note:
+// typeof null does not produce 'null'. The case is included here in
+// the remote chance that this gets fixed someday.
+
+            return String(value);
+
+// If the type is 'object', we might be dealing with an object or an array or
+// null.
+
+        case 'object':
+
+// Due to a specification blunder in ECMAScript, typeof null is 'object',
+// so watch out for that case.
+
+            if (!value) {
+                return 'null';
+            }
+
+// Make an array to hold the partial results of stringifying this object value.
+
+            gap += indent;
+            partial = [];
+
+// Is the value an array?
+
+            if (Object.prototype.toString.apply(value) === '[object Array]') {
+
+// The value is an array. Stringify every element. Use null as a placeholder
+// for non-JSON values.
+
+                length = value.length;
+                for (i = 0; i < length; i += 1) {
+                    partial[i] = str(i, value) || 'null';
+                }
+
+// Join all of the elements together, separated with commas, and wrap them in
+// brackets.
+
+                v = partial.length === 0 ? '[]' : gap ?
+                    '[\n' + gap + partial.join(',\n' + gap) + '\n' + mind + ']' :
+                    '[' + partial.join(',') + ']';
+                gap = mind;
+                return v;
+            }
+
+// If the replacer is an array, use it to select the members to be stringified.
+
+            if (rep && typeof rep === 'object') {
+                length = rep.length;
+                for (i = 0; i < length; i += 1) {
+                    k = rep[i];
+                    if (typeof k === 'string') {
+                        v = str(k, value);
+                        if (v) {
+                            partial.push(quote(k) + (gap ? ': ' : ':') + v);
+                        }
+                    }
+                }
+            } else {
+
+// Otherwise, iterate through all of the keys in the object.
+
+                for (k in value) {
+                    if (Object.hasOwnProperty.call(value, k)) {
+                        v = str(k, value);
+                        if (v) {
+                            partial.push(quote(k) + (gap ? ': ' : ':') + v);
+                        }
+                    }
+                }
+            }
+
+// Join all of the member texts together, separated with commas,
+// and wrap them in braces.
+
+            v = partial.length === 0 ? '{}' : gap ?
+                '{\n' + gap + partial.join(',\n' + gap) + '\n' + mind + '}' :
+                '{' + partial.join(',') + '}';
+            gap = mind;
+            return v;
+        }
+    }
+
+// If the JSON object does not yet have a stringify method, give it one.
+
+    if (typeof JSON.stringify !== 'function') {
+        JSON.stringify = function (value, replacer, space) {
+
+// The stringify method takes a value and an optional replacer, and an optional
+// space parameter, and returns a JSON text. The replacer can be a function
+// that can replace values, or an array of strings that will select the keys.
+// A default replacer method can be provided. Use of the space parameter can
+// produce text that is more easily readable.
+
+            var i;
+            gap = '';
+            indent = '';
+
+// If the space parameter is a number, make an indent string containing that
+// many spaces.
+
+            if (typeof space === 'number') {
+                for (i = 0; i < space; i += 1) {
+                    indent += ' ';
+                }
+
+// If the space parameter is a string, it will be used as the indent string.
+
+            } else if (typeof space === 'string') {
+                indent = space;
+            }
+
+// If there is a replacer, it must be a function or an array.
+// Otherwise, throw an error.
+
+            rep = replacer;
+            if (replacer && typeof replacer !== 'function' &&
+                    (typeof replacer !== 'object' ||
+                    typeof replacer.length !== 'number')) {
+                throw new Error('JSON.stringify');
+            }
+
+// Make a fake root object containing our value under the key of ''.
+// Return the result of stringifying the value.
+
+            return str('', {'': value});
+        };
+    }
+
+
+// If the JSON object does not yet have a parse method, give it one.
+
+    if (typeof JSON.parse !== 'function') {
+        JSON.parse = function (text, reviver) {
+
+// The parse method takes a text and an optional reviver function, and returns
+// a JavaScript value if the text is a valid JSON text.
+
+            var j;
+
+            function walk(holder, key) {
+
+// The walk method is used to recursively walk the resulting structure so
+// that modifications can be made.
+
+                var k, v, value = holder[key];
+                if (value && typeof value === 'object') {
+                    for (k in value) {
+                        if (Object.hasOwnProperty.call(value, k)) {
+                            v = walk(value, k);
+                            if (v !== undefined) {
+                                value[k] = v;
+                            } else {
+                                delete value[k];
+                            }
+                        }
+                    }
+                }
+                return reviver.call(holder, key, value);
+            }
+
+
+// Parsing happens in four stages. In the first stage, we replace certain
+// Unicode characters with escape sequences. JavaScript handles many characters
+// incorrectly, either silently deleting them, or treating them as line endings.
+
+            text = String(text);
+            cx.lastIndex = 0;
+            if (cx.test(text)) {
+                text = text.replace(cx, function (a) {
+                    return '\\u' +
+                        ('0000' + a.charCodeAt(0).toString(16)).slice(-4);
+                });
+            }
+
+// In the second stage, we run the text against regular expressions that look
+// for non-JSON patterns. We are especially concerned with '()' and 'new'
+// because they can cause invocation, and '=' because it can cause mutation.
+// But just to be safe, we want to reject all unexpected forms.
+
+// We split the second stage into 4 regexp operations in order to work around
+// crippling inefficiencies in IE's and Safari's regexp engines. First we
+// replace the JSON backslash pairs with '@' (a non-JSON character). Second, we
+// replace all simple value tokens with ']' characters. Third, we delete all
+// open brackets that follow a colon or comma or that begin the text. Finally,
+// we look to see that the remaining characters are only whitespace or ']' or
+// ',' or ':' or '{' or '}'. If that is so, then the text is safe for eval.
+
+            if (/^[\],:{}\s]*$/
+                    .test(text.replace(/\\(?:["\\\/bfnrt]|u[0-9a-fA-F]{4})/g, '@')
+                        .replace(/"[^"\\\n\r]*"|true|false|null|-?\d+(?:\.\d*)?(?:[eE][+\-]?\d+)?/g, ']')
+                        .replace(/(?:^|:|,)(?:\s*\[)+/g, ''))) {
+
+// In the third stage we use the eval function to compile the text into a
+// JavaScript structure. The '{' operator is subject to a syntactic ambiguity
+// in JavaScript: it can begin a block or an object literal. We wrap the text
+// in parens to eliminate the ambiguity.
+
+                j = eval('(' + text + ')');
+
+// In the optional fourth stage, we recursively walk the new structure, passing
+// each name/value pair to a reviver function for possible transformation.
+
+                return typeof reviver === 'function' ?
+                    walk({'': j}, '') : j;
+            }
+
+// If the text is not JSON parseable, then a SyntaxError is thrown.
+
+            throw new SyntaxError('JSON.parse');
+        };
+    }
+}(this));