summaryrefslogtreecommitdiffstats
path: root/lib/ansible/plugins/filter/quote.yml
diff options
context:
space:
mode:
Diffstat (limited to 'lib/ansible/plugins/filter/quote.yml')
-rw-r--r--lib/ansible/plugins/filter/quote.yml23
1 files changed, 23 insertions, 0 deletions
diff --git a/lib/ansible/plugins/filter/quote.yml b/lib/ansible/plugins/filter/quote.yml
new file mode 100644
index 0000000..2d621ed
--- /dev/null
+++ b/lib/ansible/plugins/filter/quote.yml
@@ -0,0 +1,23 @@
+DOCUMENTATION:
+ name: quote
+ version_added: "2.10"
+ short_description: shell quoting
+ description:
+ - Quote a string to safely use as in a POSIX shell.
+ notes:
+ - This is a passthrough to Python's C(shlex.quote).
+ positional: _input
+ options:
+ _input:
+ description: String to quote.
+ type: str
+ required: true
+
+EXAMPLES: |
+ - name: Run a shell command
+ shell: echo {{ string_value | quote }}
+
+RETURN:
+ _value:
+ description: Quoted string.
+ type: str