Add new transformation functions: field2byte, field2date, field2si, and val2icon

Author: Nuno Miguel Aguiar

data/completion.yaml

@@ -502,6 +502,12 @@ complete:
     desc: If true and the input is text based will perfom the diff at the sentence level
   - name: diffchars=
     desc: If true and the input is text based will perform the diff at the char level
+- name: field2byte=
+  desc: A comma delimited list of fields whose value should be converted to a byte abbreviation
+- name: field2date=
+  desc: A comma delimited list of fields whose value should be converted to date values
+- name: field2si=
+  desc: A comma delimited list of fields whose value should be converted to a SI abbreviation
 - name: flatmap=
   desc: If true a map structure will be flat to just one level -optionally flatmapsep=[char] to use a different separator that '.'-
 - name: getlist=
@@ -609,3 +615,5 @@ complete:
   desc: A .py file with function code to manipulate each input array record as 'args'. Returns the transformed 'args' record
 - name: xrfn=
   desc: A javascript code, receiving each input array record as 'args' and return it's code evaluation
+- name: val2icon= 
+  desc: If true will transform undefined, null and boolean values to emoticons

src/docs/USAGE.md

@@ -112,6 +112,9 @@ These options will change the parsed input data included any filters provided.
 | correcttypes | Boolean | If true will try to convert alpha-numeric field values with just numbers to number fields, string date fields to dates and boolean fields |
 | denormalize | String | Reverses 'normalize' given a JSON/SLON map with a normalize schema (see OpenAF's ow.ai.normalize.withSchema) |
 | diff | String | A JSON/SLON map with a 'a' path and a 'b' path to compare and provide diff data |
+| field2byte | String | A comma delimited list of fields whose value should be converted to a byte abbreviation |
+| field2date | String | A comma delimited list of fields whose value should be converted to date values |
+| field2si | String | A comma delimited list of fields whose value should be converted to a SI abbreviation |
 | flatmap | Boolean | If true a map structure will be flat to just one level (optionally flatmapsep=[char] to use a different separator that '.') |
 | getlist | Number | If true will try to find the first array on the input value (if number will stop only after the number of checks) |
 | forcearray | Boolean | If true and if the input is map it will force it to be an array with that map as the only element |
@@ -136,6 +139,7 @@ These options will change the parsed input data included any filters provided.
 | sortmapkeys | Boolean | If true the resulting map keys will be sorted |
 | spacekeys | String | Replaces spaces in keys with the provided string (for example, helpful to xml output) |
 | trim | Boolean | If true all the strings of the result map/list will be trimmed |
+| val2icon | Boolean | If true will transform undefined, null and boolean values to emoticons |
 | xjs | String | A .js file with function code manipulating an input 'args'. Returns the transformed 'args' variable. |
 | xpy | String | A .py file with Python function code manipulating an input 'args'. Returns the transformed 'args' variable. |
 | xfn | String | A javascript code, receiving input as 'args' and return it's code evaluation. |

src/include/transformFns.js

@@ -527,5 +527,48 @@ var _transformFns = {
             return pForEach(_r, _f)
         }
         return _r
+    },
+    "val2icon": _r => {
+        if (toBoolean(params.val2icon)) {
+            ow.loadFormat()
+            traverse(_r, (aK, aV, aP, aO) => {
+                if (isUnDef(aV) || isNull(aV)) {
+                    aO[aK] = "🕳️"
+                } else {
+                    if (isBoolean(aV)) {
+                        aO[aK] = aV ? "✅" : "❌"
+                    }
+                }
+            })
+        }
+        return _r
+    },
+    "field2date": _r => {
+        let _lst = params.field2date.split(",").map(r => r.trim())
+        traverse(_r, (aK, aV, aP, aO) => {
+            if (_lst.indexOf(aP.length > 0 && !aP.startsWith("[") ? aP.substring(1) + "." + aK : aK) >= 0 && isNumber(aV) && aV > 0) {
+                try { aO[aK] = new Date(aV) } catch(e) {}
+            }
+        })
+        return _r
+    },
+    "field2si": _r => {
+        let _lst = params.field2si.split(",").map(r => r.trim())
+        traverse(_r, (aK, aV, aP, aO) => {
+            if (_lst.indexOf(aP.length > 0 && !aP.startsWith("[") ? aP.substring(1) + "." + aK : aK) >= 0 && isNumber(aV)) {
+                aO[aK] = ow.format.toAbbreviation(aV)
+            }
+        })
+        return _r
+    },
+    "field2byte": _r => {
+        let _lst = params.field2byte.split(",").map(r => r.trim())
+        traverse(_r, (aK, aV, aP, aO) => {
+            if (_lst.indexOf(aP.length > 0 && !aP.startsWith("[") ? aP.substring(1) + "." + aK : aK) >= 0 && isNumber(aV)) {
+                aO[aK] = ow.format.toBytesAbbreviation(aV)
+            }
+        })
+        return _r
     }
+
 }