From a49ad340af86680440ec502af65f667e8bbb6ff9 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?C=C3=A9dric=20Jeanneret?=
 <39397510+cjeanner@users.noreply.github.com>
Date: Tue, 14 Mar 2023 20:44:08 +0100
Subject: [PATCH] [make] Provide built command in the module output (#6160)

It may happen operator wants to get the built command instead of all the
parameters. This change injects a new entry in the dict output, showing
what command way actually launched.

This patch also takes the opportunity to add missing dots to some
documentation lines.
---
 .../fragments/6160-add-command-make-output.yml     |  2 ++
 plugins/modules/make.py                            | 14 +++++++++++---
 2 files changed, 13 insertions(+), 3 deletions(-)
 create mode 100644 changelogs/fragments/6160-add-command-make-output.yml

diff --git a/changelogs/fragments/6160-add-command-make-output.yml b/changelogs/fragments/6160-add-command-make-output.yml
new file mode 100644
index 0000000000..cf43107919
--- /dev/null
+++ b/changelogs/fragments/6160-add-command-make-output.yml
@@ -0,0 +1,2 @@
+minor_changes:
+  - make - add ``command`` return value to the module output (https://github.com/ansible-collections/community.general/pull/6160).
diff --git a/plugins/modules/make.py b/plugins/modules/make.py
index ec19b367c3..ebff6cfe11 100644
--- a/plugins/modules/make.py
+++ b/plugins/modules/make.py
@@ -89,6 +89,12 @@ chdir:
     - The value of the module parameter I(chdir).
   type: str
   returned: success
+command:
+  description:
+    - The command built and executed by the module.
+  type: str
+  returned: success
+  version_added: 6.5.0
 file:
   description:
     - The value of the module parameter I(file).
@@ -96,22 +102,23 @@ file:
   returned: success
 jobs:
   description:
-    - The value of the module parameter I(jobs)
+    - The value of the module parameter I(jobs).
   type: int
   returned: success
 params:
   description:
-    - The value of the module parameter I(params)
+    - The value of the module parameter I(params).
   type: dict
   returned: success
 target:
   description:
-    - The value of the module parameter I(target)
+    - The value of the module parameter I(target).
   type: str
   returned: success
 '''
 
 from ansible.module_utils.six import iteritems
+from ansible.module_utils.six.moves import shlex_quote
 from ansible.module_utils.basic import AnsibleModule
 
 
@@ -218,6 +225,7 @@ def main():
         chdir=module.params['chdir'],
         file=module.params['file'],
         jobs=module.params['jobs'],
+        command=' '.join([shlex_quote(part) for part in base_command]),
     )