summaryrefslogtreecommitdiffstats
path: root/lib/ansible/plugins/doc_fragments/vars_plugin_staging.py
blob: b2da29c4942b63340439f3d4f41981afe4747dec (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
# -*- coding: utf-8 -*-

# Copyright: (c) 2019,  Ansible Project
# GNU General Public License v3.0+ (see COPYING or https://www.gnu.org/licenses/gpl-3.0.txt)

from __future__ import absolute_import, division, print_function
__metaclass__ = type


class ModuleDocFragment(object):

    DOCUMENTATION = r'''
options:
  stage:
    description:
      - Control when this vars plugin may be executed.
      - Setting this option to C(all) will run the vars plugin after importing inventory and whenever it is demanded by a task.
      - Setting this option to C(task) will only run the vars plugin whenever it is demanded by a task.
      - Setting this option to C(inventory) will only run the vars plugin after parsing inventory.
      - If this option is omitted, the global I(RUN_VARS_PLUGINS) configuration is used to determine when to execute the vars plugin.
    choices: ['all', 'task', 'inventory']
    version_added: "2.10"
    type: str
'''