qtools-library-dot-d 1.0.8 → 1.0.10

package/libDotD_Working_Example/node_modules/qtools-functional-library/lib/qtools-clone/package.json

@@ -0,0 +1,11 @@
+{
+  "name": "qtools-clone",
+  "version": "1.0.0",
+  "description": "Deep clone of a javascript object, returns new object.",
+  "main": "qtools-clone.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-clone/qtools-clone.js

@@ -0,0 +1,103 @@
+'use strict';
+//START OF moduleFunction() ============================================================
+var moduleFunction = function(args = {}) {
+	const { commonFunctions } = args;
+	
+	const addToPrototypeActual = functionObject => () =>
+		commonFunctions.universalAddToPrototype(commonFunctions, functionObject);
+	
+	const cloneObject=function(func) {
+		const inObj=this;
+		let convertFunction =
+			typeof func == 'function'
+				? func
+				: function(inData) {
+						return inData;
+					};
+
+		if (
+			['string', 'number', 'boolean', 'undefined'].indexOf(typeof inObj) > -1 ||
+			inObj === null
+		) {
+			return convertFunction(inObj);
+		}
+
+		if (commonFunctions.toType(inObj) == 'null') {
+			return convertFunction(inObj);
+		}
+
+		if (!newObj) {
+			if (commonFunctions.toType(inObj) == 'array') {
+				var newObj = [];
+			} else {
+				var newObj = {};
+			}
+		}
+
+		if (commonFunctions.toType(inObj) != 'array') {
+			for (var i in inObj) {
+				//I rescinded the numericToArray() prototype function that required this.
+				// 				if (typeof(inObj.hasOwnProperty)=='function' && !inObj.hasOwnProperty(i)){
+				// 					continue;
+				// 				}
+				if (inObj[i] !== null && typeof inObj[i] == 'object') {
+					switch (inObj[i].constructor) {
+						case Date:
+							newObj[i] = convertFunction(new Date(inObj[i].toString()));
+							break;
+						default:
+							newObj[i] = inObj[i].qtClone(func);
+							break;
+					}
+				} else {
+					newObj[i] = convertFunction(inObj[i]);
+					//console.log("OO inObj[i]="+inObj[i]);
+				}
+			}
+		} else {
+			for (var i = 0, len = inObj.length; i < len; i++) {
+				if (commonFunctions.toType(inObj[i]) == 'object') {
+					newObj[i] = inObj[i].qtClone(func);
+				} else {
+					newObj[i] = convertFunction(inObj[i]);
+					//console.log("AA inObj[i]="+inObj[i]);
+				}
+			}
+		}
+
+		return newObj;
+	};
+	
+	//first method definition function ==========================
+	const firstMethodFunction = commonFunctions => {
+		const functionObject = new Map(); // prettier-ignore
+		
+		const methodName = 'qtClone';
+		const description = `Deep clone of JS object for pass by value`;
+		const supportedTypeList = [Object, Array];
+
+		const method = () =>cloneObject;
+
+		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();

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

@@ -0,0 +1,78 @@
+'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 referencedObject={
+		string:'hello',
+		object:{
+			hello:'goodbye'
+		},
+		array:[
+			{
+				a:'b',
+				c:'d'
+			}
+		]
+	}
+
+	const testArray = referencedObject;
+	
+
+	//TEST ITEM ------------------------------------------------------
+	methodName='qtClone'
+	thisStepMessage = "not yet implemented";
+	thisStepResult = testArray[methodName]();
+	thisStepEvalFunction = item => {
+		item.string='hola'
+		return referencedObject.string!='hola'
+	};
+	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-get-by-property/package.json

@@ -0,0 +1,11 @@
+{
+  "name": "qtools-get-by-property",
+  "version": "1.0.0",
+  "description": "method of array that contains objects, parameters are a dotted string representing the path to the value for comparison and a match value, returns the object with a mathcing property\"",
+  "main": "qtools-get-by-property.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-get-by-property/qtools-get-by-property.js

@@ -0,0 +1,73 @@
+'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 = 'qtGetByProperty';
+		const description = `objectArray.getByProperty('path.into.objects[3].property', 'matchValue', 'optionalDefault') returns array of elements with path value==match value or default`;
+		const supportedTypeList = [Object];
+
+		const method = () =>
+			function(
+		propertyName,
+		propertyValue,
+		defaultValue
+	) {
+	
+		const inData=this;
+		const isRegExp = propertyValue instanceof RegExp;
+		let outList = [];
+		if (inData.length) {
+			var len = inData.length;
+			var inx = 0;
+			for (inx = 0; inx < len; inx++) {
+				const item = inData[inx].qtGetSurePath(propertyName);
+				if (item == propertyValue || (isRegExp && item.match(propertyValue))) {
+					outList.push(inData[inx]);
+				}
+			}
+		} else if (typeof inData == 'object') {
+			for (var inx in inData) {
+				const item = inData[inx].qtGetSurePath(propertyName);
+				if (item == propertyValue || (isRegExp && item.match(propertyValue))) {
+					outList.push(inData[inx]);
+				}
+			}
+		}
+		
+		if (defaultValue && outList.length===0){
+			outList=defaultValue;
+		}
+		
+		return outList;
+	};
+
+		const functionObject = new Map(); // prettier-ignore
+		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();

package/libDotD_Working_Example/node_modules/qtools-functional-library/lib/qtools-get-by-property/test.js

@@ -0,0 +1,129 @@
+'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 = [
+		{
+			a: {
+				animal: 'fish',
+				eatsWith: 'straw',
+				color: 'red'
+			}
+		},
+		{
+			a: {
+				animal: 'snake',
+				eatsWith: 'straw',
+				color: 'blue'
+			}
+		},
+		{
+			a: {
+				animal: 'bird',
+				eatsWith: 'teeth',
+				color: 'red'
+			}
+		},
+		{
+			a: {
+				animal: 'bird',
+				eatsWith: 'chopsticks',
+				color: 'red'
+			}
+		},
+		{
+			a: {
+				animal: 'bird',
+				eatsWith: 'teeth',
+				color: 'red'
+			}
+		}
+	];
+	
+
+	methodName='qtGetByProperty'
+	
+	//TEST ITEM ------------------------------------------------------
+	thisStepMessage = "couldn't find all red ones";
+	thisStepResult = testArray[methodName]('a.color', 'red');
+	thisStepEvalFunction = item => item.length == 4;
+	passingTests =
+		completeStep(methodName, thisStepMessage, thisStepResult, thisStepEvalFunction) &&
+		passingTests;
+	
+	//TEST ITEM ------------------------------------------------------
+	thisStepMessage = "did not get default value when search value was not presesnt";
+	thisStepResult = testArray[methodName]('a.color', 'snake', 'pumpkins');
+	thisStepEvalFunction = item => item == 'pumpkins';
+	passingTests =
+		completeStep(methodName, thisStepMessage, thisStepResult, thisStepEvalFunction) &&
+		passingTests;
+	
+	//TEST ITEM ------------------------------------------------------
+	thisStepMessage = 'did not find correct object with dotted path criterion';
+	thisStepResult = testArray[methodName]('a.color', 'blue', 'pumpkins');
+	thisStepEvalFunction = item =>
+		item.length == 1 &&
+		item[0].a.animal == 'snake' &&
+		item[0].a.eatsWith == 'straw' &&
+		item[0].a.color == 'blue';
+	passingTests =
+		completeStep(methodName, thisStepMessage, thisStepResult, thisStepEvalFunction) &&
+		passingTests;
+	
+	//TEST ITEM ------------------------------------------------------
+	thisStepMessage =
+		'did not return empty array when search value was present and there was no default';
+	thisStepResult = testArray[methodName]('a.color', 'monkee');
+	thisStepEvalFunction = item => item.length === 0;
+	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-includes-regex/package.json

@@ -0,0 +1,11 @@
+{
+  "name": "qtools-includes-regex",
+  "version": "1.0.0",
+  "description": "array prototype enhancment treats string values as regular express",
+  "main": "qtools-includes-regex.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-includes-regex/qtools-includes-regex.js

@@ -0,0 +1,54 @@
+'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 = 'qtIncludesRegex';
+		const description = `qtIncludesRegex(RegExp): returns true if element.match(RegExp)==true for any element`;
+		const supportedTypeList = [Object];
+
+		const method = () =>
+			function(needle) {
+				if (needle instanceof RegExp) {
+					const haystack = this;
+					let found = false;
+					haystack.forEach(item => {
+						found = found || item.match(needle) ? true : false;
+					});
+					return found;
+				} else {
+					return haystack.includes(needle);
+				}
+			};
+
+		const functionObject = new Map(); // prettier-ignore
+		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();

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

@@ -0,0 +1,76 @@
+'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'
+	];
+	
+	methodName='qtIncludesRegex'
+
+	//TEST ITEM ------------------------------------------------------
+	thisStepMessage = "Did not find correct element";
+	thisStepMessage = "not yet implemented";
+	thisStepResult = testArray[methodName](/^H/);
+	thisStepEvalFunction = item => 'allocute';
+	passingTests =
+		completeStep(methodName, thisStepMessage, thisStepResult, thisStepEvalFunction) &&
+		passingTests;
+	
+	
+	//TEST ITEM ------------------------------------------------------
+	thisStepMessage = "found element that it should not have";
+	thisStepResult = testArray[methodName](/H.ll./);
+	thisStepEvalFunction = item => 'Hello';
+	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-log-output/package.json

@@ -0,0 +1,11 @@
+{
+  "name": "qtools-log-output",
+  "version": "1.0.0",
+  "description": "operates stdin and stderr for logging and output",
+  "main": "qtools-log-output.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-log-output/qtools-log-output.js

@@ -0,0 +1,114 @@
+'use strict';
+//START OF moduleFunction() ============================================================
+var moduleFunction = function(args = {}) {
+	const { commonFunctions } = args;
+
+	//qtAddCallableMethods ============================================================
+	const qtLog_AddCallableMethods = {
+		description: `internal function not for civilian use`,
+		suppressHelpListing: true,
+		supportedTypeList: [Object],
+		test: args => {
+			return require('./test.js')({
+				...args,
+				...{
+					moduleName: module.id.replace(module.path, '')
+				}
+			});
+		},
+
+		method: commonFunctions =>
+			function(permissionValue = '') {
+				if (
+					permissionValue != "what part of 'not for civilian use' is unclear?"
+				) {
+					return;
+				}
+
+				this.log = function(message, options = {}) {
+					options.suffixCallStackDepth = options.suffixCallStackDepth?options.suffixCallStackDepth:4;
+					return ({}.qtLog(message, options));
+				};
+
+				return this;
+			}
+	};
+
+	//qtLog ============================================================
+	const qtLog = {
+		description: `[ANY TYPE].qtLog() outputs to stderr (console.error()) or stdout (console.log())`,
+		supportedTypeList: [
+			Object,
+			String,
+			Number,
+			Set,
+			Map,
+			Boolean,
+			Symbol,
+			Function,
+			BigInt,
+			BigInt64Array
+		],
+		test: args => {
+			return require('./test.js')({
+				...args,
+				...{
+					moduleName: module.id.replace(module.path, '')
+				}
+			});
+		},
+
+		method: commonFunctions =>
+			function(message, options = {}) {
+				const inData = this;
+				const {
+					noSuffix = false,
+					label = '',
+					substitutions = {},
+					destination = 'stderr',
+					removeFromSuffix,
+					replacementForSuffix='...'
+				} = options;
+
+				const callerName = commonFunctions.callerName(true, options);
+
+				const showLabel = label.replace(/\n/g, '');
+				let suffix = noSuffix ? '' : ` [${callerName}]`;
+				
+				if (removeFromSuffix){
+					suffix=suffix.replace(new RegExp(removeFromSuffix), replacementForSuffix);
+				}
+				
+				
+				const outputMessage =
+					message
+						.qtTemplateReplace(typeof this == 'object' ? this : {})
+						.qtTemplateReplace(substitutions) + suffix;
+
+				if (['stderr'].includes(destination)) {
+					console.error(outputMessage);
+				} else if (['stdout'].includes(destination)) {
+					console.log(outputMessage);
+				} else if (['returnString'].includes(destination)) {
+					return outputMessage;
+				}
+
+				return this;
+			}
+	};
+
+	//intitialize context ============================================================
+
+	const functionObject = new Map();
+
+	functionObject.set('qtLog_AddCallableMethods', qtLog_AddCallableMethods);
+	functionObject.set('qtLog', qtLog);
+
+	//this has commonFunctions twice because I don't want new thing() or to have an extra function to make it available.
+	const addToPrototypeActual = functionObject => () =>
+		commonFunctions.universalAddToPrototype(commonFunctions, functionObject);
+	this.addToPrototype = addToPrototypeActual(functionObject);
+};
+//END OF moduleFunction() ============================================================
+module.exports = moduleFunction;
+//module.exports = new moduleFunction();