dripdrop 0.6.0 → 0.7.1

data/spec/node/nodelet_spec.rb

@@ -1,28 +1,26 @@
 require 'spec_helper'
 
 describe "nodelets" do
+  class SpecialNodelet < DripDrop::Node::Nodelet
+    def action
+      route :worker1,     :zmq_pull, distributor_output.address, :connect
+      route :worker2,     :zmq_pull, distributor_output.address, :connect
+    end
+  end
+  
   before(:all) do
     nodelets = {}
     
+    
     @node = run_reactor do
-      routes_for :distributor do
-        route :output, :zmq_push, rand_addr, :bind
-      end
-      routes_for :worker_cluster do
-        route :worker1,     :zmq_pull, distributor_output.address, :connect
-        route :worker2,     :zmq_pull, distributor_output.address, :connect
-      end
-      
-      nodelet :distributor do |d|
-        nodelets[:distributor] = d
+      nodelet :distributor do |nlet|
+        nlet.route :output, :zmq_push, rand_addr, :bind
       end
       
-      nodelet :worker_cluster do |wc|
-        nodelets[:worker_cluster] = wc
-      end
+      nodelet :worker_cluster, SpecialNodelet
     end
     
-    @nodelets = nodelets
+    @nodelets = @node.nodelets
   end
   
   it "should create the nodelets" do
@@ -31,7 +29,7 @@ describe "nodelets" do
   
   it "should pass a DripDrop::Node::Nodelet to the block" do
     @nodelets.values.each do |nlet|
-      nlet.should be_instance_of(DripDrop::Node::Nodelet)
+      nlet.should be_kind_of(DripDrop::Node::Nodelet)
     end
   end
     
@@ -43,6 +41,18 @@ describe "nodelets" do
     end
   end
   
