Implement use of --with-suggests cpanm option

changelogs/fragments/9554-add-cpanm-option_with-recommands.yml

@@ -1,2 +1,3 @@
 minor_changes:
   - cpanm - enable usage of option ``--with-recommands`` (https://github.com/ansible-collections/community.general/issues/9554, https://github.com/ansible-collections/community.general/pull/9555).
+  - cpanm - enable usage of option ``--with-suggests`` (https://github.com/ansible-collections/community.general/issues/9554, https://github.com/ansible-collections/community.general/pull/9555).

plugins/modules/cpanm.py

@@ -63,6 +63,13 @@
     type: bool
     default: false
     version_added: 10.3.0
+  install_suggestions:
+    description:
+      - Installs dependencies declared as suggested per META spec.
+      - When these dependencies fail to install, cpanm continues the installation, since they are just suggestion.
+    type: bool
+    default: false
+    version_added: 10.3.0
   version:
     description:
       - Version specification for the perl module. When O(mode) is V(new), C(cpanm) version operators are accepted.
@@ -175,6 +182,7 @@ class CPANMinus(ModuleHelper):
             mirror_only=dict(type='bool', default=False),
             installdeps=dict(type='bool', default=False),
             install_recommendations=dict(type='bool', default=False),
+            install_suggestions=dict(type='bool', default=False),
             executable=dict(type='path'),
             mode=dict(type='str', default='new', choices=['compatibility', 'new']),
             name_check=dict(type='str')
@@ -190,6 +198,7 @@ class CPANMinus(ModuleHelper):
         mirror_only=cmd_runner_fmt.as_bool("--mirror-only"),
         installdeps=cmd_runner_fmt.as_bool("--installdeps"),
         install_recommendations=cmd_runner_fmt.as_bool("--with-recommends", "--without-recommend", ignore_none=True),
+        install_suggestions=cmd_runner_fmt.as_bool("--with-suggests", "--without-suggests", ignore_none=True),
         pkg_spec=cmd_runner_fmt.as_list(),
         cpanm_version=cmd_runner_fmt.as_fixed("--version"),
     )