qtools-library-dot-d 1.0.8 → 1.0.9

package/libDotD_Working_Example/node_modules/qtools-functional-library/lib/qtools-pop/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 testArray = [
+		'allocute',
+		'Hello'
+	];
+	const emptyArray = [];
+	
+
+	//TEST ITEM ------------------------------------------------------
+	methodName='qtPop'
+	thisStepMessage = "did not get the most recently added element";
+	thisStepResult = testArray[methodName]();
+	thisStepEvalFunction = item => item=='Hello';
+	passingTests =
+		completeStep(methodName, thisStepMessage, thisStepResult, thisStepEvalFunction) &&
+		passingTests;
+	
+	
+	
+	//TEST ITEM ------------------------------------------------------
+	methodName='qtPop'
+	thisStepMessage = "did not get the most recently added element";
+	thisStepResult = emptyArray[methodName]('default value');
+	thisStepEvalFunction = item => item=='default value';
+	passingTests =
+		completeStep(methodName, thisStepMessage, thisStepResult, thisStepEvalFunction) &&
+		passingTests;
+	
+	
+
+	//TEST ITEM ------------------------------------------------------
+	methodName='qtLast'
+	thisStepMessage = "did not get the most recently added element";
+	thisStepResult = testArray[methodName]();
+	thisStepEvalFunction = item => (item=='Hello' && item.length==2);
+	passingTests =
+		completeStep(methodName, thisStepMessage, thisStepResult, thisStepEvalFunction) &&
+		passingTests;
+	
+	
+	
+	//TEST ITEM ------------------------------------------------------
+	methodName='qtLast'
+	thisStepMessage = "did not get the most recently added element";
+	thisStepResult = emptyArray[methodName]('default value');
+	thisStepEvalFunction = item => (item=='default value' && item.length==2);
+	passingTests =
+		completeStep(methodName, thisStepMessage, thisStepResult, thisStepEvalFunction) &&
+		passingTests;
+	
+	//TEST ITEM ------------------------------------------------------
+	methodName='qtPush'
+	thisStepMessage = "element was not added";
+	thisStepResult = emptyArray[methodName]('test value');
+	thisStepEvalFunction = item => (item=>item.qtPop()=='test value');
+	passingTests =
+		completeStep(methodName, thisStepMessage, thisStepResult, thisStepEvalFunction) &&
+		passingTests;
+	
+	//TEST ITEM ------------------------------------------------------
+	methodName='qtFirst'
+	thisStepMessage = "element was not added";
+	thisStepResult = testArray[methodName]();
+	thisStepEvalFunction = item => (item=='allocute' && item.length==2);
+	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-print-debug/package.json

