qtools-library-dot-d 1.0.8 → 1.0.9

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

@@ -0,0 +1,130 @@
+'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 testObject={
+		substitution1:'with object substitution',
+		nested:{
+			element:'replaced from a nested element'
+		}
+	}
+
+	const replaceObject={
+		fromReplaceObj:"additional replacement object substitution"
+	}
+	
+
+	//TEST ITEM ------------------------------------------------------
+	methodName = 'qtLog';
+	thisStepMessage = 'object.qtLog() message test';
+	thisStepResult = testObject[methodName](thisStepMessage, {noSuffix:true, destination:'returnString'});
+	thisStepEvalFunction = item => item==thisStepMessage;
+	passingTests =
+		completeStep(
+			methodName,
+			thisStepMessage,
+			thisStepResult,
+			thisStepEvalFunction
+		) && passingTests;
+	
+	
+	methodName = 'qtLog';
+	thisStepMessage = 'object.qtLog() message test -><!substitution1!><-';
+	thisStepResult = testObject[methodName](thisStepMessage, {noSuffix:true, destination:'returnString'});
+	thisStepEvalFunction = item => item=='object.qtLog() message test ->with object substitution<-';
+	passingTests =
+		completeStep(
+			methodName,
+			thisStepMessage,
+			thisStepResult,
+			thisStepEvalFunction
+		) && passingTests;
+	
+	
+	methodName = 'qtLog';
+	thisStepMessage = 'object.qtLog() message test -><!substitution1!><- and -><!fromReplaceObj!><-';
+	thisStepResult = testObject[methodName](thisStepMessage, {noSuffix:true, destination:'returnString', substitutions:replaceObject});
+	thisStepEvalFunction = item => item=='object.qtLog() message test ->with object substitution<- and ->additional replacement object substitution<-';
+	passingTests =
+		completeStep(
+			methodName,
+			thisStepMessage,
+			thisStepResult,
+			thisStepEvalFunction
+		) && passingTests;
+	
+	
+	methodName = 'qtLog';
+	thisStepMessage = 'object.qtLog() message test -><!nested.element!><-';
+	thisStepResult = testObject[methodName](thisStepMessage, {noSuffix:true, destination:'returnString', substitutions:testObject});
+	thisStepEvalFunction = item => item=='object.qtLog() message test ->replaced from a nested element<-';
+	passingTests =
+		completeStep(
+			methodName,
+			thisStepMessage,
+			thisStepResult,
+			thisStepEvalFunction
+		) && passingTests;
+		
+	const qt=require('../../qtools-functional-library');
+
+	methodName = 'log';
+	thisStepMessage = 'qt.log() message test -><!substitution1!><-';
+	thisStepResult = qt[methodName](thisStepMessage, {noSuffix:true, destination:'returnString', substitutions:testObject});
+	thisStepEvalFunction = item => item=='qt.log() message test ->with object substitution<-';
+	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-map-properties/package.json

@@ -0,0 +1,11 @@
+{
+  "name": "qtools-map-properties",
+  "version": "1.0.0",
+  "description": " Transform and add properties to a javascript object or array of objects",
+  "main": "qtools-map-properties.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-map-properties/qtools-map-properties.js

@@ -0,0 +1,99 @@
+'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 methodName = 'qtMapProperties';
+		const description = `operand.qtMapProperties() transforms and adds properties to a javascript object or array of objects`;
+		const supportedTypeList = [Array, Object];
+
+		const method = () =>
+			function(mappings = {}, options = {}) {
+				const mappingFunction = item => {
+					const outObj = item.qtClone();
+					const originalThis = item.qtClone();
+
+					// mappingElementFunction=(item, name, entire)=>{}; //note: synthetic elements have item==undefined
+
+					Object.keys(mappings).forEach(name => {
+						if (typeof mappings[name] == 'function') {
+							outObj[name] = mappings[name](
+								originalThis[name],
+								name,
+								originalThis
+							);
+						} else {
+							outObj[name] = mappings[name];
+						}
+					});
+					return outObj;
+				};
+
+				
+				
+				if (this instanceof Array) {
+					return this.map(item => mappingFunction(item));
+				} else {
+					return mappingFunction(this);
+				}
+				
+			};
+
+		const test = args => {
+			return require('./test.js')({
+				...args,
+				...{
+					moduleName: module.id.replace(module.path, '')
+				}
+			});
+		};
+
+		return {
+			methodName,
+			description,
+			supportedTypeList,
+			method,
+			test
+		};
+	};
+	
+	
+	const functionObject = new Map(); // prettier-ignore
+	const addFunction = definition => {
+		const {
+			methodName,
+			description,
+			supportedTypeList,
+			method,
+			test
+		} = definition;
+		functionObject.set(methodName, {
+			description,
+			supportedTypeList,
+			method,
+			test: args => {
+				return require('./test.js')({
+					...args,
+					...{
+						moduleName: module.id.replace(module.path, '')
+					}
+				});
+			}
+		});
+	};
+	
+	addFunction(firstMethodFunction());
+
+	this.addToPrototype = addToPrototypeActual(functionObject);
+	
+};
+//END OF moduleFunction() ============================================================
+module.exports = moduleFunction;
+//module.exports = new moduleFunction();

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

