Merge branch 'master' of github.com:bjornstar/tomes into develop

README.md

@@ -1,10 +1,12 @@
 [![Build Status](https://travis-ci.org/Wizcorp/node-tomes.png)](https://travis-ci.org/Wizcorp/node-tomes)
 
 Tomes
-=========
+=====
 
 *Evented Storage Agnostic Data API*
 
+![Tomes Logo](https://raw.github.com/bjornstar/tomes/master/logo/tomes-logo-small.png)
+
 Problem: You've got data and you want to do something whenever it changes.
 
 Access and modify your data through the Tomes API and you'll get change events.
@@ -53,6 +55,9 @@ Returns data's type as a string. Tomes only has types that exist in JSON which a
 ###Tome.isTome( *data* )
 Returns a boolean indicating whether data is a Tome or not.
 
+###Tome.unTome( *tome* )
+Returns a regular JavaScript version of your Tome.
+
 ##TomeTypes
  - ArrayTome
  - BooleanTome

component.json

@@ -2,7 +2,7 @@
   "name": "tomes",
   "repo": "bjornstar/tomes",
   "description": "Evented Storage Agnostic Data API",
-  "version": "0.0.13",
+  "version": "0.0.15",
   "keywords": [ "data", "events" ],
   "dependencies": {
     "component/emitter": "*"

package.json

@@ -1,7 +1,7 @@
 {
     "name": "tomes",
     "description": "Evented Storage Agnostic Data API",
-    "version": "0.0.13",
+    "version": "0.0.15",
     "author": "Wizcorp, Inc. <info@wizcorp.jp>",
     "maintainers": [
         { "name": "Bjorn Stromberg", "email": "bstromberg@wizcorp.jp" }
@@ -11,7 +11,8 @@
     },
     "main": "tomes.js",
     "devDependencies": {
-        "nodeunit": "*"
+        "nodeunit": "*",
+        "rumplestiltskin": "*"
     },
     "license": {
         "type": "MIT",

test/modules/untome.js

@@ -0,0 +1,68 @@
+var trueName = require('rumplestiltskin').trueName;
+var Tome = require('../../tomes').Tome;
+
+exports.unTomeNumber = function (test) {
+	test.expect(1);
+
+	var a = 1;
+	var b = Tome.conjure(a);
+
+	test.strictEqual(trueName(a), trueName(Tome.unTome(b)));
+
+	test.done();
+};
+
+exports.unTomeString = function (test) {
+	test.expect(1);
+
+	var a = 'the unTome.';
+	var b = Tome.conjure(a);
+
+	test.strictEqual(trueName(a), trueName(Tome.unTome(b)));
+
+	test.done();
+};
+
+exports.unTomeNull = function (test) {
+	test.expect(1);
+
+	var a = null;
+	var b = Tome.conjure(a);
+
+	test.strictEqual(trueName(a), trueName(Tome.unTome(b)));
+
+	test.done();
+};
+
+exports.unTomeBoolean = function (test) {
+	test.expect(1);
+
+	var a = false;
+	var b = Tome.conjure(a);
+
+	test.strictEqual(trueName(a), trueName(Tome.unTome(b)));
+
+	test.done();
+};
+
+exports.unTomeArray = function (test) {
+	test.expect(1);
+
+	var a = [ 0, 1, 2, 'hi', null, undefined, { a: 'nope' } ];
+	var b = Tome.conjure(a);
+
+	test.strictEqual(trueName(a), trueName(Tome.unTome(b)));
+
+	test.done();
+};
+
+exports.unTomeComplex = function (test) {
+	test.expect(1);
+
+	var a = { a: { b: true, c: undefined, d: null, e: [ 0, 1, 'hi', 'cat' ], f: { g: false } } };
+	var b = Tome.conjure(a);
+
+	test.strictEqual(trueName(a), trueName(Tome.unTome(b)));
+
+	test.done();
+};

tomes.js

@@ -204,6 +204,42 @@ Tome.buildChain = function (tome) {
 	return chain.reverse();
 };
 
+Tome.unTome = function (tome) {
+	var out, keys;
+
+	var tomeType = Tome.typeOf(tome);
+
+	switch (tomeType) {
+	case 'object':
+		out = {};
+		keys = Object.keys(tome);
+		break;
+	case 'array':
+		out = new Array(tome.length);
+		keys = Object.keys(tome);
+		break;
+	case 'undefined':
+		out = undefined;
+		break;
+	case 'null':
+		out = null;
+		break;
+	default:
+		out = tome.valueOf();
+		break;
+	}
+
+	if (!keys) {
+		return out;
+	}
+
+	for (var i = 0; i < keys.length; i += 1) {
+		var key = keys[i];
+		out[key] = Tome.unTome(tome[key]);
+	}
+	return out;
+};
+
 function markDirty(tome, dirtyAt, was) {
 	if (tome.__dirty__ === dirtyAt) {
 		return;