qtools-functional-library 1.1.15 → 2.0.0

package/README.md

@@ -4,6 +4,8 @@ This is a collection of tools that allow chained operations on various Javascrip
 
 In each case, the primary operand is `this`. In most cases, the function takes an argument with parameters to guide the operation. 
 
+Everything else remains compatible.
+
 **EG,**
 
 ```
@@ -20,6 +22,19 @@ const one=demo
 console.log(one); //produces '[object Object]'
 ```
 
+### **Version 2:**
+
+qtPassThrough <u>no longer</u> *always* returns the inbound 'this'. If the supplied function
+returns a value, that is passed on. This way, any ad hoc function can affect the result chain.
+
+EG,
+
+```
+'xxx'
+    .qtPassThrough(item=>item.toUpperCase())
+    .qtDump(); // -> 'XXX'
+```
+
 ### **Non-chain utilities:**
 
 - **qt.help**: Shows this information and more.
@@ -45,7 +60,7 @@ console.log(one); //produces '[object Object]'
 
 - **qtSetSurePath** Sets the value of a property based on a dotted string path. Creates intermediate elements if they are missing.
 
-- **qtSelectProperties**: Given an Object and an Array of Strings, filters the properties into a new Object with defaults for missing elements. Does the same for an Array of Objects.
+- **qtSelectProperties**: Given an Object and an Array of Strings, filters the properties into a new Object with defaults "[{}].qtSelectProperties(outFileDefinition, {moreDefaultValues:{Value:"xxx"}}))" for missing elements. Does the same for an Array of Objects.
 
 - **qtMapProperties**: Given an Object and a one level Object whose properties are functions, applies each function to the corresponding element. Does the same for an array of Objects.
 
@@ -71,8 +86,22 @@ console.log(one); //produces '[object Object]'
 
 ### **Misc:**
 
-- **qtPassThrough**: Sits in a declarative chain and executes an arbitrary function. It returns 'this' regardless of what the function does. 'this' is available to the function.
+- **qtPassThrough**: Sits in a declarative chain and executes an arbitrary function. Returns function result if not undefined, 'this' otherwise. 'this' is available to the function.
 
 - **qtIterate**: Operates on a number. EG, (5).qtStart(7).qtIncrement(3).qtIterate(item=>item*100)
 
-DESCRIPTION
+### **Output:**
+
+1.1.16 - fixed bug where intermediate path element could be undefined and cause a crash.
+
+### **Other Cool Qtools**
+
+[qtools-asynchronous-pipe-plus](https://www.npmjs.com/package/qtools-asynchronous-pipe-plus)
+[qtools-config-file-processor](https://www.npmjs.com/package/qtools-config-file-processor)
+[qtools-format-columns](https://www.npmjs.com/package/qtools-format-columns)
+[qtools-functional-library](https://www.npmjs.com/package/qtools-functional-library)
+[qtools-object-flattener](https://www.npmjs.com/package/qtools-object-flattener)
+[qtools-parse-command-line](https://www.npmjs.com/package/qtools-parse-command-line)
+[qtools-secure-container](https://www.npmjs.com/package/qtools-secure-container)
+[qtools-template-replace-for-files](https://www.npmjs.com/package/qtools-template-replace-for-files)
+[qtools-transform-text](https://www.npmjs.com/package/qtools-transform-text)

package/lib/qtools-object-sure-path/qtools-object-sure-path.js

@@ -57,7 +57,7 @@ var moduleFunction = function(args = {}) {
 				for (var i = 0, len = elements.length; i < len; i++) {
 					if (elements[i]) {
 						//mainly eliminates trailing periods but would also eliminates double periods and other regex anomalies
-						target = target[elements[i]];
+						target = target?target[elements[i]]:undefined;
 
 						getDottedPathLastProgressiveString += elements[i] + '.';
 						if (typeof target == 'undefined' || target === '') {

package/lib/qtools-pass-through/qtools-pass-through.js

@@ -1,23 +1,21 @@
 'use strict';
 //START OF moduleFunction() ============================================================
-var moduleFunction = function(args = {}) {
+var moduleFunction = function (args = {}) {
 	const { commonFunctions } = args;
-	
-	const addToPrototypeActual = functionObject => () =>
+
+	const addToPrototypeActual = (functionObject) => () =>
 		commonFunctions.universalAddToPrototype(commonFunctions, functionObject);
-	
-	
-	
+
 	//first method definition function ==========================
-	const firstMethodFunction = commonFunctions => {
+	const firstMethodFunction = (commonFunctions) => {
 		const functionObject = new Map(); // prettier-ignore
-		
+
 		const methodName = 'qtPassThrough';
-		const description = `executes a supplied function; 'this' is the only parameter; objects may be changed but that is not the point; no return value is passed on.`;
+		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) {
+			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
@@ -25,32 +23,35 @@ var moduleFunction = function(args = {}) {
 						`${methodName}(): unsupported data type: '${commonFunctions.toType(this)}' (${methodName} supports ${supportedTypeList.map(item=>item.toString().replace(/.*function (.*?)\(\).*/, '$1')).join(', ')})`
 					);
 				}
-				
-				utilityFunction(this);
 
-				return this;
+				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, '')
-				}})
-				}
+			test: (args) => {
+				return require('./test.js')({
+					...args,
+					...{
+						moduleName: module.id.replace(module.path, ''),
+					},
+				});
+			},
 		});
-		
-		
-		
+
 		return functionObject;
-	};  
-	 this.addToPrototype = addToPrototypeActual(
-		firstMethodFunction(commonFunctions)
+	};
+	this.addToPrototype = addToPrototypeActual(
+		firstMethodFunction(commonFunctions),
 	);
-	
+
 };
 //END OF moduleFunction() ============================================================
 module.exports = moduleFunction;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "qtools-functional-library",
-  "version": "1.1.15",
+  "version": "2.0.0",
   "description": "Useful additions to JS prototypes to facilliate chainable, functional (mostly) style. Also make life more convenient.\"",
   "main": "qtools-functional-library.js",
   "scripts": {