There is a new netgroup management module placed in the plugins folder:

    plugins/modules/ipanetgroup.py

The netgroup module allows to ensure presence or absence of netgroup
and manage netgroup members.

Here is the documentation for the module:

    README-netgroup.md

New example playbooks have been added:

    playbooks/netgroup/netgroup-absent.yml
    playbooks/netgroup/netgroup-member-absent.yml
    playbooks/netgroup/netgroup-member-present.yml
    playbooks/netgroup/netgroup-present.yml

New tests for the module:

    tests/netgroup/test_netgroup.yml
    tests/netgroup/test_netgroup_client_context.yml
    tests/netgroup/test_netgroup_member.yml
    tests/netgroup/test_netgroup_member_absent.yml
    tests/netgroup/test_netgroup_member_case_insensitive.yml

Signed-off-by: Denis Karpelevich <dkarpele@redhat.com>

ipatopologysegment: Fix documentation sections and agument spec

ansible-test with ansible-2.14 is adding a lot of new tests to ensure
that the documentation section and the agument spec is complete. Needed
changes:

DOCUMENTATION section

- `type: str` needs to be set for string parameters
- `author` needs to be given with the github user also: `Name (@user)`

argument_spec

- `type="str"` needs to added to all string parameters

The `copyright` date is extended with `-2022`.

documentation: Change occurences of whitelist to allowlist.

new_module: Modify new_module and templates for Ansible 2.14

This change follows language use recomendation from NISTIR 8366,
"Guidance for NIST Staff on Using Inclusive Language in Documentary
Standards", accessible from

    https://nvlpubs.nist.gov/nistpubs/ir/2021/NIST.IR.8366.pdf

ipaconfig: Do not require enable_sid for add_sids or netbios_name

Current behavior of ipaconfig mimics FreeIPA CLI and requires that
'enable_sid' is set to True every time add_sids or netbios_name are
used. It is sufficient that SID generation is enabled to use add_sids
and netbios_name, but the IPA API requires 'enable_sid' so that the
operations are executed.

This patch allows ansible-freeipa plugin ipaconfig to run 'add_sids' or
set 'netbios_name without requiring 'enable_sid' to be set on the
playbook.

If SID generation is enabled, 'add_sids' and 'netbios_name' can be used
without 'enable_sid: yes'. If SID generation is not enabled, an error
message will be raised if 'enable_sid: yes' is not used.

ipaconfig: Do not allow enable_sid set to False.

Once enabled, SID cannot be disabled. This patch ensures that an error
is raised if one tries to disable SID.

ipaconfig: Fix fail_json calls.

ipaservice:: Fix documentation sections and agument spec

ipaserver: Fix documentation sections and agument spec

iparole: Fix documentation sections and agument spec

ipaselfservice: Fix documentation sections and agument spec

ipaprivilege: Fix documentation sections and agument spec

ipapermission: Fix documentation sections and agument spec

ipaidrange: Fix documentation sections and agument spec

ansible-test with ansible-2.14 is adding a lot of new tests to ensure
that the documentation section and the agument spec is complete.

To aid the creation of new_modules that follow these rules, the
'new_module' script and its templates were modified to use the new
ansible-test rules. The 'new_module' script now requires a new
argument, github_user, and the code templates provide the required
fields (like 'type' and 'elements') to the provide examples.

ipapwpolicy: Fix documentation sections and agument spec

ipaservicedelegationrule: Fix documentation sections and agument spec

ipaservicedelegationtarget: Fix documentation sections and agument spec

ipasudocmd: Fix documentation sections and agument spec

ipatopologysuffix: Fix documentation sections and agument spec

ipasudocmdgroup: Fix documentation sections and agument spec

ipatrust Fix documentation sections and agument spec

ipahostgroup: Fix documentation sections and agument spec

ipahbacsvcgroup: Fix documentation sections and agument spec

ipahbacsvc: Fix documentation sections and agument spec

ipalocation: Fix documentation sections and agument spec

ipahbacrule: Fix documentation sections and agument spec

ipagroup: Fix documentation sections and agument spec

ipadnsconfig: Fix documentation sections and agument spec

ipadnszone: Fix documentation sections and agument spec

ipadelegation: : Fix documentation sections and agument spec

Ansible's fail_json() method required that the message paramater was
passed with a keyword parameter, rather than a positional one. Although
this seems to work with ansible-core 2.13+, it might not work with
previous versions of Ansible.

This patch fixes the behaviour for all supported Ansible versions.

ipasudorule: Fix documentation sections and agument spec

ipaconfig: Fix documentation sections and agument spec

ipaautomountmap: Fix documentation sections and agument spec

ipaautomountkey: Fix documentation sections and agument spec