@@ -0,0 +1,118 @@
+'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 testObject={
+		one: 1,
+		two: 2
+	}
+	
+	const testArray=[
+	{
+		alpha: 11,
+		beta: 12
+	},{
+		alpha: 21,
+		beta: 22
+	}
+	];
+	
+	const testOneArgument={
+		one: (item, name, entire)=>item*1000
+	}
+	const testTwoArgument={
+		one: (item, name, entire)=>item*1000,
+		addedValue:(item, name, entire)=>`${name} says, item:${item} becomes ${Object.keys(entire).join(', ')}`
+	}
+	const testThreeArgument={
+		alpha: (item, name, entire)=>item*1000,
+		addedValue:(item, name, entire)=>`${name} says, item:${item} becomes ${Object.keys(entire).join(', ')}`
+	}
+// map one object 
+// map one with added property
+// map array 
+
+
+
+	//TEST ITEM ------------------------------------------------------
+	methodName='qtMapProperties'
+	thisStepMessage = "did not get map one object ";
+	thisStepResult = testObject[methodName](testOneArgument);
+	thisStepEvalFunction = item => (item.one==1000 && item.two==2);
+	passingTests =
+		completeStep(methodName, thisStepMessage, thisStepResult, thisStepEvalFunction) &&
+		passingTests;
+	
+
+	//TEST ITEM ------------------------------------------------------
+	methodName='qtMapProperties'
+	thisStepMessage = "did not map one with added property";
+	thisStepResult = testObject[methodName](testTwoArgument);
+	thisStepEvalFunction = item => (item.one==1000 && item.two==2 && item.addedValue=='addedValue says, item:undefined becomes one, two');
+	passingTests =
+		completeStep(methodName, thisStepMessage, thisStepResult, thisStepEvalFunction) &&
+		passingTests;
+	
+
+	//TEST ITEM ------------------------------------------------------
+	methodName='qtMapProperties'
+	thisStepMessage = "did not map array woth added property";
+	thisStepResult = testArray[methodName](testThreeArgument);
+	thisStepEvalFunction = item => (
+		item[0].alpha==11000 &&
+		item[0].beta==12 &&
+		item[0].addedValue=='addedValue says, item:undefined becomes alpha, beta' &&
+		item[1].alpha==21000 &&
+		item[1].beta==22 &&
+		item[1].addedValue=='addedValue says, item:undefined becomes alpha, beta'
+	);
+	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-merge/package.json

@@ -0,0 +1,11 @@
+{
+  "name": "qtools-merge",
+  "version": "1.0.0",
+  "description": "Merge objects deeply",
+  "main": "qtools-merge.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-merge/qtools-merge.js

@@ -0,0 +1,147 @@
+'use strict';
+//START OF moduleFunction() ============================================================
+var moduleFunction = function(args = {}) {
+	const { commonFunctions } = args;
+	
+	const addToPrototypeActual = functionObject => () =>
+		commonFunctions.universalAddToPrototype(commonFunctions, functionObject);
+	
+	const baseMerge = (receivingObject, sendingObject, args = {}) => {
+
+
+		const { mergeNonExistent = true } = args;
+		
+		
+			
+			if (
+				['string', 'number', 'boolean', 'function', 'date'].includes(
+					typeof sendingObject
+				)
+			) {
+				receivingObject = sendingObject;
+				return receivingObject;
+			}
+			
+			
+
+		for (var i in sendingObject) {
+			if (!sendingObject.hasOwnProperty(i)) {
+				continue;
+			}
+
+			var element = sendingObject[i];
+			
+			if (
+				['string', 'number', 'boolean', 'function', 'date'].includes(
+					typeof element
+				) ||
+				['string', 'number', 'boolean', 'function', 'date'].includes(
+					typeof receivingObject[i]
+				)
+			) {
+				receivingObject[i] = element;
+				continue;
+			}
+
+			if (
+				mergeNonExistent &&
+				(element == null || typeof element == 'undefined' || element === '')
+			) {
+				receivingObject[i] = element;
+				continue;
+			}
+
+			if (element instanceof Array) {
+				if (typeof receivingObject[i] == 'undefined') {
+					receivingObject[i] = [];
+				}
+
+				element.forEach((item, inx) => {
+					if (
+						receivingObject.qtGetSurePath(`${i}.${inx}`) &&
+						element.qtGetSurePath(`${inx}`)
+					) {
+						
+						receivingObject[i][inx] = baseMerge(
+							receivingObject[i][inx],
+							element[inx],
+							args
+						);
+					} else if (element.qtGetSurePath(`${inx}`)) {
+						receivingObject[i][inx] = element[inx];
+					} 
+					
+				});
+				
+				continue;
+			}
+
+			if (element instanceof Object) {
+				if (typeof receivingObject[i] == 'undefined') {
+					receivingObject[i] = {};
+				}
+
+				receivingObject[i] = baseMerge(receivingObject[i], element, args);
+				continue;
+			}
+		}
+
+		return receivingObject;
+	};
+	
+	//first method definition function ==========================
+	const firstMethodFunction = commonFunctions => {
+		const functionObject = new Map(); // prettier-ignore
+
+		const methodName = 'qtMerge';
+		const description = `Deep merge of two objects. Clones by default. receivingObject.qtMerge(sendingObject, {mutateObjects:false, mergeNonExistent:true}). DOESN'T YET WORK FOR MAPS OR SETS.`;
+		const supportedTypeList = [Object];
+
+		const method = () =>
+			function(sendingObject, args = {}) {
+				//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(', ')})`
+					);
+				}
+
+				const { mutateObjects = false } = args;
+
+				let receivingObject = this;
+
+				if (!mutateObjects) {
+					receivingObject = this.qtClone();
+					sendingObject = sendingObject.qtClone();
+				}
+
+				const outObj = baseMerge(receivingObject, sendingObject, args);
+
+				return outObj;
+			};
+
+		functionObject.set(methodName, {
+			description,
+			supportedTypeList,
+			method,
+			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();