[PR #5965/0ef80569 backport][stable-6] Add attributes to more modules (1/4) (#6022)

Add attributes to more modules (1/4) (#5965)

* Add attributes to more modules.

* Apply suggestions from code review.

Co-authored-by: Kristian Heljas <11139388+kristianheljas@users.noreply.github.com>

---------

Co-authored-by: Kristian Heljas <11139388+kristianheljas@users.noreply.github.com>
(cherry picked from commit 0ef805699d)

Co-authored-by: Felix Fontein <felix@fontein.de>

plugins/doc_fragments/hpe3par.py

@@ -29,8 +29,7 @@ options:
       required: true
 
 requirements:
-  - hpe3par_sdk >= 1.0.2. Install using 'pip install hpe3par_sdk'
+  - hpe3par_sdk >= 1.0.2. Install using C(pip install hpe3par_sdk).
   - WSAPI service should be enabled on the 3PAR storage array.
 notes:
-  -  check_mode not supported
     '''

plugins/modules/ali_instance.py

@@ -31,6 +31,11 @@ short_description: Create, Start, Stop, Restart or Terminate an Instance in ECS;
 description:
     - Create, start, stop, restart, modify or terminate ecs instances.
     - Add or remove ecs instances to/from security group.
+attributes:
+    check_mode:
+      support: none
+    diff_mode:
+      support: none
 options:
     state:
       description:
@@ -252,6 +257,7 @@ requirements:
     - "footmark >= 1.19.0"
 extends_documentation_fragment:
     - community.general.alicloud
+    - community.general.attributes
 '''
 
 EXAMPLES = '''

plugins/modules/deploy_helper.py

@@ -31,6 +31,12 @@ description:
     C(new_release), either the 'release' parameter or a generated timestamp,
     C(new_release_path), the path to the new release folder (not created by the module)."
 
+attributes:
+  check_mode:
+    support: full
+  diff_mode:
+    support: none
+
 options:
   path:
     type: path
@@ -111,7 +117,9 @@ notes:
   - Because of the default behaviour of generating the I(new_release) fact, this module will not be idempotent
     unless you pass your own release name with I(release). Due to the nature of deploying software, this should not
     be much of a problem.
-extends_documentation_fragment: files
+extends_documentation_fragment:
+  - ansible.builtin.files
+  - community.general.attributes
 '''
 
 EXAMPLES = '''

plugins/modules/heroku_collaborator.py

@@ -21,6 +21,13 @@ author:
   - Marcel Arns (@marns93)
 requirements:
   - heroku3
+extends_documentation_fragment:
+  - community.general.attributes
+attributes:
+  check_mode:
+    support: full
+  diff_mode:
+    support: none
 options:
   api_key:
     type: str

plugins/modules/honeybadger_deployment.py

@@ -14,7 +14,14 @@ module: honeybadger_deployment
 author: "Benjamin Curtis (@stympy)"
 short_description: Notify Honeybadger.io about app deployments
 description:
-   - Notify Honeybadger.io about app deployments (see http://docs.honeybadger.io/article/188-deployment-tracking)
+  - Notify Honeybadger.io about app deployments (see U(http://docs.honeybadger.io/article/188-deployment-tracking)).
+extends_documentation_fragment:
+  - community.general.attributes
+attributes:
+  check_mode:
+    support: full
+  diff_mode:
+    support: none
 options:
   token:
     type: str

plugins/modules/hponcfg.py

@@ -16,6 +16,13 @@ author: Dag Wieers (@dagwieers)
 short_description: Configure HP iLO interface using hponcfg
 description:
   - This modules configures the HP iLO interface using hponcfg.
+extends_documentation_fragment:
+  - community.general.attributes
+attributes:
+  check_mode:
+    support: none
+  diff_mode:
+    support: none
 options:
   path:
     description:

plugins/modules/imc_rest.py

@@ -16,12 +16,19 @@ description:
   - Provides direct access to the Cisco IMC REST API.
   - Perform any configuration changes and actions that the Cisco IMC supports.
   - More information about the IMC REST API is available from
-  U(http://www.cisco.com/c/en/us/td/docs/unified_computing/ucs/c/sw/api/3_0/b_Cisco_IMC_api_301.html)
+    U(http://www.cisco.com/c/en/us/td/docs/unified_computing/ucs/c/sw/api/3_0/b_Cisco_IMC_api_301.html).
 author:
   - Dag Wieers (@dagwieers)
 requirements:
   - lxml
   - xmljson >= 0.1.8
+extends_documentation_fragment:
+  - community.general.attributes
+attributes:
+  check_mode:
+    support: full
+  diff_mode:
+    support: none
 options:
   hostname:
     description:

plugins/modules/imgadm.py

@@ -16,6 +16,13 @@ short_description: Manage SmartOS images
 description:
     - Manage SmartOS virtual machine images through imgadm(1M)
 author: Jasper Lievisse Adriaanse (@jasperla)
+extends_documentation_fragment:
+    - community.general.attributes
+attributes:
+    check_mode:
+        support: none
+    diff_mode:
+        support: none
 options:
     force:
         required: false

plugins/modules/infinity.py

@@ -15,6 +15,13 @@ description:
   - Manage Infinity IPAM using REST API.
 author:
   - Meirong Liu (@MeganLiu)
+extends_documentation_fragment:
+  - community.general.attributes
+attributes:
+  check_mode:
+    support: none
+  diff_mode:
+    support: none
 options:
   server_ip:
     description:

plugins/modules/ip_netns.py

@@ -15,6 +15,13 @@ short_description: Manage network namespaces
 requirements: [ ip ]
 description:
     - Create or delete network namespaces using the ip command.
+extends_documentation_fragment:
+    - community.general.attributes
+attributes:
+    check_mode:
+        support: full
+    diff_mode:
+        support: none
 options:
     name:
         required: false

plugins/modules/ipwcli_dns.py

@@ -25,6 +25,15 @@ requirements:
 notes:
     - To make the DNS record changes effective, you need to run C(update dnsserver) on the ipwcli.
 
+extends_documentation_fragment:
+    - community.general.attributes
+
+attributes:
+    check_mode:
+        support: full
+    diff_mode:
+        support: none
+
 options:
     dnsname:
         description:

plugins/modules/linode.py

@@ -14,6 +14,13 @@ module: linode
 short_description: Manage instances on the Linode Public Cloud
 description:
   - Manage Linode Public Cloud instances and optionally wait for it to be 'running'.
+extends_documentation_fragment:
+  - community.general.attributes
+attributes:
+  check_mode:
+    support: none
+  diff_mode:
+    support: none
 options:
   state:
     description:

plugins/modules/linode_v4.py

@@ -22,6 +22,13 @@ notes:
   - No Linode resizing is currently implemented. This module will, in time,
     replace the current Linode module which uses deprecated API bindings on the
     Linode side.
+extends_documentation_fragment:
+  - community.general.attributes
+attributes:
+  check_mode:
+    support: none
+  diff_mode:
+    support: none
 options:
   region:
     description:

plugins/modules/lxc_container.py

@@ -16,6 +16,13 @@ short_description: Manage LXC Containers
 description:
   - Management of LXC containers.
 author: "Kevin Carter (@cloudnull)"
+extends_documentation_fragment:
+  - community.general.attributes
+attributes:
+    check_mode:
+        support: none
+    diff_mode:
+        support: none
 options:
     name:
         description:

plugins/modules/netcup_dns.py

@@ -16,6 +16,13 @@ notes: []
 short_description: Manage Netcup DNS records
 description:
   - "Manages DNS records via the Netcup API, see the docs U(https://ccp.netcup.net/run/webservice/servers/endpoint.php)."
+extends_documentation_fragment:
+  - community.general.attributes
+attributes:
+  check_mode:
+    support: full
+  diff_mode:
+    support: none
 options:
   api_key:
     description:

plugins/modules/ohai.py

@@ -18,6 +18,13 @@ description:
     (U(https://docs.chef.io/ohai.html)) on the remote host and
     returns JSON inventory data.
     I(Ohai) data is a bit more verbose and nested than I(facter).
+extends_documentation_fragment:
+  - community.general.attributes
+attributes:
+  check_mode:
+    support: none
+  diff_mode:
+    support: none
 options: {}
 notes: []
 requirements: [ "ohai" ]

plugins/modules/omapi_host.py

@@ -19,6 +19,13 @@ requirements:
   - pypureomapi
 author:
   - Loic Blot (@nerzhul)
+extends_documentation_fragment:
+  - community.general.attributes
+attributes:
+    check_mode:
+        support: none
+    diff_mode:
+        support: none
 options:
     state:
         description:

plugins/modules/open_iscsi.py

@@ -19,6 +19,13 @@ description:
       manually or auto start, return device nodes of connected targets.
 requirements:
     - open_iscsi library and tools (iscsiadm)
+extends_documentation_fragment:
+    - community.general.attributes
+attributes:
+    check_mode:
+        support: full
+    diff_mode:
+        support: none
 options:
     portal:
         description:

plugins/modules/opendj_backendprop.py

@@ -17,6 +17,13 @@ description:
     - It will check first via de get-backend-prop if configuration needs to be applied.
 author:
     - Werner Dijkerman (@dj-wasabi)
+extends_documentation_fragment:
+    - community.general.attributes
+attributes:
+    check_mode:
+        support: full
+    diff_mode:
+        support: none
 options:
     opendj_bindir:
         description:

plugins/modules/openwrt_init.py

@@ -15,6 +15,13 @@ author:
 short_description: Manage services on OpenWrt
 description:
     - Controls OpenWrt services on remote hosts.
+extends_documentation_fragment:
+    - community.general.attributes
+attributes:
+    check_mode:
+        support: full
+    diff_mode:
+        support: none
 options:
     name:
         type: str

plugins/modules/pacemaker_cluster.py

@@ -17,6 +17,13 @@ author:
 description:
   - This module can manage a pacemaker cluster and nodes from Ansible using
     the pacemaker cli.
+extends_documentation_fragment:
+  - community.general.attributes
+attributes:
+    check_mode:
+      support: full
+    diff_mode:
+      support: none
 options:
     state:
       description:

plugins/modules/pmem.py

@@ -20,6 +20,13 @@ description:
 requirements:
  - ipmctl and ndctl command line tools
  - xmltodict
+extends_documentation_fragment:
+ - community.general.attributes
+attributes:
+  check_mode:
+    support: none
+  diff_mode:
+    support: none
 options:
   appdirect:
     description:

plugins/modules/pubnub_blocks.py

@@ -22,13 +22,20 @@ description:
   - "This module allows Ansible to interface with the PubNub BLOCKS
     infrastructure by providing the following operations: create / remove,
     start / stop and rename for blocks and create / modify / remove for event
-  handlers"
+    handlers."
 author:
   - PubNub <support@pubnub.com> (@pubnub)
   - Sergey Mamontov <sergey@pubnub.com> (@parfeon)
 requirements:
   - "python >= 2.7"
   - "pubnub_blocks_client >= 1.0"
+extends_documentation_fragment:
+  - community.general.attributes
+attributes:
+  check_mode:
+    support: full
+  diff_mode:
+    support: none
 options:
   email:
     description:
@@ -224,9 +231,10 @@ EXAMPLES = '''
 
 RETURN = '''
 module_cache:
-  description: "Cached account information. In case if with single play module
+  description:
+    - Cached account information. In case if with single play module
       used few times it is better to pass cached data to next module calls to speed
-  up process."
+      up process.
   type: dict
   returned: always
 '''

plugins/modules/pulp_repo.py

@@ -18,6 +18,11 @@ short_description: Add or remove Pulp repos from a remote host
 description:
   - Add or remove Pulp repos from a remote host.
   - Note, this is for Pulp 2 only.
+attributes:
+  check_mode:
+    support: full
+  diff_mode:
+    support: none
 options:
   add_export_distributor:
     description:
@@ -165,7 +170,8 @@ notes:
   - This module can currently only create distributors and importers on rpm
     repositories. Contributions to support other repo types are welcome.
 extends_documentation_fragment:
-  - url
+  - ansible.builtin.url
+  - community.general.attributes
 '''
 
 EXAMPLES = '''

plugins/modules/puppet.py

@@ -14,6 +14,13 @@ module: puppet
 short_description: Runs puppet
 description:
   - Runs I(puppet) agent or apply in a reliable manner.
+extends_documentation_fragment:
+  - community.general.attributes
+attributes:
+  check_mode:
+    support: full
+  diff_mode:
+    support: none
 options:
   timeout:
     description:

plugins/modules/pushbullet.py

@@ -17,6 +17,13 @@ module: pushbullet
 short_description: Sends notifications to Pushbullet
 description:
     - This module sends push notifications via Pushbullet to channels or devices.
+extends_documentation_fragment:
+    - community.general.attributes
+attributes:
+    check_mode:
+        support: full
+    diff_mode:
+        support: none
 options:
     api_key:
         type: str

plugins/modules/pushover.py

@@ -19,6 +19,13 @@ description:
 notes:
   - You will require a pushover.net account to use this module. But no account
     is required to receive messages.
+extends_documentation_fragment:
+  - community.general.attributes
+attributes:
+  check_mode:
+    support: none
+  diff_mode:
+    support: none
 options:
   msg:
     type: str

plugins/modules/serverless.py

@@ -13,7 +13,14 @@ DOCUMENTATION = r'''
 module: serverless
 short_description: Manages a Serverless Framework project
 description:
-     - Provides support for managing Serverless Framework (https://serverless.com/) project deployments and stacks.
+  - Provides support for managing Serverless Framework (U(https://serverless.com/)) project deployments and stacks.
+extends_documentation_fragment:
+  - community.general.attributes
+attributes:
+  check_mode:
+    support: none
+  diff_mode:
+    support: none
 options:
   state:
     description:

plugins/modules/sl_vm.py

@@ -15,6 +15,13 @@ short_description: Create or cancel a virtual instance in SoftLayer
 description:
   - Creates or cancels SoftLayer instances.
   - When created, optionally waits for it to be 'running'.
+extends_documentation_fragment:
+  - community.general.attributes
+attributes:
+  check_mode:
+    support: none
+  diff_mode:
+    support: none
 options:
   instance_id:
     description:

plugins/modules/ss_3par_cpg.py

@@ -18,6 +18,11 @@ author:
 description:
   - Create and delete CPG on HPE 3PAR.
 module: ss_3par_cpg
+attributes:
+  check_mode:
+    support: none
+  diff_mode:
+    support: none
 options:
   cpg_name:
     description:
@@ -88,6 +93,7 @@ options:
     default: false
 extends_documentation_fragment:
 - community.general.hpe3par
+- community.general.attributes
 
 '''
 

plugins/modules/vdo.py

@@ -24,6 +24,15 @@ description:
       provides inline block-level deduplication, compression, and
       thin provisioning capabilities to primary storage.
 
+extends_documentation_fragment:
+    - community.general.attributes
+
+attributes:
+    check_mode:
+        support: none
+    diff_mode:
+        support: none
+
 options:
     name:
         description:

plugins/modules/vexata_eg.py

@@ -20,6 +20,11 @@ description:
       through specific array ports.
 author:
   - Sandeep Kasargod (@vexata)
+attributes:
+  check_mode:
+    support: full
+  diff_mode:
+    support: none
 options:
   name:
     description:
@@ -46,6 +51,7 @@ options:
     type: str
 extends_documentation_fragment:
 - community.general.vexata.vx100
+- community.general.attributes
 
 '''
 

plugins/modules/vexata_volume.py

@@ -17,6 +17,11 @@ description:
     - Create, deletes or extend volumes on a Vexata VX100 array.
 author:
 - Sandeep Kasargod (@vexata)
+attributes:
+  check_mode:
+    support: full
+  diff_mode:
+    support: none
 options:
   name:
     description:
@@ -35,6 +40,7 @@ options:
     type: str
 extends_documentation_fragment:
 - community.general.vexata.vx100
+- community.general.attributes
 
 '''
 

plugins/modules/wakeonlan.py

@@ -15,6 +15,13 @@ module: wakeonlan
 short_description: Send a magic Wake-on-LAN (WoL) broadcast packet
 description:
   - The C(wakeonlan) module sends magic Wake-on-LAN (WoL) broadcast packets.
+extends_documentation_fragment:
+  - community.general.attributes
+attributes:
+  check_mode:
+    support: full
+  diff_mode:
+    support: none
 options:
   mac:
     description:

plugins/modules/znode.py

@@ -14,6 +14,13 @@ module: znode
 short_description: Create, delete, retrieve, and update znodes using ZooKeeper
 description:
     - Create, delete, retrieve, and update znodes using ZooKeeper.
+attributes:
+    check_mode:
+        support: none
+    diff_mode:
+        support: none
+extends_documentation_fragment:
+    - community.general.attributes
 options:
     hosts:
         description: