summaryrefslogtreecommitdiffstats
path: root/lib/ansible/plugins/test/falsy.yml
blob: 49a198f12abe56f88f46dd1c89bfa14e503d7db1 (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
DOCUMENTATION:
  name: falsy
  author: Ansible Core
  version_added: "2.10"
  short_description: Pythonic false
  description:
    - This check is a more Python version of what is 'false'.
    - It is the opposite of 'truthy'.
  options:
    _input:
      description: An expression that can be expressed in a boolean context.
      type: string
      required: True
    convert_bool:
      description: Attempts to convert the result to a strict Python boolean vs normally acceptable values (C(yes)/C(no), C(on)/C(off), C(0)/C(1), etc).
      type: bool
      default: false
EXAMPLES: |
    thisisfalse: '{{ "any string" is falsy }}'
    thisistrue: '{{ "" is falsy }}'
RETURN:
  _value:
    description: Returns C(False) if the condition is not "Python truthy", C(True) otherwise.
    type: boolean