manyfest 1.0.5 → 1.0.6

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "manyfest",
-  "version": "1.0.5",
+  "version": "1.0.6",
   "description": "JSON Object Manifest for Data Description and Parsing",
   "main": "source/Manyfest.js",
   "scripts": {

package/source/Manyfest-SchemaManipulation.js

@@ -107,6 +107,32 @@ class ManyfestSchemaManipulation
 		this.resolveAddressMappings(tmpManyfestSchemaDescriptors, pAddressMapping);
 		return tmpManyfestSchemaDescriptors;
 	}
+
+	mergeAddressMappings(pManyfestSchemaDescriptorsDestination, pManyfestSchemaDescriptorsSource)
+	{
+		if ((typeof(pManyfestSchemaDescriptorsSource) != 'object') || (typeof(pManyfestSchemaDescriptorsDestination) != 'object'))
+		{
+			this.logError(`Attempted to merge two schema descriptors but both were not objects.`);
+			return false;
+		}
+
+		let tmpSource = JSON.parse(JSON.stringify(pManyfestSchemaDescriptorsSource));
+		let tmpNewManyfestSchemaDescriptors = JSON.parse(JSON.stringify(pManyfestSchemaDescriptorsDestination));
+
+		// The first passed-in set of descriptors takes precedence.
+		let tmpDescriptorAddresses = Object.keys(tmpSource);
+
+		tmpDescriptorAddresses.forEach(
+			(pDescriptorAddress) => 
+			{
+				if (!tmpNewManyfestSchemaDescriptors.hasOwnProperty(pDescriptorAddress))
+				{
+					tmpNewManyfestSchemaDescriptors[pDescriptorAddress] = tmpSource[pDescriptorAddress];
+				}
+			});
+		
+		return tmpNewManyfestSchemaDescriptors;
+	}
 }
 
 module.exports = ManyfestSchemaManipulation;

package/source/Manyfest.js

@@ -71,6 +71,19 @@ class Manyfest
 		this.elementDescriptors = {};
 	}
 
+	clone()
+	{
+		// Make a copy of the options in-place
+		let tmpNewOptions = JSON.parse(JSON.stringify(this.options));
+
+		let tmpNewManyfest = new Manyfest(this.getManifest(), this.logInfo, this.logError, tmpNewOptions);
+
+		// Import the hash translations
+		tmpNewManyfest.hashTranslations.addTranslation(this.hashTranslations.translationTable);
+
+		return tmpNewManyfest;
+	}
+
 	// Deserialize a Manifest from a string
 	deserialize(pManifestString)
 	{
@@ -125,6 +138,7 @@ class Manyfest
 	}
 
 	// Serialize the Manifest to a string
