qtools-library-dot-d 1.0.8 → 1.0.10

package/libDotD_Working_Example/node_modules/qtools-functional-library/lib/qtools-merge/test.js

@@ -0,0 +1,214 @@
+'use strict';
+
+//START OF moduleFunction() ============================================================
+
+const moduleFunction = function(args) {
+	//this module is initialized with parameters spec'd in the main function module
+	
+	const completeStepActual = ({verbose=false, logErrors=false, moduleName}) => (
+		methodName,
+		thisStepMessage,
+		thisStepResult,
+		thisStepEvalFunction
+	) => {
+
+		const thisStepPass = thisStepEvalFunction(thisStepResult);
+		
+		if (logErrors && !thisStepPass) {
+			console.log(`FAIL TEST: ${thisStepMessage} in ...${moduleName}`);
+		}
+		if (verbose) {
+			console.log(`Result for: ${methodName} (${thisStepPass?'PASS':'FAIL'}):`);
+			thisStepResult.qtDump();
+			console.log('\n\n');
+		}
+		
+		return passingTests && thisStepPass;
+	};
+
+	const completeStep = completeStepActual(args);
+
+	let passingTests = true;
+
+	let thisStepMessage;
+	let thisStepResult;
+	let thisStepEvalFunction;
+	let methodName;
+
+	//TESTS ============================================================
+
+
+
+	const testArray = {
+				animal: 'bird',
+				eatsWith: 'teeth',
+				color: 'red',
+				list:['orig1',2,3, 4],
+				deep:[
+					{a:'a'},
+					{b:{nestedList:['d1','d2','d3']}}
+					]
+			};
+	
+	const testArray2 = {
+				animal: 'fish',
+				eatsWith: 'snout',
+				shoeSize:10,
+				list:['q',void(0),'new3',void(0),'new5'],
+				deep:[
+					{c:'creplacement'},
+					{b:{nestedList:['d1replacement']}}
+					],
+				new_array_not_in_replacement:[
+					'newA',
+					'newB'
+				],
+				new_object_not_in_original:{
+					hello:'goodbye',
+					orange:'black'
+				}
+			};
+
+	
+	const testArray3 = {
+				animal: 'mastodon',
+				horns:'pointy'
+			};
+	
+	
+	const arrayTestA={
+		a:'b',
+		b:{'x':10, y:20},
+		c:{
+			importantArray:[
+				{one:1, two:2},
+				{onex:1, twox:2},
+			],
+			arrayOfBasicTypes:[
+			'first',
+			'second'
+			
+			]
+	
+	
+	}
+	};
+	
+	const arrayTestB={}
+	arrayTestB.c={};
+	arrayTestB.c.importantArray=[];
+	arrayTestB.c.importantArray[3]={oney:1, twoy:2};
+	
+	const arrayTestC={}
+	arrayTestC.c={};
+	arrayTestC.c.importantArray=[];
+	arrayTestC.c.importantArray[1]={twox:22};
+	
+	const arrayTestD={
+		c:{
+			arrayOfBasicTypes:[]
+		}
+	}
+	arrayTestD.c.arrayOfBasicTypes[0]='replacesFirst';
+	
+	const arrayTestE={
+	a:{replaces:'scalar'},
+	b:'replacesArray'
+	
+	}
+
+
+
+	//TEST ITEM ------------------------------------------------------
+	methodName='qtMerge'
+	thisStepMessage = "Failed to replace base type with complex one or vice versa";
+	thisStepResult = arrayTestA[methodName](arrayTestE, {mergeNonExistent:true});
+	thisStepEvalFunction = item => 
+		item.qtGetSurePath('c.arrayOfBasicTypes[0]')=='replacesFirst' &&
+		item.qtGetSurePath('c.arrayOfBasicTypes[1]')=='second';
+	passingTests =
+		completeStep(methodName, thisStepMessage, thisStepResult, thisStepEvalFunction) &&
+		passingTests;
+
+	//TEST ITEM ------------------------------------------------------
+	methodName='qtMerge'
+	thisStepMessage = "Didn't merge array correctly";
+	thisStepResult = arrayTestA[methodName](arrayTestD, {mergeNonExistent:true});
+	thisStepEvalFunction = item => 
+		item.qtGetSurePath('c.arrayOfBasicTypes[0]')=='replacesFirst' &&
+		item.qtGetSurePath('c.arrayOfBasicTypes[1]')=='second';
+	passingTests =
+		completeStep(methodName, thisStepMessage, thisStepResult, thisStepEvalFunction) &&
+		passingTests;
+		
+	//TEST ITEM ------------------------------------------------------
+	methodName='qtMerge'
+	thisStepMessage = "Didn't merge basic array element correctly";
+	thisStepResult = arrayTestA[methodName](arrayTestB, {mergeNonExistent:true});
+	thisStepEvalFunction = item => 
+		item.qtGetSurePath('c.importantArray[0].one')==1 &&
+		item.qtGetSurePath('c.importantArray[1].twox')==2 &&
+		item.qtGetSurePath('c.importantArray[2]', 'undefined')=='undefined' &&
+		item.qtGetSurePath('c.importantArray[3].oney')==1;
+	passingTests =
+		completeStep(methodName, thisStepMessage, thisStepResult, thisStepEvalFunction) &&
+		passingTests;
+		
+	//TEST ITEM ------------------------------------------------------
+	methodName='qtMerge'
+	thisStepMessage = "Didn't merge object element inside an array correctly";
+	thisStepResult = arrayTestA[methodName](arrayTestC, {mergeNonExistent:true});
+	thisStepEvalFunction = item =>
+		item.qtGetSurePath('c.importantArray[1].onex')==1 &&
+		item.qtGetSurePath('c.importantArray[1].twox')==22;
+	passingTests =
+		completeStep(methodName, thisStepMessage, thisStepResult, thisStepEvalFunction) &&
+		passingTests;	
+		
+	//TEST ITEM ------------------------------------------------------
+	methodName='qtMerge'
+	thisStepMessage = "Didn't merge deep replacement property correctly";
+	thisStepResult = testArray[methodName](testArray2, {mergeNonExistent:true});
+	thisStepEvalFunction = item => item.qtGetSurePath('deep[1].b.nestedList[0]')=='d1replacement';
+	passingTests =
+		completeStep(methodName, thisStepMessage, thisStepResult, thisStepEvalFunction) &&
+		passingTests;
+//		
+//	//TEST ITEM ------------------------------------------------------
+//	methodName='qtMerge'
+//	thisStepMessage = "Didn't merge undefined item correctly";
+//	thisStepResult = testArray[methodName](testArray2, {mergeNonExistent:true});
+//	thisStepEvalFunction = item => typeof(item.qtGetSurePath('list[1]'))=='undefined';
+//	passingTests =
+//		completeStep(methodName, thisStepMessage, thisStepResult, thisStepEvalFunction) &&
+//		passingTests;
+//
+//	//TEST ITEM ------------------------------------------------------
+//	methodName='qtMerge'
+//	thisStepMessage = "did not merge nested array element";
+//	thisStepResult = testArray[methodName](testArray2, {mergeNonExistent:false});
+//	thisStepEvalFunction = item => item.qtGetSurePath('deep[1].b.nestedList[0]')=='d1replacement';
+//	passingTests =
+//		completeStep(methodName, thisStepMessage, thisStepResult, thisStepEvalFunction) &&
+//		passingTests;
+//
+//	//TEST ITEM ------------------------------------------------------
+//	methodName='qtMerge'
+//	thisStepMessage = "did not merge third object correctly";
+//	thisStepResult = testArray[methodName](testArray2, {mergeNonExistent:false}).qtMerge(testArray3);
+//	thisStepEvalFunction = item => item.horns=='pointy' && item.animal=='mastodon' && item.eatsWith=='snout';
+//	passingTests =
+//		completeStep(methodName, thisStepMessage, thisStepResult, thisStepEvalFunction) &&
+//		passingTests;
+//	
+//	
+	
+
+	return passingTests;
+};
+
+//END OF moduleFunction() ============================================================
+
+module.exports = moduleFunction;
+//module.exports = new moduleFunction();
+

