qtools-library-dot-d 1.0.8 → 1.0.9

package/libDotD_Working_Example/node_modules/qtools-functional-library/lib/qtools-object-sure-path/test.js

@@ -0,0 +1,345 @@
+'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} ${thisStepMessage} (${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 = {
+		data: {
+			studentReport: {
+				rows: [
+					{
+						student: {
+							id: '7369',
+							firstName: 'Harry',
+							middleName: 'Z.',
+							lastName: 'Krazy',
+							suffix: '',
+							gender: 'Male'
+						},
+						testScores: [
+							{
+								testId: '10',
+								testName: 'MN - Accountability Tests',
+								variant: {
+									id: '10001',
+									name: 'MCA II'
+								},
+								season: {
+									id: '2901',
+									name: '2018-2019'
+								},
+								outline: {
+									id: '100001',
+									name: 'Math',
+									parentId: null,
+									level: 1
+								},
+								gradeLevel: null,
+								dateTaken: null,
+								scoreType: {
+									id: '1009',
+									name: 'Scale Score'
+								},
+								score: null,
+								altScore: null,
+								performanceScales: []
+							},
+							{
+								testId: '10',
+								testName: 'MN - Accountability Tests',
+								variant: {
+									id: '10005',
+									name: 'MCA III'
+								},
+								season: {
+									id: '2901',
+									name: '2018-2019'
+								},
+								outline: {
+									id: '100001',
+									name: 'Math',
+									parentId: null,
+									level: 1
+								},
+								gradeLevel: '05',
+								dateTaken:
+									'Sun Mar 03 2019 18:00:00 GMT-0600 (Central Standard Time)',
+								scoreType: {
+									id: '1009',
+									name: 'Scale Score'
+								},
+								score: 549,
+								altScore: null,
+								performanceScales: [
+									{
+										performanceSet: {
+											id: '1001',
+											name: 'Proficiency'
+										},
+										performanceValue: 'Partially Meets'
+									},
+									{
+										performanceSet: {
+											id: '1005',
+											name: 'Career and College Readiness'
+										},
+										performanceValue: 'N/A'
+									}
+								]
+							}
+						]
+					},
+					{
+						student: {
+							id: '9748',
+							firstName: 'Julie',
+							middleName: 'T.',
+							lastName: 'Blue',
+							suffix: '',
+							gender: 'Female'
+						},
+						testScores: [
+							{
+								testId: '10',
+								testName: 'MN - Accountability Tests',
+								variant: {
+									id: '10001',
+									name: 'MCA II'
+								},
+								season: {
+									id: '2901',
+									name: '2018-2019'
+								},
+								outline: {
+									id: '100001',
+									name: 'Math',
+									parentId: null,
+									level: 1
+								},
+								gradeLevel: null,
+								dateTaken: null,
+								scoreType: {
+									id: '1009',
+									name: 'Scale Score'
+								},
+								score: null,
+								altScore: null,
+								performanceScales: []
+							},
+							{
+								testId: '10',
+								testName: 'MN - Accountability Tests',
+								variant: {
+									id: '10005',
+									name: 'MCA III'
+								},
+								season: {
+									id: '2901',
+									name: '2018-2019'
+								},
+								outline: {
+									id: '100001',
+									name: 'Math',
+									parentId: null,
+									level: 1
+								},
+								gradeLevel: '05',
+								dateTaken:
+									'Sun Mar 03 2019 18:00:00 GMT-0600 (Central Standard Time)',
+								scoreType: {
+									id: '1009',
+									name: 'Scale Score'
+								},
+								score: 544,
+								altScore: null,
+								performanceScales: [
+									{
+										performanceSet: {
+											id: '1001',
+											name: 'Proficiency'
+										},
+										performanceValue: 'Partially Meets'
+									},
+									{
+										performanceSet: {
+											id: '1005',
+											name: 'Career and College Readiness'
+										},
+										performanceValue: 'N/A'
+									}
+								]
+							}
+						]
+					},
+					{
+						student: {
+							id: '1387',
+							firstName: 'Virtue',
+							middleName: 'H.',
+							lastName: 'RosiePosie',
+							suffix: '',
+							gender: 'Female'
+						},
+						testScores: [
+							{
+								testId: '10',
+								testName: 'MN - Accountability Tests',
+								variant: {
+									id: '10001',
+									name: 'MCA II'
+								},
+								season: {
+									id: '2901',
+									name: '2018-2019'
+								},
+								outline: {
+									id: '100001',
+									name: 'Math',
+									parentId: null,
+									level: 1
+								},
+								gradeLevel: null,
+								dateTaken: null,
+								scoreType: {
+									id: '1009',
+									name: 'Scale Score'
+								},
+								score: null,
+								altScore: null,
+								performanceScales: []
+							},
+							{
+								testId: '10',
+								testName: 'MN - Accountability Tests',
+								variant: {
+									id: '10005',
+									name: 'MCA III'
+								},
+								season: {
+									id: '2901',
+									name: '2018-2019'
+								},
+								outline: {
+									id: '100001',
+									name: 'Math',
+									parentId: null,
+									level: 1
+								},
+								gradeLevel: '05',
+								dateTaken:
+									'Sun Mar 03 2019 18:00:00 GMT-0600 (Central Standard Time)',
+								scoreType: {
+									id: '1009',
+									name: 'Scale Score'
+								},
+								score: 531,
+								altScore: null,
+								performanceScales: [
+									{
+										performanceSet: {
+											id: '1001',
+											name: 'Proficiency'
+										},
+										performanceValue: 'Does Not Meet'
+									},
+									{
+										performanceSet: {
+											id: '1005',
+											name: 'Career and College Readiness'
+										},
+										performanceValue: 'N/A'
+									}
+								]
+							}
+						]
+					}
+				]
+			}
+		}
+	};
+	
+
+	//TEST ITEM ------------------------------------------------------
+	methodName = 'qtGetSurePath';
+	thisStepMessage = 'not yet implemented';
+	thisStepResult = testArray[methodName]('data.studentReport.rows', []);
+	thisStepEvalFunction = item => item.length==3;
+	passingTests =
+		completeStep(
+			methodName,
+			thisStepMessage,
+			thisStepResult,
+			thisStepEvalFunction
+		) && passingTests;
+	
+	
+	methodName = 'qtPutSurePath';
+	thisStepMessage = 'not yet implemented';
+	thisStepResult = testArray[methodName]('data.studentReport.rows[0].student.id', 9999);
+	thisStepEvalFunction = item => item.qtGetSurePath('data.studentReport.rows[0].student.id')==9999;
+	passingTests =
+		completeStep(
+			methodName,
+			thisStepMessage,
+			thisStepResult,
+			thisStepEvalFunction
+		) && passingTests;
+	
+	
+	
+	methodName = 'qtPutSurePath';
+	thisStepMessage = 'avoid prototype polution';
+	thisStepResult = testArray[methodName]('__proto__', 9999);
+	thisStepEvalFunction = item => item.qtGetSurePath('__proto__')!=9999;
+	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-pass-through/package.json

