Add subcommands parameter for module alternatives.

changelogs/fragments/4654-alternatives-add-slaves.yml

@@ -0,0 +1,2 @@
+minor_changes:
+  - alternatives - add ``slaves`` parameter (https://github.com/ansible-collections/community.general/pull/4654).

plugins/modules/system/alternatives.py

@@ -51,6 +51,28 @@
     default: selected
     type: str
     version_added: 4.8.0
+  slaves:
+    description:
+      - A list of slaves.
+      - Each slave needs a name, a link and a path parameter.
+    type: list
+    elements: dict
+    suboptions:
+      name:
+        description:
+          - The generic name of the slave.
+        type: str
+        required: true
+      path:
+        description:
+          - The path to the real executable that the slave should point to.
+        type: path
+        required: true
+      link:
+        description:
+          - The path to the symbolic link that should point to the real slave executable.
+        type: path
+    version_added: 5.0.0
 requirements: [ update-alternatives ]
 '''
 
@@ -78,6 +100,16 @@
     path: /usr/bin/python3.5
     link: /usr/bin/python
     state: present
+
+- name: keytool is a slave of java
+  community.general.alternatives:
+    name: java
+    link: /usr/bin/java
+    path: /usr/lib/jvm/java-7-openjdk-amd64/jre/bin/java
+    slaves:
+      - name: keytool
+        link: /usr/bin/keytool
+        path: /usr/lib/jvm/java-7-openjdk-amd64/jre/bin/keytool
 '''
 
 import os
@@ -109,6 +141,11 @@ def main():
                 choices=AlternativeState.to_list(),
                 default=AlternativeState.SELECTED,
             ),
+            slaves=dict(type='list', elements='dict', options=dict(
+                name=dict(type='str', required=True),
+                path=dict(type='path', required=True),
+                link=dict(type='path'),
+            )),
         ),
         supports_check_mode=True,
     )
@@ -180,8 +217,13 @@ def main():
                 if not link:
                     module.fail_json(msg="Needed to install the alternative, but unable to do so as we are missing the link")
 
+                cmd = [UPDATE_ALTERNATIVES, '--install', link, name, path, str(priority)]
+                if params['slaves']:
+                    slaves = [['--slave', slave['link'], slave['name'], slave['path']] for slave in params['slaves']]
+                    cmd += [item for sublist in slaves for item in sublist]
+
                 module.run_command(
-                    [UPDATE_ALTERNATIVES, '--install', link, name, path, str(priority)],
+                    cmd,
                     check_rc=True
                 )
                 changed = True

tests/integration/targets/alternatives/tasks/main.yml

@@ -49,6 +49,9 @@
   # Test that path is checked: alternatives must fail when path is nonexistent
   - import_tasks: path_is_checked.yml
 
+  # Test that slave commands work
+  - import_tasks: slaves.yml
+
   # Test operation of the 'state' parameter
   - block:
     - include_tasks: remove_links.yml

tests/integration/targets/alternatives/tasks/slaves.yml

@@ -0,0 +1,34 @@
+- name: Try with slaves
+  alternatives:
+    name: dummymain
+    path: '/usr/bin/dummy1'
+    link: '/usr/bin/dummymain'
+    slaves:
+      - name: dummyslave
+        path: '/usr/bin/dummy2'
+        link: '/usr/bin/dummyslave'
+  register: alternative
+
+- name: Check expected command was executed
+  assert:
+    that:
+      - 'alternative is successful'
+      - 'alternative is changed'
+
+- name: Execute the current dummymain command
+  command: dummymain
+  register: cmd
+
+- name: Ensure that the expected command was executed
+  assert:
+    that:
+      - cmd.stdout == "dummy1"
+
+- name: Execute the current dummyslave command
+  command: dummyslave
+  register: cmd
+
+- name: Ensure that the expected command was executed
+  assert:
+    that:
+      - cmd.stdout == "dummy2"