summaryrefslogtreecommitdiffstats
path: root/lib/ansible/plugins/filter/splitext.yml
blob: ea9cbcec31b290ffb7d9d07302bb136ed7b61176 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
DOCUMENTATION:
  name: splitext
  author: Matt Martz (@sivel)
  version_added: "2.0"
  short_description: split a path into root and file extension
  positional: _input
  description:
    - Returns a list of two, with the elements consisting of filename root and extension.
  options:
    _input:
      description: A path.
      type: str
      required: true

EXAMPLES: |

  # gobble => [ '/etc/make', 'conf' ]
  gobble: "{{ '/etc/make.conf' | splitext }}"

  # file_n_ext => [ 'ansible', 'cfg' ]
  file_n_ext: "{{ 'ansible.cfg' | splitext }}"

  # hoax => ['/etc/hoasdf', '']
  hoax: '{{ "/etc//hoasdf/"|splitext }}'

RETURN:
  _value:
    description: A list consisting of root of the path and the extension.
    type: list
    elements: str