package/libDotD_Working_Example/node_modules/qtools-functional-library/lib/qtools-new-method-template/package.json

@@ -0,0 +1,11 @@
+{
+  "name": "qtools-new-method-template",
+  "version": "1.0.0",
+  "description": "Barest bones new qtLib method to start building a real one. DON'T EVER OVERWRITE THIS.",
+  "main": "qtools-new-method-template.js",
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "author": "TQ White II",
+  "license": "ISC"
+}

package/libDotD_Working_Example/node_modules/qtools-functional-library/lib/qtools-new-method-template/qtools-new-method-template.js

@@ -0,0 +1,70 @@
+'use strict';
+//START OF moduleFunction() ============================================================
+var moduleFunction = function(args = {}) {
+	const { commonFunctions } = args;
+	
+	const addToPrototypeActual = functionObject => () =>
+		commonFunctions.universalAddToPrototype(commonFunctions, functionObject);
+	
+	
+	
+	//first method definition function ==========================
+	const firstMethodFunction = commonFunctions => {
+		const functionObject = new Map(); // prettier-ignore
+		
+		const methodName = 'qtTemplateMethod';
+		const description = `placeholder`;
+		const supportedTypeList = [Array, String, Number];
+
+		const method = () =>
+			function(arg) {
+				//if one of the supportedTypeList elements is Object, basically all data types will have this method and type checking is important.
+				if (!commonFunctions.isSupportedType(this, supportedTypeList)) {
+					// prettier-ignore
+					throw new Error(
+						`${methodName}(): unsupported data type: '${commonFunctions.toType(this)}' (${methodName} supports ${supportedTypeList.map(item=>item.toString().replace(/.*function (.*?)\(\).*/, '$1')).join(', ')})`
+					);
+				}
+
+				return this.toString() + ` : ${arg}`;
+			};
+
+		functionObject.set(methodName, {
+			description,
+			supportedTypeList,
+			method,
+			test: (args) =>
+{
+				return require('./test.js')({...args, ...{
+					moduleName: module.id.replace(module.path, '')
+				}})
+				}
+		});
+		
+		const placeholder=input=>input+'morePlaceholder';
+
+		functionObject.set('qtTemplateMethod2', {
+			description: `placeholder`,
+			supportedTypeList: [String],
+			method: () => placeholder,
+			test: args => {
+				return require('./test.js')({
+					...args,
+					...{
+						moduleName: module.id.replace(module.path, '')
+					}
+				});
+			}
+		});
+		
+		
+		return functionObject;
+	};  
+	 this.addToPrototype = addToPrototypeActual(
+		firstMethodFunction(commonFunctions)
+	);
+	
+};
+//END OF moduleFunction() ============================================================
+module.exports = moduleFunction;
+//module.exports = new moduleFunction();