+	// TODO: Should this also serialize the translation table?
 	serialize()
 	{
 		return JSON.stringify(this.getManifest());
@@ -132,7 +146,7 @@ class Manyfest
 
 	getManifest()
 	{
-		let tmpManifest = (
+		return (
 			{
 				Scope: this.scope,
 				Descriptors: JSON.parse(JSON.stringify(this.elementDescriptors))

package/test/Manyfest_Object_SchemaManipulation_tests.js

@@ -84,6 +84,116 @@ suite
 						Expect(tmpNewSchemaDescriptors.CarrotCost.Hash).to.equal('a');
 						Expect(tmpNewSchemaDescriptors.AppleCost.Hash).to.equal('b');
 
+						fTestComplete();
+					}
+				);
+				test
+				(
+					'We should be able to merge properties safely.',
+					(fTestComplete)=>
+					{
+						let tmpSchemaDescriptors = (
+							{
+								"a": { "Hash": "a", "Type": "Number" },
+								"b": { "Hash": "b", "Type": "Number" }
+							});
+						
+						let tmpSchemaDescriptorsToMerge = (
+							{
+								"c": { "Hash": "c" },
+								"d": { "Hash": "d" },
+								"e": { "Hash": "e" },
+								"a": { "Hash": "ARBUCKLE", "Type": "Number" }
+							});
+						
+						Expect(tmpSchemaDescriptors.a.Hash).to.equal('a');
+
+						let _Manyfest = new libManyfest();
+						// Now remap the schema (in-place)
+						let tmpNewSchemaDescriptors = _Manyfest.schemaManipulations.mergeAddressMappings(tmpSchemaDescriptors, tmpSchemaDescriptorsToMerge);
+
+						// The schema should be safe
+						Expect(tmpNewSchemaDescriptors.a.Hash).to.equal('a');
+						// And a new schema should have been created with the alterations
+						Expect(tmpNewSchemaDescriptors.b.Hash).to.equal('b');
+						Expect(tmpNewSchemaDescriptors.c.Hash).to.equal('c');
+
+						fTestComplete();
+					}
+				);
+				test
+				(
+					'Cloning should work.',
+					(fTestComplete)=>
+					{
+						let tmpSchemaDescriptors = (
+							{
+								"a": { "Hash": "a", "Type": "Number" },
+								"b": { "Hash": "b", "Type": "Number" }
+							});
+
+						let tmpTranslationTable = (
+							{
+								"a": "CarrotCost",
+								"b": "AppleCost"
+							});
+						
+						let _Manyfest = new libManyfest({ Scope:'Archive.org', Descriptors: {'metadata.creator': {Name:'Creator', Hash:'Creator'}}});
+						// Property not schema, accessed by hash:
+						let tmpCreator = _Manyfest.getValueByHash(_SampleDataArchiveOrgFrankenberry, 'Creator');
+						Expect(tmpCreator).to.equal('General Mills');
+						let _ClonedManyfest = _Manyfest.clone();
+						Expect(_ClonedManyfest.getValueByHash(_SampleDataArchiveOrgFrankenberry, 'Creator')).to.equal('General Mills');
+	
+						fTestComplete();
+					}
+				);
+				test
+				(
+					'Cloning should take into account translation.',
+					(fTestComplete)=>
+					{
+						let tmpSchemaDescriptors = (
+							{
+								"a": { "Hash": "a", "Type": "Number" },
+								"b": { "Hash": "b", "Type": "Number" }
+							});
+
+						let tmpTranslationTable = (
+							{
+								"a": "CarrotCost",
+								"b": "AppleCost"
+							});
+						
+						let _Manyfest = new libManyfest({ Scope:'Archive.org', Descriptors: {'metadata.creator': {Name:'Creator', Hash:'Creator'}}});
+						// Property not schema, accessed by hash:
+						let tmpCreator = _Manyfest.getValueByHash(_SampleDataArchiveOrgFrankenberry, 'Creator');
+						Expect(tmpCreator).to.equal('General Mills');
+						// Create a translation between "Creator" and "Director" as well as "Author"
+						_Manyfest.hashTranslations.addTranslation({"Director":"Creator", "Author":"Creator", "Songwriter":"Creator"});
+						Expect(tmpCreator).to.equal('General Mills');
+						// Director should also work
+						Expect(_Manyfest.getValueByHash(_SampleDataArchiveOrgFrankenberry, 'Director')).to.equal('General Mills');
+						// And Author!
+						Expect(_Manyfest.getValueByHash(_SampleDataArchiveOrgFrankenberry, 'Author')).to.equal('General Mills');
+						// Now remove Director
+						_Manyfest.hashTranslations.clearTranslations();
+						Expect(_Manyfest.getValueByHash(_SampleDataArchiveOrgFrankenberry, 'Author')).to.equal(undefined);
+						Expect(_Manyfest.getValueByHash(_SampleDataArchiveOrgFrankenberry, 'Director')).to.equal(undefined);
+						Expect(_Manyfest.getValueByHash(_SampleDataArchiveOrgFrankenberry, 'Songwriter')).to.equal(undefined);
+						Expect(_Manyfest.getValueByHash(_SampleDataArchiveOrgFrankenberry, 'Creator')).to.equal('General Mills');
+
+						let _ClonedManyfest = _Manyfest.clone();
+						Expect(_ClonedManyfest.getValueByHash(_SampleDataArchiveOrgFrankenberry, 'Author')).to.equal(undefined);
+						Expect(_ClonedManyfest.getValueByHash(_SampleDataArchiveOrgFrankenberry, 'Director')).to.equal(undefined);
+						Expect(_ClonedManyfest.getValueByHash(_SampleDataArchiveOrgFrankenberry, 'Songwriter')).to.equal(undefined);
+						Expect(_ClonedManyfest.getValueByHash(_SampleDataArchiveOrgFrankenberry, 'Creator')).to.equal('General Mills');
+
+						// New translations should not affect the old manyfest
+						_ClonedManyfest.hashTranslations.addTranslation({"Director":"Creator", "Author":"Creator", "Songwriter":"Creator"});
+						Expect(_ClonedManyfest.getValueByHash(_SampleDataArchiveOrgFrankenberry, 'Director')).to.equal('General Mills');
+						Expect(_Manyfest.getValueByHash(_SampleDataArchiveOrgFrankenberry, 'Director')).to.equal(undefined);
+	
 						fTestComplete();
 					}
 				);