mirror of
https://github.com/ansible-collections/community.general.git
synced 2025-10-24 04:54: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
98 lines
2.7 KiB
Python
98 lines
2.7 KiB
Python
# Copyright (c) 2021, Abhijeet Kasurde <akasurde@redhat.com>
|
|
# Copyright (c) 2018, Ansible Project
|
|
# 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 = r"""
|
|
name: random_pet
|
|
author:
|
|
- Abhijeet Kasurde (@Akasurde)
|
|
short_description: Generates random pet names
|
|
version_added: '3.1.0'
|
|
requirements:
|
|
- petname U(https://github.com/dustinkirkland/python-petname)
|
|
description:
|
|
- Generates random pet names that can be used as unique identifiers for the resources.
|
|
options:
|
|
words:
|
|
description:
|
|
- The number of words in the pet name.
|
|
default: 2
|
|
type: int
|
|
length:
|
|
description:
|
|
- The maximal length of every component of the pet name.
|
|
- Values below V(3) are set to V(3) by petname.
|
|
default: 6
|
|
type: int
|
|
prefix:
|
|
description: A string to prefix with the name.
|
|
type: str
|
|
separator:
|
|
description: The character to separate words in the pet name.
|
|
default: "-"
|
|
type: str
|
|
"""
|
|
|
|
EXAMPLES = r"""
|
|
- name: Generate pet name
|
|
ansible.builtin.debug:
|
|
var: lookup('community.general.random_pet')
|
|
# Example result: 'loving-raptor'
|
|
|
|
- name: Generate pet name with 3 words
|
|
ansible.builtin.debug:
|
|
var: lookup('community.general.random_pet', words=3)
|
|
# Example result: 'fully-fresh-macaw'
|
|
|
|
- name: Generate pet name with separator
|
|
ansible.builtin.debug:
|
|
var: lookup('community.general.random_pet', separator="_")
|
|
# Example result: 'causal_snipe'
|
|
|
|
- name: Generate pet name with length
|
|
ansible.builtin.debug:
|
|
var: lookup('community.general.random_pet', length=7)
|
|
# Example result: 'natural-peacock'
|
|
"""
|
|
|
|
RETURN = r"""
|
|
_raw:
|
|
description: A one-element list containing a random pet name.
|
|
type: list
|
|
elements: str
|
|
"""
|
|
|
|
try:
|
|
import petname
|
|
|
|
HAS_PETNAME = True
|
|
except ImportError:
|
|
HAS_PETNAME = False
|
|
|
|
from ansible.errors import AnsibleError
|
|
from ansible.plugins.lookup import LookupBase
|
|
|
|
|
|
class LookupModule(LookupBase):
|
|
|
|
def run(self, terms, variables=None, **kwargs):
|
|
|
|
if not HAS_PETNAME:
|
|
raise AnsibleError('Python petname library is required. '
|
|
'Please install using "pip install petname"')
|
|
|
|
self.set_options(var_options=variables, direct=kwargs)
|
|
words = self.get_option('words')
|
|
length = self.get_option('length')
|
|
prefix = self.get_option('prefix')
|
|
separator = self.get_option('separator')
|
|
|
|
values = petname.Generate(words=words, separator=separator, letters=length)
|
|
if prefix:
|
|
values = f"{prefix}{separator}{values}"
|
|
|
|
return [values]
|