package/libDotD_Working_Example/node_modules/qtools-functional-library/lib/qtools-new-method-template/test.js

@@ -0,0 +1,66 @@
+'use strict';
+
+//START OF moduleFunction() ============================================================
+
+const moduleFunction = function(args) {
+	//this module is initialized with parameters spec'd in the main function module
+	
+	const completeStepActual = ({verbose=false, logErrors=false, moduleName}) => (
+		methodName,
+		thisStepMessage,
+		thisStepResult,
+		thisStepEvalFunction
+	) => {
+
+		const thisStepPass = thisStepEvalFunction(thisStepResult);
+		
+		if (logErrors && !thisStepPass) {
+			console.log(`FAIL TEST: ${thisStepMessage} in ...${moduleName}`);
+		}
+		if (verbose) {
+			console.log(`Result for: ${methodName} (${thisStepPass?'PASS':'FAIL'}):`);
+			thisStepResult.qtDump();
+			console.log('\n\n');
+		}
+		
+		return passingTests && thisStepPass;
+	};
+
+	const completeStep = completeStepActual(args);
+
+	let passingTests = true;
+
+	let thisStepMessage;
+	let thisStepResult;
+	let thisStepEvalFunction;
+	let methodName;
+
+	//TESTS ============================================================
+
+	
+	const testArray = [
+		'allocute',
+		'Hello'
+	];
+	
+
+	//TEST ITEM ------------------------------------------------------
+	methodName='qtTemplateMethod'
+	thisStepMessage = "not yet implemented";
+	thisStepResult = testArray[methodName]('SUFFIX');
+	thisStepEvalFunction = item => item='allocute,Hello : SUFFIX';
+	passingTests =
+		completeStep(methodName, thisStepMessage, thisStepResult, thisStepEvalFunction) &&
+		passingTests;
+	
+	
+	
+
+	return passingTests;
+};
+
+//END OF moduleFunction() ============================================================
+
+module.exports = moduleFunction;
+//module.exports = new moduleFunction();
+

