qtools-library-dot-d 1.0.12 → 1.0.13

package/libDotD_Working_Example/node_modules/qtools-functional-library/qtools-functional-library.js

@@ -1,271 +0,0 @@
-const commonFunctions = {
-	universalAddToPrototype: (commonFunctions, functionObject) => {
-		let methods = [];
-		let documentation = [];
-		let methodName;
-		let testList = [];
-		functionObject.forEach((functionItem, inx) => {
-			methodName = inx;
-
-			const supportedTypeList = functionItem.supportedTypeList
-				.map(item => item.toString().replace(/^function (.*?)\(.*$/, '$1'))
-				.join(', ')
-				.replace(/, $/, '');
-
-			if (functionItem.test && typeof functionItem.test == 'function') {
-				testList.push({ methodName, test: functionItem.test });
-			}
-
-			methods.push(methodName);
-			documentation.push({
-				name: methodName,
-				description: `${functionItem.description}`,
-				supportedTypeList
-			});
-
-			functionItem.supportedTypeList.forEach(target => {
-				if (typeof target.prototype[methodName] == 'undefined') {
-					Object.defineProperty(target.prototype, methodName, {
-						value: functionItem.method(commonFunctions),
-						writable: false,
-						enumerable: false
-					});
-				}
-			});
-		});
-		const testActual=methodName=>(args) => {
-			const tmp = testList.reduce((passingTests, testItem, inx) => {
-
-				if (typeof(args.methodList)!='undefined' && args.methodList.length>0 && !args.methodList.includes(methodName)){
-					return true;
-				}
-
-				const result=passingTests && testItem.test(args) ? true : false;
-
-
-				if (args.listTests){
-					console.log(`${methodName} ${result?'passed':'failed'}`);
-				}
-				
-				return result //calls test method passed from functional module
-			}, true);
-			return tmp;
-		};
-		
-		
-		const test = testActual(methodName);
-
-		return {
-			methods,
-			documentation,
-			test
-		};
-	},
-
-	callerName: (calledFromQtLib = false, options={}) => {
-		if (typeof(options)!='object'){
-			throw(`qtools-functional-library.js internal error: options must be an object, got '${options}'`);
-		}
-		options.suffixCallStackDepth=options.suffixCallStackDepth?options.suffixCallStackDepth:3;
-	
-
-		const index = calledFromQtLib ? options.suffixCallStackDepth : 2; //the 1 might need adjusting once this is made available to applications
-		return new Error().stack
-			.split(/\n/)[index]
-			.trim()
-			.replace(/at new moduleFunction/, "called from")
-			.replace(/Object\.<anonymous>/, 'not_in_function');
-	},
-
-	toType: function(obj) {
-		
-		if (obj instanceof Map) {
-			return 'map';
-		}
-		if (obj instanceof Set) {
-			return 'set';
-		}
-
-		if (typeof obj == 'string') {
-			return 'string';
-		}
-
-		if (typeof obj == 'number') {
-			return 'number';
-		}
-
-		if (typeof obj == 'obj' && typeof length == 'number') {
-			return 'array';
-		}
-		
-		if (obj === null) {
-			return 'null';
-		}
-
-		if (typeof obj == 'undefined') {
-			return 'undefined';
-		}
-
-		if (typeof obj == 'string') {
-			return 'string';
-		}
-
-		return {}.toString
-			.call(obj)
-			.match(/\s([a-z|A-Z]+)/)[1]
-			.toLowerCase();
-	},
-
-	byObjectProperty: function(fieldName, transformer) {
-		//called: resultArray=someArray.sort(qtools.byObjectProperty('somePropertyName'));
-		//based on closure of fieldName
-		var fullNameSort;
-		return (fullNameSort = function(a, b) {
-			var localFieldName = fieldName;
-			var localTransformer = transformer;
-			//for debug
-			if (typeof fieldName == 'function') {
-				var aa = a;
-				var bb = b;
-				transformer = fieldName;
-			} else {
-				var aa = a.qtGetSurePath(fieldName);
-				var bb = b.qtGetSurePath(fieldName);
-			}
-
-			if (typeof transformer == 'function') {
-				aa = transformer(aa);
-				bb = transformer(bb);
-			} else if (transformer) {
-				switch (transformer) {
-					case 'caseInsensitive':
-						aa = aa.toLowerCase();
-						bb = bb.toLowerCase();
-						break;
-					default:
-						console.log(
-							'qt.byObjectProperty says, No such transformer as: ' + transformer
-						);
-						break;
-				}
-			}
-
-			if (!bb && !aa) {
-				return 0;
-			}
-			if (!bb) {
-				return -1;
-			}
-			if (!aa) {
-				return 1;
-			}
-
-			if (aa > bb) {
-				return 1;
-			}
-			if (aa < bb) {
-				return -1;
-			}
-			return 0;
-		});
-	},
-	
-	
-	isSupportedType: (input, supportedTypeList) =>
-		supportedTypeList.reduce((result, supportedTypeItem) => {
-			return (
-				result || Object.getPrototypeOf(input) === supportedTypeItem.prototype
-			); //instoanceof does not work for strings and numbers
-		}, false)
-};
-
-// Array.prototype.remove = function(from, to) {
-// 	var rest = this.slice((to || from) + 1 || this.length);
-// 	this.length = from < 0 ? this.length + from : from;
-// 	return this.push.apply(this, rest);
-// };
-
-String.prototype.toCamelCase = function(delimiter, pascalCase) {
-	var firstCharFunction = pascalCase
-		? function(v) {
-				return v.toUpperCase();
-			}
-		: function(v) {
-				return v.toLowerCase();
-			};
-	delimiter = delimiter ? delimiter : ' ';
-	return this.split(delimiter)
-		.map(function(word) {
-			var first = word.substring(0, 1);
-			word = word.replace(new RegExp(first), first.toUpperCase());
-			return word;
-		})
-		.join('')
-		.replace(/^(.)/, firstCharFunction);
-};
-
-const docList = [];
-const testList = [];
-
-const addMorePrototypes = () => {
-	const fs = require('fs');
-	const path = require('path');
-	const libDir = path.join(path.dirname(module.filename), 'lib');
-	const dirList = fs.readdirSync(libDir);
-
-	dirList.forEach(item => {
-		if (item.match(/^qtools/)) {
-			const moduleGen = require(path.join(libDir, item));
-			const module = new moduleGen({ commonFunctions });
-			const result = module.addToPrototype();
-			result.documentation && docList.push(result.documentation);
-			result.test && testList.push(result.test);
-		}
-	});
-};
-
-addMorePrototypes();
-
-const helpActual = docList => (options={}) => {
-
-	const {printOutput=true, sendJson=false, queryString='.*'}=options;
-
-	let rawList;
-	if (!queryString) {
-		rawList = docList;
-	} else {
-		rawList = docList.filter(item => {
-			const regex = new RegExp(queryString, 'i');
-			const result = JSON.stringify(item).match(regex);
-			return result;
-		});
-	}
-
-	let outArray=[];
-	rawList.forEach(item=>{
-		outArray=outArray.concat(item);
-	});
-	
-	const outString='<!name!>: <!description!> (<!supportedTypeList!>) '.qtTemplateReplace(outArray).join('\n');
-
-	if (printOutput){
-		console.log(outString);	
-	}
-	return outString;
-};
-
-const testActual = testList => (args={}) => {
-	return testList.reduce((result, test) => {
-		if (typeof test == 'function') {
-			result = test(args) && result; //executes the framework testItem.test() above
-		}
-		return result;
-	}, true);
-};
-
-commonFunctions.qtLog_AddCallableMethods("what part of 'not for civilian use' is unclear?");
-
-commonFunctions.help = helpActual(docList);
-commonFunctions.test = testActual(testList);
-module.exports = commonFunctions;
-

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

@@ -1,47 +0,0 @@
-#!/usr/local/bin/node
-'use strict';
-
-const qt = require('./qtools-functional-library.js');
-
-//console.dir(qt.help());
-const verbose=process.argv.filter(item=>item.match(/verbose/i))[0]?true:false
-const logErrors=process.argv.filter(item=>item.match(/logErrors/i))[0]?true:false
-const listTests=process.argv.filter(item=>item.match(/listTests/i))[0]?true:false
-
-const methodList=process.argv
-	.qtClone() //create a deep copy so changes can't leak back to the source
-	.filter(item=>item.match(/^--methodList/)) //['--methodList=qtClone,qtToString,qtPop']
-	.qtGetSurePath('[0]', '') //'--methodList=qtClone,qtToString,qtPop'
-	.split('=') //['--methodList', 'qtClone,qtToString,qtPop']
-	.qtGetSurePath('[1]', '') //'qtClone,qtToString,qtPop'
-	.split(',') //['qtClone', 'qtToString', 'qtPop']
-	.filter(item=>item.length>0) //eliminates the empty if default
-
-
-const result=qt.test({logErrors, verbose, methodList, listTests});
-console.log(result?"PASSED ALL TESTS":"");
-
-const showAdditionalInfo=(verbose, result)=>{
-console.log(`result=${result}`);
-
-if (!verbose && result){
-	return;
-}
-console.log(`
-
-Additional Usage:
-npm logTest; #node --trace-uncaught test.js -listTests -logErrors --methodList=qtLog
-npm test; #node test.js -verbose -logErrors
-npm quiet; #node test.js -listTests -logErrors
-
-# -logErrors shows the message from any failing tests
-
-or find .../qtools-functional-library/test.js and execute, eg,
-    cd .../qtools-functional-library/test.js;
-    node test.js --methodList=qtMapProperties
-    `)
-    
-    }
-showAdditionalInfo(verbose, result)
-
-process.exit(result?0:1);

package/libDotD_Working_Example/node_modules/qtools-library-dot-d/README.md

@@ -1,208 +0,0 @@
-# qtools-library-dot-d
-
-# NOT READY. STILL WORKING IT OUT.
-
-NAME
-
-    qtools-library-dot-d
-
-DESCRIPTION
-
-Utility provides tools to scan a directory for NodeJS modules, require() them into existance with tools to connect them to a system.
-
-
-
-First use case is adding endpoints to an expressJS system. When instantiated, qtDotD
-
-scans a directory containing modules, dotLib.d. It requires it with two parameters,
-
-dotD and passThroughArgs. For this case, passThrough args has two properties, 
-
-expressApp and routingPrefix. The module uses these to construct one or more 
-
-expressJS endpoitns.
-
-
-
-the dotD object contains three parameters, add....
-
-ASYNCHRONOUS CODE SAMPLE
-
-const promptObjects = require('qtools-library-dot-d')({
-	libraryName: 'promptObjects',
-}, callback);
-promptObjects.setLibraryPath(path.join(__dirname, 'prompts.d'), callback);
-
-const passThroughParameters = {};
-promptObjects.loadModules({ passThroughParameters }, callback);
-promptObjects.seal(); //make the library immutable
-
-
-
-SYNCHROMOUS CODE SAMPLE:
-
-const promptObjects = require('qtools-library-dot-d')({
-	libraryName: 'promptObjects',
-});
-promptObjects.setLibraryPath(path.join(__dirname, 'prompts.d'));
-
-const passThroughParameters = {};
-promptObjects.loadModules({ passThroughParameters });
-promptObjects.seal(); //make the library immutable
-
-
-COMPLETE WORKING CODE SAMPLE
-
-// ================================================================================
-// index.js for demonstration
-
-#!/usr/bin/env node
-'use strict';
-// Suppress punycode deprecation warning
-process.noDeprecation = true;
-
-const moduleName = __filename.replace(__dirname + '/', '').replace(/.js$/, ''); //this just seems to come in handy a lot
-
-// const qt = require('qtools-functional-library'); //also exposes qtLog(); qt.help({printOutput:true, queryString:'.*', sendJson:false});
-
-const os = require('os');
-const path = require('path');
-const fs = require('fs');
-
-const qtLibDotD = require('qtools-library-dot-d');
-
-//START OF moduleFunction() ============================================================
-const moduleFunction =
-	({ moduleName } = {}) =>
-	({ unused } = {}) => {
-	
-		// ========================================================================
-		// SYNCHRONOUS DEMO
-
-		const synchronousDemo = () => {
-			const demoDotD = qtLibDotD({
-				libraryName: 'demoDotD',
-			});
-
-			const libraryModulesPath = path.join(__dirname, 'demoModules_DotD');
-
-			const passThroughParameters = {
-				message: 'Hello from a dotDlib module',
-				add: (a, b) => a + b,
-			};
-
-			demoDotD.setLibraryPath(libraryModulesPath);
-			demoDotD.loadModules({ passThroughParameters });
-			demoDotD.seal();
-
-			// console.log(demoDotD.qtdProcessLog());
-			console.log(demoDotD.toString());
-
-			demoDotD.demo1();
-			demoDotD.demo2(10, 7);
-		};
-			console.log(`SYNCHRONOUS DEMO =====================================`);
-			synchronousDemo();
-	
-		// ========================================================================
-		// ASYNCHRONOUS DEMO
-
-		const asynchronousDemo = (callback) => {
-			const localCallback = (err) => {
-				demoDotD.seal();
-				callback(err, demoDotD);
-			};
-
-			const demoDotD = qtLibDotD({
-				libraryName: 'demoDotD',
-			});
-
-			const libraryModulesPath = path.join(__dirname, 'demoModules_DotD');
-
-			const passThroughParameters = {
-				message: 'Hello from a dotDlib module',
-				add: (a, b) => a + b,
-			};
-
-			demoDotD.setLibraryPath(libraryModulesPath);
-			demoDotD.loadModules({ passThroughParameters }, localCallback);
-		};
-
-		console.log(`\n\nASYNCHRONOUS DEMO =====================================`);
-
-		const callback = (err, demoDotD) => {
-			console.log(demoDotD.toString());
-			demoDotD.demo1();
-			demoDotD.demo2(10, 7);
-		};
-		
-		asynchronousDemo(callback);
-	};
-
-
-// ================================================================================
-// demo1.js
-
-#!/usr/bin/env node
-'use strict';
-// Suppress punycode deprecation warning
-process.noDeprecation = true;
-
-const moduleName = __filename.replace(__dirname + '/', '').replace(/.js$/, ''); //this just seems to come in handy a lot
-
-//START OF moduleFunction() ============================================================
-const moduleFunction = ({ moduleName } = {}) => ({ dotD, passThroughParameters } = {}) => {
-
-	const workingFunction = () => {
-		console.log(`${passThroughParameters.message} [${moduleName}]`);
-		return 'hello';
-	};
-	
-
-	dotD.library.add(moduleName, workingFunction);
-};
-
-//END OF moduleFunction() ============================================================
-
-module.exports = moduleFunction({ moduleName }); //runs it right now
-//END OF moduleFunction() ============================================================
-
-module.exports = moduleFunction({ moduleName })({});
-
-
-// ================================================================================
-//demo2.js
-
-#!/usr/bin/env node
-'use strict';
-// Suppress punycode deprecation warning
-process.noDeprecation = true;
-
-const moduleName = __filename.replace(__dirname + '/', '').replace(/.js$/, ''); //this just seems to come in handy a lot
-
-//START OF moduleFunction() ============================================================
-const moduleFunction = ({ moduleName } = {}) => ({ dotD, passThroughParameters } = {}) => {
-
-	const workingFunction = (arg1, arg2) => {
-		console.log(`Pass Through Function: ${arg1}+${arg2}=${passThroughParameters.add(arg1, arg2)} [${moduleName}]`);
-		return 'hello';
-	};
-	
-
-	dotD.library.add(moduleName, workingFunction);
-};
-
-//END OF moduleFunction() ============================================================
-
-module.exports = moduleFunction({ moduleName }); //runs it right now
-
-
-HISTORY
-
-v1.05 - cleaned up toString() report, returns exception list (or err if callback) if needed, added qtools-functional-library
-v1.04 - Now tolerates (and reports) directories and files that are not modules.
-
-
-HISTORY
-
-v1.04 - Now tolerates (and reports) directories and files that are not modules.

package/libDotD_Working_Example/node_modules/qtools-library-dot-d/package.json

@@ -1,15 +0,0 @@
-{
-  "name": "qtools-library-dot-d",
-  "version": "1.0.5",
-  "description": "Scan a directory for JS modules that can execute and addMe() that attaches it to some form of name/value list, eg, a Map() with functions as values or an xPressJS route/endpoint list.",
-  "main": "qtools-library-dot-d.js",
-  "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1"
-  },
-  "author": "TQ White II",
-  "license": "ISC",
-  "dependencies": {
-    "qtools-asynchronous-pipe-plus": "^1.0.2",
-    "qtools-functional-library": "^2.0.4"
-  }
-}