@@ -0,0 +1,11 @@
+{
+  "name": "qtools-print-debug",
+  "version": "1.0.0",
+  "description": "various print functions for debugging purposes",
+  "main": "qtools-print-debug.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-print-debug/qtools-print-debug.js

@@ -0,0 +1,352 @@
+'use strict';
+const util = require('util');
+//START OF moduleFunction() ============================================================
+var moduleFunction = function(args = {}) {
+	const { commonFunctions } = args;
+
+	const addToPrototypeActual = functionObject => () =>
+		commonFunctions.universalAddToPrototype(commonFunctions, functionObject);
+
+	function qtDump(args = {}) {
+		const inData = this;
+		let label = '';
+		let returnString = false;
+		let addSeparators = false;
+		let outputFunction;
+		let noSuffix = false; //suppresses suffix if true
+		let callerName = commonFunctions.callerName(true);
+		let separator = '';
+		let returnn = '';
+		let showLabel = '';
+		let suffix = '';
+		let cancelDump = args.cancelDump ? args.cancelDump : false;
+
+		if (cancelDump) {
+			return this;
+		}
+
+		const recursionDepth =
+			typeof args.recursionDepth != 'undefined' ? args.recursionDepth : null;
+		const addCliColors =
+			typeof args.addCliColors != 'undefined' ? args.recursionDepth : true;
+
+		if (typeof args == 'object') {
+			label = args.label ? args.label : '';
+			returnString = args.returnString ? args.returnString : false;
+			addSeparators = args.addSeparators ? args.addSeparators : false;
+			noSuffix = args.noSuffix ? args.noSuffix : false;
+			callerName = commonFunctions.callerName(true);
+			separator = addSeparators ? '\n--------\n' : '';
+			returnn = addSeparators ? '\n' : ' ';
+			showLabel = label.replace(/\n/g, '');
+			suffix = noSuffix ? '' : ` [${returnn}[${callerName}]${separator}]`;
+			outputFunction = args.outputFunction
+				? args.outputFunction
+				: console.error;
+		} else if (typeof args == 'string') {
+			label = args;
+			showLabel = label.replace(/\n/g, '');
+		}
+
+		if (['string', 'number', 'boolean'].includes(typeof this)) {
+			if (returnString) {
+				return `${this}${suffix}`;
+			} else {
+				let outString = this;
+				let suffixx = '';
+				const disassesmbleString = this.match(/(\n*)$/);
+				if (disassesmbleString[0]) {
+					suffixx = disassesmbleString[0];
+					outString = outString.replace(disassesmbleString[0], '');
+				}
+
+				outputFunction(
+					`${separator}${label ? showLabel + '= ' : ''}${outString} ${suffix}`
+				);
+			}
+		} else if (['function'].includes(typeof this)) {
+			if (returnString) {
+				return this.toString() + suffix;
+			} else {
+				outputFunction(
+					`${separator}${
+						label ? showLabel + `=${returnn}` : ''
+					}${returnn}${this}${returnn}${suffix}`
+				);
+			}
+		} else {
+			let tmpObject = inData;
+			if (label) {
+				tmpObject = { [label]: inData };
+			}
+
+			if (returnString) {
+				return (
+					util.inspect(tmpObject, {
+						depth: recursionDepth,
+						maxArrayLength: null,
+						colors: addCliColors
+					}) + ` [${suffix}]`
+				);
+			} else {
+				outputFunction(
+					`${separator}${label ? showLabel + `:${returnn}` : ''}${util.inspect(
+						inData,
+						{
+							depth: recursionDepth,
+							colors: addCliColors
+						}
+					)} ${suffix}`
+				);
+			}
+		}
+		return this;
+	}
+
+	function qtListProperties(args = {}) {
+		const inObject = this;
+		const {
+			label = '',
+			returnString = false,
+			maxShowStringLength = 100
+		} = args;
+
+		var outString = label ? `${label}:\n` : '';
+		var list = [];
+		var count = 0;
+		var type = commonFunctions.toType(inObject);
+
+		if (type == 'object' || type == 'arguments') {
+			var outList = [];
+			for (var i in inObject) {
+				var element = inObject[i];
+				var hadProperties = true;
+				var showElement;
+				if (
+					['object', 'array', 'function', 'map'].indexOf(
+						commonFunctions.toType(element)
+					) == -1
+				) {
+					if (element == null) {
+						showElement = 'null'.green;
+					} else {
+						if (element.length > maxShowStringLength) {
+							element =
+								element.substr(0, maxShowStringLength) +
+								' ... (length=' +
+								element.length +
+								', use maxShowStringLength)';
+						}
+						if (returnString) {
+							showElement = element.toString();
+						} else {
+							showElement = element.toString();
+						}
+					}
+					if (returnString) {
+						var tmp =
+							'item #' +
+							count +
+							" named '" +
+							i +
+							"' is a " +
+							commonFunctions.toType(element) +
+							' value= ' +
+							showElement;
+					} else {
+						var tmp =
+							'item #' +
+							count +
+							" named '" +
+							i +
+							"' is a " +
+							commonFunctions.toType(element) +
+							' value= ' +
+							showElement;
+					}
+					outList.push({ name: i, string: tmp });
+				} else {
+					if (returnString) {
+						var tmp =
+							'item #' +
+							count +
+							" named '" +
+							i +
+							"' is a " +
+							commonFunctions.toType(element) +
+							(commonFunctions.toType(element) == 'array'
+								? ` length= ${element.length}`
+								: '');
+					} else {
+						var tmp =
+							'item #' +
+							count +
+							" named '" +
+							i +
+							"' is a " +
+							commonFunctions.toType(element) +
+							(commonFunctions.toType(element) == 'array'
+								? ` length= ${element.length}`
+								: '');
+					}
+					outList.push({ name: i, string: tmp });
+				}
+				count++;
+			}
+
+			outList = outList.sort(commonFunctions.byObjectProperty('name'));
+
+			for (var i = 0, len = outList.length; i < len; i++) {
+				var element = outList[i];
+
+				outString += `\t${element.string}\n`;
+			}
+		} else if (type == 'array') {
+			for (var i = 0, len = list.length; i < len; i++) {
+				var element = inObject[i];
+				var hadProperties = true;
+
+				outString +=
+					'item #' +
+					count +
+					" index '" +
+					i +
+					' is ' +
+					commonFunctions.toType(element) +
+					'length= ' +
+					element.length +
+					'\n';
+
+				count++;
+			}
+		} else if (type == 'map') {
+			var hadProperties = false;
+			var outList = [];
+			inObject.forEach((element, i, all) => {
+				hadProperties = true;
+
+				var showElement;
+				if (
+					['object', 'array', 'function', 'map'].indexOf(
+						commonFunctions.toType(element)
+					) == -1
+				) {
+					if (element == null) {
+						showElement = 'null'.green;
+					} else {
+						if (element.length > maxShowStringLength) {
+							element =
+								element.substr(0, maxShowStringLength) +
+								' ... (length=' +
+								element.length +
+								')';
+						}
+						if (returnString) {
+							showElement = element.toString();
+						} else {
+							showElement = element.toString();
+						}
+					}
+					if (returnString) {
+						var tmp =
+							'item #' +
+							count +
+							" named '" +
+							i +
+							"' is a " +
+							commonFunctions.toType(element) +
+							' value= ' +
+							showElement;
+					} else {
+						var tmp =
+							('item #' + count + " named '").grey +
+							i.red +
+							"' is a ".grey +
+							commonFunctions.toType(element).red +
+							' value= '.grey +
+							showElement;
+					}
+					outList.push({ name: i, string: tmp });
+				} else {
+					if (returnString) {
+						var tmp =
+							'item #' +
+							count +
+							" named '" +
+							i +
+							"' is a " +
+							commonFunctions.toType(element);
+					} else {
+						var tmp =
+							('item #' + count + " named '").grey +
+							i.red +
+							"' is a ".grey +
+							commonFunctions.toType(element).red;
+					}
+					outList.push({ name: i, string: tmp });
+				}
+				count++;
+			});
+
+			outList = outList.sort(commonFunctions.byObjectProperty('name'));
+
+			for (var i = 0, len = outList.length; i < len; i++) {
+				var element = outList[i];
+
+				outString += `\t${element.string}\n`;
+			}
+		} else {
+			if (!returnString) {
+				var message =
+					"commonFunctions.listProperties says, input was of not an object or array. It was type '" +
+					commonFunctions.toType(inObject) +
+					"'";
+				console.error(message);
+				var hadProperties = true; //don't need no properties message
+			}
+		}
+		if (!hadProperties) {
+			if (!returnString) {
+				console.error('input had no properties');
+			}
+		}
+		if (!returnString) {
+			console.error(outString);
+			return this;
+		} else {
+			return outString;
+		}
+	}
+
+	//first method definition function ==========================
+	const firstMethodFunction = commonFunctions => {
+		const functionObject = new Map(); // prettier-ignore
+
+		functionObject.set('qtDump', {
+			description: `placeholder`,
+			supportedTypeList: [Object],
+			method: () => qtDump
+		});
+
+		functionObject.set('qtListProperties', {
+			description: `placeholder`,
+			supportedTypeList: [Object],
+			method: () => qtListProperties,
+			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-print-debug/test.js

@@ -0,0 +1,77 @@
+'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}:`);
+			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 = {
+				animal: 'bird',
+				eatsWith: 'teeth',
+				color: 'red',
+				list:[1,2,3]
+			};
+	
+
+	//TEST ITEM ------------------------------------------------------
+	methodName='qtDump'
+	thisStepMessage = "not yet implemented";
+	thisStepResult = testArray[methodName]({returnString:true});
+	thisStepEvalFunction = item => typeof(item)=='string';
+	passingTests =
+		completeStep(methodName, thisStepMessage, thisStepResult, thisStepEvalFunction) &&
+		passingTests;
+	
+	
+	methodName='qtListProperties'
+	thisStepMessage = "not yet implemented";
+	thisStepResult = testArray[methodName]({returnString:true});
+	thisStepEvalFunction = item => typeof(item)=='string';
+	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-select-properties/package.json

@@ -0,0 +1,11 @@
+{
+  "name": "qtools-select-properties",
+  "version": "1.0.0",
+  "description": "Create new objects (or list of objects) containing only the enumerated properties. Allows defaults to be supplied for missing properties. If an enumerated property name does not exist at all, a property with the default value is created.",
+  "main": "qtools-select-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-select-properties/qtools-select-properties.js

@@ -0,0 +1,132 @@
+'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 = 'qtSelectProperties';
+		const description = `operand.qtSelectProperties(value) create snew objects (or list of objects) containing only the enumerated properties. Allows defaults to be supplied for missing properties. If an enumerated property name does not exist at all, a property with the default value is created.`;
+		const supportedTypeList = [Array, Object];
+
+		const method = () =>
+			function(keepers, options = {}) {
+				
+				const {
+					moreDefaultValues = {},
+					omitUndefined = true,
+					excludeMode = false
+				} = options;
+
+				if (!(keepers instanceof Object)) {
+					throw new Error(
+						'qtSelectProperties() argument one must be instance of Object or Array'
+					);
+				}
+
+				let inclusions = keepers;
+				let defaultValues = {};
+				if (!(keepers instanceof Array)) {
+					inclusions = Object.keys(keepers);
+					defaultValues = keepers;
+				}
+				
+				Object.keys(moreDefaultValues).forEach(
+					name => (defaultValues[name] = moreDefaultValues[name])
+				);
+
+				const selectingFunction = currentObject => {
+					const getDefault = (currentObject, keeperName) =>
+						typeof defaultValues[keeperName] == 'function'
+							? defaultValues[keeperName](currentObject.qtClone(), keeperName)
+							: defaultValues[keeperName];
+
+					// defaultFunction=(currentObject, elementName)=>{}
+
+					let outObj = {};
+
+					if (!excludeMode) {
+						inclusions.forEach(keeperName => {
+							const newValue =
+								typeof currentObject[keeperName] != 'undefined'
+									? currentObject[keeperName]
+									: getDefault(currentObject, keeperName);
+							if (typeof newValue != 'undefined' || !omitUndefined) {
+								outObj[keeperName] = newValue;
+							}
+						});
+					} else {
+						outObj = currentObject;
+						inclusions.forEach(keeperName => {
+							if (typeof (outObj[keeperName] == 'undefined')) {
+								delete outObj[keeperName];
+							}
+						});
+					}
+
+					return outObj;
+				};
+				
+
+				if (this instanceof Array) {
+					return this.map(item => selectingFunction(item));
+				} else {
+					return selectingFunction(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();