package/libDotD_Working_Example/node_modules/qtools-functional-library/lib/qtools-number-iterator/package.json

@@ -0,0 +1,11 @@
+{
+  "name": "qtools-number-iterator",
+  "version": "1.0.0",
+  "description": "Creates a functional for-loop on the Number prototype",
+  "main": "qtools-number-iterator.js",
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "author": "TQ White II",
+  "license": "ISC"
+}

package/libDotD_Working_Example/node_modules/qtools-functional-library/lib/qtools-number-iterator/qtools-number-iterator.js

@@ -0,0 +1,137 @@
+'use strict';
+
+//START OF moduleFunction() ============================================================
+
+var moduleFunction = function(args = {}) {
+	const { commonFunctions } = args;
+	
+	const addToPrototypeActual = functionObject => () =>
+		commonFunctions.universalAddToPrototype(commonFunctions, functionObject);
+	
+	
+	const setStart = function(startValue) {
+		if (typeof startValue != 'number') {
+			throw 'qtNumberIterator.setStart() requires a numeric value';
+		}
+
+		if (this instanceof IterationThing) {
+			this.startValue = startValue;
+			return this;
+		}
+		return new IterationThing({
+			startValue: startValue,
+			incrementValue: 1,
+			count: this
+		});
+	};
+
+	const setIncrement = function(incrementValue) {
+		if (typeof incrementValue != 'number') {
+			throw 'qtNumberIterator.setIncrement() requires a numeric value';
+		}
+
+		if (this instanceof IterationThing) {
+			this.incrementValue = incrementValue;
+			return this;
+		}
+		return new IterationThing({
+			startValue: 0,
+			incrementValue: 1,
+			count: this
+		});
+	};
+
+	const iterator = function(callback) {
+		let startValue = 0;
+		let incrementValue = 1;
+		let count = this;
+
+		if (this instanceof IterationThing) {
+			startValue = this.startValue;
+			count = this.count;
+			incrementValue = this.incrementValue;
+		}
+
+		const out = [];
+		for (let i = 0; i < count; i = i + 1) {
+			const currentValue = startValue + i * incrementValue;
+
+			if (typeof callback == 'function') {
+				out.push(callback(currentValue, count, startValue, incrementValue));
+			} else {
+				out.push(currentValue);
+			}
+		}
+		return out;
+	};
+
+	function IterationThing(inObj) {
+		for (var i in inObj) {
+			var element = inObj[i];
+			this[i] = element;
+		}
+	}
+	
+	if (typeof Number.prototype.qtIterate == 'undefined') {
+		Object.defineProperty(IterationThing.prototype, 'qtIterate', {
+			value: iterator,
+			writable: false,
+			enumerable: false
+		});
+
+		Object.defineProperty(IterationThing.prototype, 'qtStart', {
+			value: setStart,
+			writable: false,
+			enumerable: false
+		});
+
+		Object.defineProperty(IterationThing.prototype, 'qtIncrement', {
+			value: setIncrement,
+			writable: false,
+			enumerable: false
+		});
+
+	}
+	//atypical pattern !!!
+	
+	//first method definition function ==========================
+	const firstMethodFunction = commonFunctions => {
+		const functionObject = new Map(); // prettier-ignore
+		functionObject.set('qtIterate', {
+			description: `eg, (5).qtStart(7).qtIncrement(3).qtIterate(item=>item*100)`,
+			supportedTypeList: [Number],
+			method: () => iterator
+		});
+
+		functionObject.set('qtStart', {
+			description: `placeholder`,
+			supportedTypeList: [Number],
+			method: () => setStart
+		});
+
+		functionObject.set('qtIncrement', {
+			description: `placeholder`,
+			supportedTypeList: [Number],
+			method: () => setIncrement,
+			test: args => {
+				return require('./test.js')({
+					...args,
+					...{
+						moduleName: module.id.replace(module.path, '')
+					}
+				});
+			}
+		});
+		return functionObject;
+	};
+	this.addToPrototype = addToPrototypeActual(
+		firstMethodFunction(commonFunctions)
+	);
+	
+};
+
+//END OF moduleFunction() ============================================================
+
+module.exports = moduleFunction;
+//module.exports = new moduleFunction();
+

