mirror of
https://github.com/ansible-collections/community.general.git
synced 2025-10-24 21:14:00 -07:00
8f8a0e1d7c
Some checks are pending
EOL CI / EOL Sanity (Ⓐ2.17) (push) Waiting to run
EOL CI / EOL Units (Ⓐ2.17+py3.10) (push) Waiting to run
EOL CI / EOL Units (Ⓐ2.17+py3.12) (push) Waiting to run
EOL CI / EOL Units (Ⓐ2.17+py3.7) (push) Waiting to run
EOL CI / EOL I (Ⓐ2.17+alpine319+py:azp/posix/1/) (push) Waiting to run
EOL CI / EOL I (Ⓐ2.17+alpine319+py:azp/posix/2/) (push) Waiting to run
EOL CI / EOL I (Ⓐ2.17+alpine319+py:azp/posix/3/) (push) Waiting to run
EOL CI / EOL I (Ⓐ2.17+fedora39+py:azp/posix/1/) (push) Waiting to run
EOL CI / EOL I (Ⓐ2.17+fedora39+py:azp/posix/2/) (push) Waiting to run
EOL CI / EOL I (Ⓐ2.17+fedora39+py:azp/posix/3/) (push) Waiting to run
EOL CI / EOL I (Ⓐ2.17+ubuntu2004+py:azp/posix/1/) (push) Waiting to run
EOL CI / EOL I (Ⓐ2.17+ubuntu2004+py:azp/posix/2/) (push) Waiting to run
EOL CI / EOL I (Ⓐ2.17+ubuntu2004+py:azp/posix/3/) (push) Waiting to run
nox / Run extra sanity tests (push) Waiting to run
* Adjust all __future__ imports: for i in $(grep -REl "__future__.*absolute_import" plugins/ tests/); do sed -e 's/from __future__ import .*/from __future__ import annotations/g' -i $i; done * Remove all UTF-8 encoding specifications for Python source files: for i in $(grep -REl '[-][*]- coding: utf-8 -[*]-' plugins/ tests/); do sed -e '/^# -\*- coding: utf-8 -\*-/d' -i $i; done * Remove __metaclass__ = type: for i in $(grep -REl '__metaclass__ = type' plugins/ tests/); do sed -e '/^__metaclass__ = type/d' -i $i; done
91 lines
2.2 KiB
Python
91 lines
2.2 KiB
Python
|
|
# Copyright (c) Ansible Project
|
|
# GNU General Public License v3.0+ (see COPYING or https://www.gnu.org/licenses/gpl-3.0.txt)
|
|
# SPDX-License-Identifier: GPL-3.0-or-later
|
|
|
|
from __future__ import annotations
|
|
|
|
|
|
class ModuleDocFragment(object):
|
|
|
|
# Standard documentation fragment
|
|
DOCUMENTATION = r"""
|
|
options: {}
|
|
attributes:
|
|
check_mode:
|
|
description: Can run in C(check_mode) and return changed status prediction without modifying target.
|
|
diff_mode:
|
|
description: Returns details on what has changed (or possibly needs changing in C(check_mode)), when in diff mode.
|
|
"""
|
|
|
|
PLATFORM = r"""
|
|
options: {}
|
|
attributes:
|
|
platform:
|
|
description: Target OS/families that can be operated against.
|
|
support: N/A
|
|
"""
|
|
|
|
# Should be used together with the standard fragment
|
|
INFO_MODULE = r'''
|
|
options: {}
|
|
attributes:
|
|
check_mode:
|
|
support: full
|
|
details:
|
|
- This action does not modify state.
|
|
diff_mode:
|
|
support: N/A
|
|
details:
|
|
- This action does not modify state.
|
|
'''
|
|
|
|
CONN = r"""
|
|
options: {}
|
|
attributes:
|
|
become:
|
|
description: Is usable alongside C(become) keywords.
|
|
connection:
|
|
description: Uses the target's configured connection information to execute code on it.
|
|
delegation:
|
|
description: Can be used in conjunction with C(delegate_to) and related keywords.
|
|
"""
|
|
|
|
FACTS = r"""
|
|
options: {}
|
|
attributes:
|
|
facts:
|
|
description: Action returns an C(ansible_facts) dictionary that updates existing host facts.
|
|
"""
|
|
|
|
# Should be used together with the standard fragment and the FACTS fragment
|
|
FACTS_MODULE = r'''
|
|
options: {}
|
|
attributes:
|
|
check_mode:
|
|
support: full
|
|
details:
|
|
- This action does not modify state.
|
|
diff_mode:
|
|
support: N/A
|
|
details:
|
|
- This action does not modify state.
|
|
facts:
|
|
support: full
|
|
'''
|
|
|
|
FILES = r"""
|
|
options: {}
|
|
attributes:
|
|
safe_file_operations:
|
|
description: Uses Ansible's strict file operation functions to ensure proper permissions and avoid data corruption.
|
|
"""
|
|
|
|
FLOW = r"""
|
|
options: {}
|
|
attributes:
|
|
action:
|
|
description: Indicates this has a corresponding action plugin so some parts of the options can be executed on the controller.
|
|
async:
|
|
description: Supports being used with the C(async) keyword.
|
|
"""
|