+  it "should use the class SpecialNodelet for the nodelet assigned that" do
+    @nodelets[:worker_cluster].should be_a(SpecialNodelet)
+  end
+
+  it "should return a DripDrop::Handler for short routes" do
+    @nodelets[:distributor].send(:output).should be_a(DripDrop::BaseHandler)
+  end
+
+  it "should return a DripDrop::Handler for long routes" do
+    @nodelets[:distributor].send(:distributor_output).should be_a(DripDrop::BaseHandler)
+  end
+  
   it "should define prefix-less versions of nodelet specific routes" do
     {
       @nodelets[:worker_cluster] => {:worker1 => :worker_cluster_worker1, 

data/spec/node/routing_spec.rb

@@ -53,12 +53,12 @@ describe "routing" do
         :worker_cluster_worker2 => {:class => DripDrop::ZMQPullHandler, :socket_ctype => :connect}
       }
       @node = run_reactor do
-        routes_for :distributor do
-          route :output, :zmq_push, rand_addr, :bind
+        nodelet :distributor do |nlet|
+          nlet.route :output, :zmq_push, rand_addr, :bind
         end
-        routes_for :worker_cluster do
-          route :worker1,     :zmq_pull, distributor_output.address, :connect
-          route :worker2,     :zmq_pull, distributor_output.address, :connect
+        nodelet :worker_cluster do |nlet|
+          nlet.route :worker1,     :zmq_pull, distributor_output.address, :connect
+          nlet.route :worker2,     :zmq_pull, distributor_output.address, :connect
         end
       end
     end

data/spec/node/websocket_spec.rb

@@ -24,7 +24,7 @@ describe "websockets" do
         conn.send_message(message)
       end.on_close do |conn|
         close_occured = true
-      end.on_error do |conn|
+      end.on_error do |reason,conn|
         error_occured = true
       end
       

data/spec/node_spec.rb

@@ -1,15 +1,7 @@
 require 'spec_helper'
 
 describe DripDrop::Node do
-  describe "initialization" do
-    before(:all) do
-      @ddn = DripDrop::Node.new {
-        zmq_subscribe(rand_addr,:bind) #Keeps ZMQMachine Happy
-      }
-      @ddn.start
-      sleep 1
-    end
-    
+  shared_examples_for "all initialization methods" do
     it "should start EventMachine" do
       EM.reactor_running?.should be_true
     end
@@ -19,11 +11,49 @@ describe DripDrop::Node do
       @ddn.zm_reactor.running?.should be_true
     end
     
-    after do
-      @ddn.stop rescue nil
+    it "should run the block" do
+      @reactor_ran.should be_true
     end
   end
+ 
+  #These tests break all subsequent ones,
+  #so require a special flag to test them
+  if ENV['DRIPDROP_INITSPEC'] == 'true'
+    describe "initialization with a block" do
+      before(:all) do
+        reactor_ran = false
+        @ddn = DripDrop::Node.new do
+          reactor_ran = true
+        end
+        @ddn.start
+        sleep 1
+          
+        @reactor_ran = reactor_ran
+      end
+      
+      it_should_behave_like "all initialization methods"
+    end
 
+    describe "initialization as a class" do
+      before(:all) do
+        class InitializationTest < DripDrop::Node
+          attr_accessor :reactor_ran
+          def action
+            @reactor_ran = true
+          end
+        end
+        
+        @ddn = InitializationTest.new
+        @ddn.start
+        sleep 1
+          
+        @reactor_ran = @ddn.reactor_ran 
+      end
+      
+      it_should_behave_like "all initialization methods"
+    end
+  end
+  
   describe "shutdown" do
     before do
       @ddn = DripDrop::Node.new {
@@ -43,4 +73,18 @@ describe DripDrop::Node do
       @ddn.zm_reactor.running?.should be_false
     end
   end
+
+  describe "exceptions in EM reactor" do
+    class TestException < StandardError; end
+     
+    it "should rescue exceptions in the EM reactor" do
+      expectations = an_instance_of(TestException)
+      reactor = run_reactor do
+        self.should_receive(:error_handler).with(expectations)
+        EM.next_tick do
+          raise TestException, "foo"
+        end
+      end
+    end
+  end
 end

data/spec/spec_helper.rb

@@ -8,7 +8,7 @@ def rand_addr(scheme='tcp')
   "#{scheme}://127.0.0.1:#{rand(10_000) + 20_000}"
 end
 
-def run_reactor(time=0.1,opts={},&block)
+def run_reactor(time=0.2,opts={},&block)
   ddn = DripDrop::Node.new(opts,&block)
   ddn.start
   sleep time

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: dripdrop
 version: !ruby/object:Gem::Version 
-  hash: 7
+  hash: 1
   prerelease: false
   segments: 
   - 0
-  - 6
-  - 0
-  version: 0.6.0
+  - 7
+  - 1
+  version: 0.7.1
 platform: ruby
 authors: 
 - Andrew Cholakian
@@ -15,7 +15,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-12-17 00:00:00 -08:00
+date: 2011-01-30 00:00:00 -08:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -136,21 +136,14 @@ files:
 - dripdrop.gemspec
 - example/agent_test.rb
 - example/combined.rb
+- example/complex/README
+- example/complex/client.rb
+- example/complex/server.rb
+- example/complex/service.rb
+- example/complex/websocket.rb
 - example/http.rb
 - example/pubsub.rb
 - example/pushpull.rb
-- example/stats_app/core.rb
-- example/stats_app/public/.sass-cache/b48b4299d80c05f528daf63fe51d85e5e3c10d98/stats.scssc
-- example/stats_app/public/backbone.js
-- example/stats_app/public/build_templates.rb
-- example/stats_app/public/json2.js
-- example/stats_app/public/protovis-r3.2.js
-- example/stats_app/public/stats.css
-- example/stats_app/public/stats.haml
-- example/stats_app/public/stats.html
-- example/stats_app/public/stats.js
-- example/stats_app/public/stats.scss
-- example/stats_app/public/underscore.js
 - example/subclass.rb
 - example/xreq_xrep.rb
 - js/dripdrop.html
@@ -211,13 +204,13 @@ signing_key:
 specification_version: 3
 summary: Evented framework for ZeroMQ and EventMachine Apps.
 test_files: 
-- spec/gimite-websocket.rb
-- spec/message_spec.rb
 - spec/node_spec.rb
 - spec/spec_helper.rb
-- spec/node/http_spec.rb
+- spec/gimite-websocket.rb
+- spec/message_spec.rb
 - spec/node/nodelet_spec.rb
-- spec/node/routing_spec.rb
-- spec/node/websocket_spec.rb
 - spec/node/zmq_pushpull_spec.rb
 - spec/node/zmq_xrepxreq_spec.rb
+- spec/node/routing_spec.rb
+- spec/node/websocket_spec.rb
+- spec/node/http_spec.rb

data/example/stats_app/core.rb

@@ -1,113 +0,0 @@
-require 'dripdrop'
-Thread.abort_on_exception = true #Always a good idea in multithreaded apps.
-
-# This demo app is an message stats application
-# It receives stats data via either HTTP or ZMQ directly, aggregates,
-# and keeps track of data.
-DripDrop::Node.new do
-  routes_for :agg do
-    route :input,  :zmq_subscribe, 'tcp://127.0.0.1:2200', :bind
-    route :output, :zmq_publish,   'tcp://127.0.0.1:2201', :bind
-    route :input_http, :http_server, 'http://127.0.0.1:8082'
-  end
- 
-  routes_for :counter do
-    route :input,      :zmq_subscribe, agg_output.address, :connect
-    route :query,      :zmq_xrep,      'tcp://127.0.0.1:2203', :bind
-    route :query_http, :http_server,   'tcp://0.0.0.0:8081'
-  end
-
-  routes_for :tracer do
-    route :input,  :zmq_subscribe, agg_output.address, :connect, :topic_filter => /^ip_trace_req$/
-    route :output, :zmq_publish, 'tcp://127.0.0.1:2204', :bind
-  end
-  
-  routes_for :ws_stream do
-    route :tracer_input, :zmq_subscribe, agg_output.address,    :connect
-    route :agg_input,    :zmq_subscribe, tracer_output.address, :connect
-    route :client,       :websocket,     'ws://127.0.0.1:2202'
-  end
-  
-  routes_for :heartbeat do
-    route :output, :zmq_publish, agg_input.address, :connect
-  end
-
-  nodelet :agg do |agg|
-    agg.input.on_recv do |message|
-      agg.output.send_message(message)
-    end
-    
-    agg.input.on_recv do |message|
-      agg.output.send_message(message)
-    end
-    
-    agg.input_http.on_recv do |message,response,env|
-      response.send_message(:name => 'ack')
-      agg.output.send_message(message)
-    end
-  end 
-
-  nodelet :counter do |cntr|
-    stats = {:total => 0, :name_counts => Hash.new(0) }
-    
-    cntr.input.on_recv do |message|
-      stats[:total] += 1
-      stats[:name_counts][message.name] += 1
-    end
-    
-    cntr.query.on_recv do |message,ids,seq|
-      cntr.query.send_message({:name => 'stats', :body => @stats}, ids, seq)
-    end
-
-    cntr.query_http.on_recv do |message,response|
-      response.send_message(:name => 'stats', :body => @stats)
-    end
-  end
-
-  nodelet :tracer do |tracer|
-    tracer_memo = {}
-    
-    ip_regexp = /\A(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\Z/
-    tracer.input.on_recv do |message|
-      puts "TRACE #{message.body.inspect}"
-       
-      ip = message.body['ip']
-      puts "IP #{message.inspect}"
-      if ip =~ ip_regexp
-        memoized_res = tracer_memo[ip]
-        if memoized_res
-          tracer.output.send_message(:name => 'ip_route', :body => {:ip => ip, :route => memoized_res})
-        else
-          EM.system("/usr/sbin/traceroute -w 4 #{ip}") do |output,status|
-            route = output.split("\n")[1..-1].map {|l| l.split(/ /)[3] }.select {|a| a != '*'}
-            tracer_memo[ip] = route
-            tracer.output.send_message(:name => 'ip_route', :body => {:ip => ip, :route => route})
-          end
-        end
-      end
-    end
-  end
-
-  nodelet :ws_stream do |wss|
-    [wss.tracer_input, wss.agg_input].each do |input|
-      input.on_recv do |message|
-        send_internal(:wss, message)
-      end
-    end
-    
-    wss.client.on_open do |ws|
-      recv_internal(:wss, ws.signature) do |message|
-        ws.send_message(message)
-      end
-    end.on_recv do |message,ws|
-    end.on_close do |ws|
-    end.on_error do |ws|
-    end
-  end
-  
-  nodelet :heartbeat do |hbeat|
-    zm_reactor.periodical_timer(1000) do
-      hbeat.output.send_message(:name => 'heartbeat/tick', :body => Time.now.to_i)
-    end
-  end
-end.start! #Start the reactor and block until complete

data/example/stats_app/public/backbone.js

@@ -1,16 +0,0 @@
-(function(){var f;f=typeof exports!=="undefined"?exports:this.Backbone={};f.VERSION="0.2.0";var e=this._;if(!e&&typeof require!=="undefined")e=require("underscore")._;var h=this.jQuery;f.emulateHttp=false;f.Events={bind:function(a,b){this._callbacks||(this._callbacks={});(this._callbacks[a]||(this._callbacks[a]=[])).push(b);return this},unbind:function(a,b){var c;if(a){if(c=this._callbacks)if(b){c=c[a];if(!c)return this;for(var d=0,g=c.length;d<g;d++)if(b===c[d]){c.splice(d,1);break}}else c[a]=[]}else this._callbacks=
-{};return this},trigger:function(a){var b,c,d,g;if(!(c=this._callbacks))return this;if(b=c[a]){d=0;for(g=b.length;d<g;d++)b[d].apply(this,Array.prototype.slice.call(arguments,1))}if(b=c.all){d=0;for(g=b.length;d<g;d++)b[d].apply(this,arguments)}return this}};f.Model=function(a){this.attributes={};this.cid=e.uniqueId("c");this.set(a||{},{silent:true});this._previousAttributes=e.clone(this.attributes);this.initialize&&this.initialize(a)};e.extend(f.Model.prototype,f.Events,{_previousAttributes:null,
-_changed:false,toJSON:function(){return e.clone(this.attributes)},get:function(a){return this.attributes[a]},set:function(a,b){b||(b={});if(!a)return this;if(a.attributes)a=a.attributes;var c=this.attributes;if(this.validate){var d=this.validate(a);if(d){b.error?b.error(this,d):this.trigger("error",this,d);return false}}if("id"in a)this.id=a.id;for(var g in a){d=a[g];if(d==="")d=null;if(!e.isEqual(c[g],d)){c[g]=d;if(!b.silent){this._changed=true;this.trigger("change:"+g,this,d)}}}!b.silent&&this._changed&&
-this.change();return this},unset:function(a,b){b||(b={});var c=this.attributes[a];delete this.attributes[a];if(!b.silent){this._changed=true;this.trigger("change:"+a,this);this.change()}return c},fetch:function(a){a||(a={});var b=this,c=a.error&&e.bind(a.error,null,b);f.sync("read",this,function(d){if(!b.set(b.parse(d),a))return false;a.success&&a.success(b,d)},c);return this},save:function(a,b){a||(a={});b||(b={});if(!this.set(a,b))return false;var c=this,d=b.error&&e.bind(b.error,null,c),g=this.isNew()?
-"create":"update";f.sync(g,this,function(i){if(!c.set(c.parse(i),b))return false;b.success&&b.success(c,i)},d);return this},destroy:function(a){a||(a={});var b=this,c=a.error&&e.bind(a.error,null,b);f.sync("delete",this,function(d){b.collection&&b.collection.remove(b);a.success&&a.success(b,d)},c);return this},url:function(){var a=j(this.collection);if(this.isNew())return a;return a+"/"+this.id},parse:function(a){return a},clone:function(){return new this.constructor(this)},isNew:function(){return!this.id},
-change:function(){this.trigger("change",this);this._previousAttributes=e.clone(this.attributes);this._changed=false},hasChanged:function(a){if(a)return this._previousAttributes[a]!=this.attributes[a];return this._changed},changedAttributes:function(a){a||(a=this.attributes);var b=this._previousAttributes,c=false,d;for(d in a)if(!e.isEqual(b[d],a[d])){c=c||{};c[d]=a[d]}return c},previous:function(a){if(!a||!this._previousAttributes)return null;return this._previousAttributes[a]},previousAttributes:function(){return e.clone(this._previousAttributes)}});
-f.Collection=function(a,b){b||(b={});if(b.comparator){this.comparator=b.comparator;delete b.comparator}this._boundOnModelEvent=e.bind(this._onModelEvent,this);this._reset();a&&this.refresh(a,{silent:true});this.initialize&&this.initialize(a,b)};e.extend(f.Collection.prototype,f.Events,{model:f.Model,toJSON:function(){return this.map(function(a){return a.toJSON()})},add:function(a,b){if(e.isArray(a))for(var c=0,d=a.length;c<d;c++)this._add(a[c],b);else this._add(a,b);return this},remove:function(a,
-b){if(e.isArray(a))for(var c=0,d=a.length;c<d;c++)this._remove(a[c],b);else this._remove(a,b);return this},get:function(a){return a&&this._byId[a.id!=null?a.id:a]},getByCid:function(a){return a&&this._byCid[a.cid||a]},at:function(a){return this.models[a]},sort:function(a){a||(a={});if(!this.comparator)throw Error("Cannot sort a set without a comparator");this.models=this.sortBy(this.comparator);a.silent||this.trigger("refresh",this);return this},pluck:function(a){return e.map(this.models,function(b){return b.get(a)})},
-refresh:function(a,b){a||(a=[]);b||(b={});this._reset();this.add(a,{silent:true});b.silent||this.trigger("refresh",this);return this},fetch:function(a){a||(a={});var b=this,c=a.error&&e.bind(a.error,null,b);f.sync("read",this,function(d){b.refresh(b.parse(d));a.success&&a.success(b,d)},c);return this},create:function(a,b){b||(b={});a instanceof f.Model||(a=new this.model(a));var c=a.collection=this;return a.save(null,{success:function(d,g){c.add(d);b.success&&b.success(d,g)},error:b.error})},parse:function(a){return a},
-chain:function(){return e(this.models).chain()},_reset:function(){this.length=0;this.models=[];this._byId={};this._byCid={}},_add:function(a,b){b||(b={});a instanceof f.Model||(a=new this.model(a));var c=this.getByCid(a);if(c)throw Error(["Can't add the same model to a set twice",c.id]);this._byId[a.id]=a;this._byCid[a.cid]=a;a.collection=this;this.models.splice(this.comparator?this.sortedIndex(a,this.comparator):this.length,0,a);a.bind("all",this._boundOnModelEvent);this.length++;b.silent||this.trigger("add",
-a);return a},_remove:function(a,b){b||(b={});a=this.getByCid(a);if(!a)return null;delete this._byId[a.id];delete this._byCid[a.cid];delete a.collection;this.models.splice(this.indexOf(a),1);a.unbind("all",this._boundOnModelEvent);this.length--;b.silent||this.trigger("remove",a);return a},_onModelEvent:function(a,b){if(a==="change:id"){delete this._byId[b.previous("id")];this._byId[b.id]=b}this.trigger.apply(this,arguments)}});e.each(["forEach","each","map","reduce","reduceRight","find","detect","filter",
-"select","reject","every","all","some","any","include","invoke","max","min","sortBy","sortedIndex","toArray","size","first","rest","last","without","indexOf","lastIndexOf","isEmpty"],function(a){f.Collection.prototype[a]=function(){return e[a].apply(e,[this.models].concat(e.toArray(arguments)))}});f.View=function(a){this._configure(a||{});this._ensureElement();this.delegateEvents();this.initialize&&this.initialize(a)};var k=function(a){return h(a,this.el)},l=/^(\w+)\s*(.*)$/;e.extend(f.View.prototype,
-{tagName:"div",$:k,jQuery:k,render:function(){return this},make:function(a,b,c){a=document.createElement(a);b&&h(a).attr(b);c&&h(a).html(c);return a},delegateEvents:function(a){if(!(a||(a=this.events)))return this;h(this.el).unbind();for(var b in a){var c=a[b],d=b.match(l),g=d[1];d=d[2];c=e.bind(this[c],this);d===""?h(this.el).bind(g,c):h(this.el).delegate(d,g,c)}return this},_configure:function(a){if(this.options)a=e.extend({},this.options,a);if(a.model)this.model=a.model;if(a.collection)this.collection=
-a.collection;if(a.el)this.el=a.el;if(a.id)this.id=a.id;if(a.className)this.className=a.className;if(a.tagName)this.tagName=a.tagName;this.options=a},_ensureElement:function(){if(!this.el){var a={};if(this.id)a.id=this.id;if(this.className)a.className=this.className;this.el=this.make(this.tagName,a)}}});var n=f.Model.extend=f.Collection.extend=f.View.extend=function(a,b){var c=m(this,a,b);c.extend=n;return c},o={create:"POST",update:"PUT","delete":"DELETE",read:"GET"};f.sync=function(a,b,c,d){var g=
-a==="create"||a==="update"?{model:JSON.stringify(b)}:{};a=o[a];if(f.emulateHttp&&(a==="PUT"||a==="DELETE")){g._method=a;a="POST"}h.ajax({url:j(b),type:a,data:g,dataType:"json",success:c,error:d})};var m=function(a,b,c){var d;d=b.hasOwnProperty("constructor")?b.constructor:function(){return a.apply(this,arguments)};var g=function(){};g.prototype=a.prototype;d.prototype=new g;e.extend(d.prototype,b);c&&e.extend(d,c);return d.prototype.constructor=d},j=function(a){if(!(a&&a.url))throw Error("A 'url' property or function must be specified");
-return e.isFunction(a.url)?a.url():a.url}})();

data/example/stats_app/public/build_templates.rb

@@ -1,5 +0,0 @@
-#!/usr/bin/env ruby
-#Compile the HAML and SASS templates
-
-`haml stats.haml > stats.html`
-`sass stats.scss > stats.css`

data/example/stats_app/public/json2.js

@@ -1,482 +0,0 @@
-/*
-    http://www.JSON.org/json2.js
-    2010-08-25
-
-    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 */
-
-/*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.
-
-if (!this.JSON) {
-    this.JSON = {};
-}
-
-(function () {
-
-    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');
-        };
-    }
-}());