mirror of
https://github.com/ansible-collections/community.general.git
synced 2025-10-24 13:04: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
71 lines
2 KiB
Python
71 lines
2 KiB
Python
# Copyright (c) 2021, Felix Fontein <felix@fontein.de>
|
|
# GNU General Public License v3.0+ (see LICENSES/GPL-3.0-or-later.txt or https://www.gnu.org/licenses/gpl-3.0.txt)
|
|
# SPDX-License-Identifier: GPL-3.0-or-later
|
|
|
|
from __future__ import annotations
|
|
|
|
DOCUMENTATION = '''
|
|
name: a_module
|
|
short_description: Test whether a given string refers to an existing module or action plugin
|
|
version_added: 4.0.0
|
|
author: Felix Fontein (@felixfontein)
|
|
description:
|
|
- Test whether a given string refers to an existing module or action plugin.
|
|
- This can be useful in roles, which can use this to ensure that required modules are present ahead of time.
|
|
options:
|
|
_input:
|
|
description: A string denoting a fully qualified collection name (FQCN) of a module or action plugin.
|
|
type: string
|
|
required: true
|
|
'''
|
|
|
|
EXAMPLES = '''
|
|
- name: Make sure that community.aws.route53 is available
|
|
ansible.builtin.assert:
|
|
that:
|
|
- >
|
|
'community.aws.route53' is community.general.a_module
|
|
|
|
- name: Make sure that community.general.does_not_exist is not a module or action plugin
|
|
ansible.builtin.assert:
|
|
that:
|
|
- "'community.general.does_not_exist' is not community.general.a_module"
|
|
'''
|
|
|
|
RETURN = '''
|
|
_value:
|
|
description: Whether the module or action plugin denoted by the input exists.
|
|
type: boolean
|
|
'''
|
|
|
|
from ansible.plugins.loader import action_loader, module_loader
|
|
|
|
try:
|
|
from ansible.errors import AnsiblePluginRemovedError
|
|
except ImportError:
|
|
AnsiblePluginRemovedError = Exception
|
|
|
|
|
|
def a_module(term):
|
|
"""
|
|
Example:
|
|
- 'community.general.ufw' is community.general.a_module
|
|
- 'community.general.does_not_exist' is not community.general.a_module
|
|
"""
|
|
try:
|
|
for loader in (action_loader, module_loader):
|
|
data = loader.find_plugin(term)
|
|
if data is not None:
|
|
return True
|
|
return False
|
|
except AnsiblePluginRemovedError:
|
|
return False
|
|
|
|
|
|
class TestModule(object):
|
|
''' Ansible jinja2 tests '''
|
|
|
|
def tests(self):
|
|
return {
|
|
'a_module': a_module,
|
|
}
|