template: Rename base64 property for dataFile to toBase64 and add a fromBase64

Author: mstokes-f5

README.md

@@ -320,17 +320,20 @@ Parameters with a `dataFile` property:
 * have their `default` set to the contents of the file
 * given a default `format` of `hidden`
 
-Additionally, the contents of the data file can be base64 encoded before being used as for `default` by setting the `base64` property to `true`:
+Additionally, the contents of the data file can be base64-encoded before being used as for `default` by setting the `toBase64` property to `true`:
 
 ```yaml
 definitions:
     var:
         dataFile: example
-        base64: true
+        toBase64: true
     template: |
         {{var}}
 ```
 
+Similarly, if the data file is base64-encoded, it can be decoded using `fromBase64`.
+If both `toBase64` and `fromBase64` are set, then `toBase64` takes precedence.
+
 ## Development
 
 * To check for lint errors run `npm run lint` 

lib/template.js

@@ -412,8 +412,10 @@ class Template {
                     }
 
                     const dataFile = dataFiles[propDef.dataFile];
-                    if (propDef.base64) {
+                    if (propDef.toBase64) {
                         propDef.default = Buffer.from(dataFile, 'utf8').toString('base64');
+                    } else if (propDef.fromBase64) {
+                        propDef.default = Buffer.from(dataFile, 'base64').toString('utf8');
                     } else {
                         propDef.default = dataFile;
                     }

test/template.js

@@ -1259,12 +1259,21 @@ describe('Template class tests', function () {
                     dataFile: textData.txt
                 base64:
                     dataFile: textData.txt
-                    base64: true
+                    toBase64: true
+                decoded:
+                    dataFile: textData.txt
+                    fromBase64: true
+                toAndFrom:
+                    dataFile: textData.txt
+                    toBase64: true
+                    fromBase64: true
             template: |-
                 {{fromFile}}
                 {{base64}}
+                {{decoded}}
+                {{toAndFrom}}
         `;
-        const reference = 'Lorem ipsum\n\nTG9yZW0gaXBzdW0K';
+        const reference = 'Lorem ipsum\n\nTG9yZW0gaXBzdW0K\n.�ޚ*l�\nTG9yZW0gaXBzdW0K';
         return Template.loadYaml(yamldata, { dataProvider })
             .then((tmpl) => {
                 const schema = tmpl.getParametersSchema();
@@ -1277,6 +1286,8 @@ describe('Template class tests', function () {
                 assert.strictEqual(fileProp.default, 'Lorem ipsum\n');
 
                 assert.strictEqual(schema.properties.base64.default, 'TG9yZW0gaXBzdW0K');
+                assert.strictEqual(schema.properties.decoded.default, '.�ޚ*l�');
+                assert.strictEqual(schema.properties.toAndFrom.default, 'TG9yZW0gaXBzdW0K');
 
                 const rendered = tmpl.render();
                 console.log(rendered);