package/libDotD_Working_Example/node_modules/qtools-functional-library/lib/qtools-number-iterator/test.js

@@ -0,0 +1,68 @@
+'use strict';
+
+//START OF moduleFunction() ============================================================
+
+const moduleFunction = function(args) {
+	//this module is initialized with parameters spec'd in the main function module
+	
+	const completeStepActual = ({verbose=false, logErrors=false, moduleName}) => (
+		methodName,
+		thisStepMessage,
+		thisStepResult,
+		thisStepEvalFunction
+	) => {
+
+		const thisStepPass = thisStepEvalFunction(thisStepResult);
+		
+		if (logErrors && !thisStepPass) {
+			console.log(`FAIL TEST: ${thisStepMessage} in ...${moduleName}`);
+		}
+		if (verbose) {
+			console.log(`Result for: ${methodName} (${thisStepPass?'PASS':'FAIL'}):`);
+			console.dir(thisStepResult);
+			console.log('\n\n');
+		}
+		
+		return passingTests && thisStepPass;
+	};
+
+	const completeStep = completeStepActual(args);
+
+	let passingTests = true;
+
+	let thisStepMessage;
+	let thisStepResult;
+	let thisStepEvalFunction;
+	let methodName;
+
+	//TESTS ============================================================
+
+	
+	const testArray = [
+		'allocute',
+		'Hello'
+	];
+	
+// console.dir((5).qtStart(7).qtIncrement(3).qtIterate(item=>item*100))
+// [ 700, 1000, 1300, 1600, 1900 ]
+
+	//TEST ITEM ------------------------------------------------------
+	methodName='qtTemplateMethod'
+	thisStepMessage = "not yet implemented";
+	thisStepResult = (5).qtStart(7).qtIncrement(3).qtIterate(item=>item*100);
+	thisStepEvalFunction = item => item.length=5;
+	passingTests =
+		completeStep(methodName, thisStepMessage, thisStepResult, thisStepEvalFunction) &&
+		passingTests;
+	
+	
+	
+
+	return passingTests;
+};
+
+//END OF moduleFunction() ============================================================
+
+module.exports = moduleFunction;
+//module.exports = new moduleFunction();
+

package/libDotD_Working_Example/node_modules/qtools-functional-library/lib/qtools-number-keys-to-array/package.json

@@ -0,0 +1,11 @@
+{
+  "name": "qtools-number-keys-to-array",
+  "version": "1.0.0",
+  "description": "converts an object into an array; optionally keeps holes; if non-numeric keys exist, they are (optionally) pushed as {key:value} elements onto the end of the array.",
+  "main": "qtools-number-keys-to-array.js",
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "author": "TQ White II",
+  "license": "ISC"
+}