summaryrefslogtreecommitdiffstats
path: root/lib/ansible/plugins/filter/path_join.yml
diff options
context:
space:
mode:
authorDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-28 16:04:21 +0000
committerDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-28 16:04:21 +0000
commit8a754e0858d922e955e71b253c139e071ecec432 (patch)
tree527d16e74bfd1840c85efd675fdecad056c54107 /lib/ansible/plugins/filter/path_join.yml
parentInitial commit. (diff)
downloadansible-core-8a754e0858d922e955e71b253c139e071ecec432.tar.xz
ansible-core-8a754e0858d922e955e71b253c139e071ecec432.zip
Adding upstream version 2.14.3.upstream/2.14.3upstream
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'lib/ansible/plugins/filter/path_join.yml')
-rw-r--r--lib/ansible/plugins/filter/path_join.yml30
1 files changed, 30 insertions, 0 deletions
diff --git a/lib/ansible/plugins/filter/path_join.yml b/lib/ansible/plugins/filter/path_join.yml
new file mode 100644
index 0000000..d50deaa
--- /dev/null
+++ b/lib/ansible/plugins/filter/path_join.yml
@@ -0,0 +1,30 @@
+DOCUMENTATION:
+ name: path_join
+ author: Anthony Bourguignon (@Toniob)
+ version_added: "2.10"
+ short_description: Join one or more path components
+ positional: _input
+ description:
+ - Returns a path obtained by joining one or more path components.
+ options:
+ _input:
+ description: A path, or a list of paths.
+ type: list
+ elements: str
+ required: true
+
+EXAMPLES: |
+
+ # If path == 'foo/bar' and file == 'baz.txt', the result is '/etc/foo/bar/subdir/baz.txt'
+ {{ ('/etc', path, 'subdir', file) | path_join }}
+
+ # equivalent to '/etc/subdir/{{filename}}'
+ wheremyfile: "{{ ['/etc', 'subdir', filename] | path_join }}"
+
+ # trustme => '/etc/apt/trusted.d/mykey.gpgp'
+ trustme: "{{ ['/etc', 'apt', 'trusted.d', 'mykey.gpg'] | path_join }}"
+
+RETURN:
+ _value:
+ description: The concatenated path.
+ type: str