[PR #10874/750adb43 backport][stable-11] pipx: adjustments for pipx 1.8.0 (#10876)

pipx: adjustments for pipx 1.8.0 (#10874)

* pipx: adjustments for pipx 1.8.0

* add changelog frag

* typo

(cherry picked from commit 750adb431a)

Co-authored-by: Alexei Znamensky <103110+russoz@users.noreply.github.com>

changelogs/fragments/10874-pipx-180.yml

@@ -0,0 +1,2 @@
+minor_changes:
+  - pipx module_utils - use ``PIPX_USE_EMOJI`` to disable emojis in the output of ``pipx`` 1.8.0 (https://github.com/ansible-collections/community.general/pull/10874).

plugins/doc_fragments/pipx.py

@@ -23,12 +23,18 @@ options:
         itself.
     type: path
 requirements:
-  - This module requires C(pipx) version 1.7.0 or above. Please note that C(pipx) 1.7.0 requires Python 3.8 or above.
+  - This module requires C(pipx) version 1.7.0 or above.
+  - Please note that C(pipx) 1.7.0 requires Python 3.8 or above.
+  - Please note that C(pipx) 1.8.0 requires Python 3.9 or above.
 notes:
   - This module does not install the C(pipx) python package, however that can be easily done with the module M(ansible.builtin.pip).
-  - This module does not require C(pipx) to be in the shell C(PATH), but it must be loadable by Python as a module.
+  - This module does not require C(pipx) to be in the shell C(PATH), but it must be loadable by Python as a module, meaning
+    that C(python -m pipx) must work.
   - This module honors C(pipx) environment variables such as but not limited to E(PIPX_HOME) and E(PIPX_BIN_DIR) passed using
     the R(environment Ansible keyword, playbooks_environment).
+  - This module disabled emojis in the output of C(pipx) commands to reduce clutter. In C(pipx) 1.8.0, the environment variable
+    E(USE_EMOJI) was renamed to E(PIPX_USE_EMOJI) and for compatibility with both versions, starting in community.general
+    11.4.0, this module sets them both to C(0) to disable emojis.
 seealso:
   - name: C(pipx) command manual page
     description: Manual page for the command.

plugins/module_utils/pipx.py

@@ -64,7 +64,7 @@ def pipx_runner(module, command, **kwargs):
         module,
         command=command,
         arg_formats=arg_formats,
-        environ_update={'USE_EMOJI': '0'},
+        environ_update={'USE_EMOJI': '0', 'PIPX_USE_EMOJI': '0'},
         check_rc=True,
         **kwargs
     )