Update val2icon option to accept string values for emoticon transformation and document new transformation functions

Author: Nuno Miguel Aguiar

data/completion.yaml

@@ -616,4 +616,4 @@ complete:
 - 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
+  desc: If defined will transform undefined, null and boolean values to emoticons -values can be 'default' or 'simple'-

data/usage.json

@@ -295,6 +295,21 @@
       "Type": "String",
       "Description": "A JSON/SLON map with a 'a' path and a 'b' path to compare and provide diff data"
     },
+    {
+      "Option": "field2byte",
+      "Type": "String",
+      "Description": "A comma delimited list of fields whose value should be converted to a byte abbreviation"
+    },
+    {
+      "Option": "field2date",
+      "Type": "String",
+      "Description": "A comma delimited list of fields whose value should be converted to date values"
+    },
+    {
+      "Option": "field2si",
+      "Type": "String",
+      "Description": "A comma delimited list of fields whose value should be converted to a SI abbreviation"
+    },
     {
       "Option": "flatmap",
       "Type": "Boolean",
@@ -415,6 +430,11 @@
       "Type": "Boolean",
       "Description": "If true all the strings of the result map/list will be trimmed"
     },
+    {
+      "Option": "val2icon",
+      "Type": "Boolean",
+      "Description": "If true will transform undefined, null and boolean values to emoticons"
+    },
     {
       "Option": "xjs",
       "Type": "String",

src/docs/USAGE.md

@@ -139,7 +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 |
+| val2icon | String | If defined will transform undefined, null and boolean values to emoticons (values can be 'default' or 'simple') |
 | 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

@@ -529,14 +529,24 @@ var _transformFns = {
         return _r
     },
     "val2icon": _r => {
-        if (toBoolean(params.val2icon)) {
+        let _t = {
+            d: [ "🕳️", "✅", "❌" ],
+            s: [ "╍", "✓", "✕" ]
+        }
+        if (isDef(params.val2icon)) {
+            var th
+            switch(params.val2icon) {
+            case "simple": th = _t.s; break
+            default      :
+            case "default": th = _t.d; break
+            }
             ow.loadFormat()
             traverse(_r, (aK, aV, aP, aO) => {
                 if (isUnDef(aV) || isNull(aV)) {
-                    aO[aK] = "🕳️"
+                    aO[aK] = th[0]
                 } else {
                     if (isBoolean(aV)) {
-                        aO[aK] = aV ? "✅" : "❌"
+                        aO[aK] = aV ? th[1] : th[2]
                     }
                 }
             })