summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorMatt Davis <nitzmahone@users.noreply.github.com>2021-03-20 02:21:22 +0100
committerGitHub <noreply@github.com>2021-03-20 02:21:22 +0100
commitc6cf7986ab33249bbf7d1fe68b8084bebbd938fb (patch)
treece903ac584b33a81289dabd3fb14129cce4eb9a3
parentUse ArgumentSpecValidator in AnsibleModule (#73703) (diff)
downloadansible-c6cf7986ab33249bbf7d1fe68b8084bebbd938fb.tar.xz
ansible-c6cf7986ab33249bbf7d1fe68b8084bebbd938fb.zip
add porting guide info for optional module_utils (#73979)
-rw-r--r--docs/docsite/rst/porting_guides/porting_guide_core_2.11.rst2
1 files changed, 2 insertions, 0 deletions
diff --git a/docs/docsite/rst/porting_guides/porting_guide_core_2.11.rst b/docs/docsite/rst/porting_guides/porting_guide_core_2.11.rst
index 207df445d2..3ce202238a 100644
--- a/docs/docsite/rst/porting_guides/porting_guide_core_2.11.rst
+++ b/docs/docsite/rst/porting_guides/porting_guide_core_2.11.rst
@@ -39,6 +39,8 @@ Other:
* The configuration system now validates the ``choices`` field, so any settings that currently violate it and are currently ignored will now cause an error.
For example, `ANSIBLE_COLLECTIONS_ON_ANSIBLE_VERSION_MISMATCH=0` will now cause an error (valid choices are 'ignore', 'warn' or 'error').
* The ``ansible-galaxy`` command now uses ``resolvelib`` for resolving dependencies. In most cases this should not make a user-facing difference beyond being more performant, but we note it here for posterity and completeness.
+* Python ``module_utils`` imports may now be marked as optional during the module payload build by wrapping the ``import`` statement in a ``try`` or ``if`` block. This allows modules to use ``module_utils`` that may not be present in all versions of Ansible or a collection, and to perform arbitrary recovery or fallback actions during module runtime.
+
Deprecated
==========