@@ -0,0 +1,11 @@
+{
+  "name": "qtools-pass-through",
+  "version": "1.0.0",
+  "description": "executes a supplied function but never changes the value supplied",
+  "main": "qtools-pass-through.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-pass-through/qtools-pass-through.js

@@ -0,0 +1,58 @@
+'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 = 'qtPassThrough';
+		const description = `executes a supplied function; 'this' is the only parameter; if supplied function returns a value, it is returned, else 'this' is returned.`;
+		const supportedTypeList = [Object, Array, String, Number, Boolean, Date];
+
+		const method = () =>
+			function (utilityFunction) {
+				//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 utilityResult = utilityFunction(this);
+				if (utilityResult!=undefined) {
+					return utilityResult;
+				} else {
+					return this;
+				}
+			};
+
+		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-pass-through/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'}):`);
+			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'
+	];
+	
+
+	//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-pop/package.json

@@ -0,0 +1,11 @@
+{
+  "name": "qtools-pop",
+  "version": "1.0.0",
+  "description": "basically this is pop surePath.",
+  "main": "qtools-pop.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-pop/qtools-pop.js

@@ -0,0 +1,175 @@
+'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 = 'qtPop';
+		const description = `operand.qtPop() pops with an optional default argument`;
+		const supportedTypeList = [Array];
+
+		const method = () =>
+			function(defaultValue) {
+				const inData = this;
+				if (typeof inData.length == 'undefined') {
+					throw 'array.qtPop(defaultValue=undefined) works for Arrays only';
+				}
+				const arrayValue = inData.pop();
+				const result =
+					typeof arrayValue != 'undefined' ? arrayValue : defaultValue;
+				return result;
+			};
+
+		const test = args => {
+			return require('./test.js')({
+				...args,
+				...{
+					moduleName: module.id.replace(module.path, '')
+				}
+			});
+		};
+
+		return {
+			methodName,
+			description,
+			supportedTypeList,
+			method,
+			test
+		};
+	};
+	//second method definition function ==========================
+	const secondMethodFunction = commonFunctions => {
+		const methodName = 'qtLast';
+		const description = `operand.qtLast() return last element but leave it on stack) with an optional default argument`;
+		const supportedTypeList = [Array];
+
+		const method = () =>
+			function(defaultValue) {
+				const inData = this;
+				if (typeof inData.length == 'undefined') {
+					throw 'array.qtLast(defaultValue=undefined) works for Arrays only';
+				}
+				const arrayValue = inData.length?inData[inData.length-1]:void('');
+				const result =
+					typeof arrayValue != 'undefined' ? arrayValue : defaultValue;
+				return result;
+			};
+
+		return {
+			methodName,
+			description,
+			supportedTypeList,
+			method
+		};
+	};
+	//third method definition function ==========================
+	const thirdMethodFunction = commonFunctions => {
+		const methodName = 'qtPush';
+		const description = `operand.qtPush(value) pushes to the array and returns the array`;
+		const supportedTypeList = [Array];
+
+		const method = () =>
+			function(value) {
+				const inData = this;
+				if (typeof inData.length == 'undefined') {
+					throw 'array.qtPush(defaultValue=undefined) works for Arrays only';
+				}
+				
+				inData.push(value);
+				return inData;
+			};
+
+		const test = args => {
+			return require('./test.js')({
+				...args,
+				...{
+					moduleName: module.id.replace(module.path, '')
+				}
+			});
+		};
+
+		return {
+			methodName,
+			description,
+			supportedTypeList,
+			method,
+			test
+		};
+	};
+	//fourth method definition function ==========================
+	const fourthMethodFunction = commonFunctions => {
+		const methodName = 'qtFirst';
+		const description = `operand.qtFirst(value) gets element zero or default`;
+		const supportedTypeList = [Array];
+
+		const method = () =>
+			function(defaultValue) {
+				const inData = this;
+				if (typeof inData.length == 'undefined') {
+					throw 'array.qtFirst(defaultValue=undefined) works for Arrays only';
+				}
+				const arrayValue = inData[0]?inData[0]:void('');
+				const result =
+					typeof arrayValue != 'undefined' ? arrayValue : defaultValue;
+				return result;
+			};
+
+		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());
+	addFunction(secondMethodFunction());
+	addFunction(thirdMethodFunction());
+	addFunction(fourthMethodFunction());
+
+	this.addToPrototype = addToPrototypeActual(functionObject);
+	
+};
+//END OF moduleFunction() ============================================================
+module.exports = moduleFunction;
+//module.exports = new moduleFunction();