Implement shell-compatible quoting (#587)

* Implement shell-compatible quoting

* Reorganize to move non-template-specific logic from funcs/strings to strings/strings

1 files changed, 18 insertions, 0 deletions

diff --git a/docs-src/content/functions/strings.yml b/docs-src/content/functions/strings.yml
index b3062dc4..e2532a17 100644
--- a/docs-src/content/functions/strings.yml
+++ b/docs-src/content/functions/strings.yml
@@ -252,6 +252,24 @@ funcs:
       - |
         $ echo 'Rock & Roll @ Cafe Wha?' | gomplate -d in=stdin: -i '{{ strings.Slug (include "in") }}'
         rock-and-roll-at-cafe-wha
+  - name: strings.ShellQuote
+    alias: shellQuote
+    description: |
+      Given a string, emits a version of that string that will evaluate to its literal data when expanded by any POSIX-compliant shell.
+
+      Given an array or slice, emit a single string which will evaluate to a series of shell words, one per item in that array or slice.
+    pipeline: true
+    arguments:
+      - name: in
+        required: true
+        description: The input to quote
+    examples:
+      - |
+        $ gomplate -i "{{ slice \"one word\" \"foo='bar baz'\" | shellQuote }}"
+        'one word' 'foo='"'"'bar baz'"'"''
+      - |
+        $ gomplate -i "{{ strings.ShellQuote \"it's a banana\" }}"
+        'it'"'"'s a banana'
   - name: strings.Squote
     alias: squote
     description: |