From 7b8500dea137ebd4d7d86ae4c453a9e07be83ebe Mon Sep 17 00:00:00 2001 From: "Eric L." Date: Sat, 9 Mar 2024 17:03:48 +0100 Subject: [PATCH 1/2] The ipaddr/ipv4/ipv6 filters have moved from netcommon to utils --- docs/docsite/rst/playbook_guide/playbooks_filters.rst | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/docsite/rst/playbook_guide/playbooks_filters.rst b/docs/docsite/rst/playbook_guide/playbooks_filters.rst index ac01a6010f3..0e1791980fa 100644 --- a/docs/docsite/rst/playbook_guide/playbooks_filters.rst +++ b/docs/docsite/rst/playbook_guide/playbooks_filters.rst @@ -1253,24 +1253,24 @@ To test if a string is a valid IP address: .. code-block:: yaml+jinja - {{ myvar | ansible.netcommon.ipaddr }} + {{ myvar | ansible.utils.ipaddr }} You can also require a specific IP protocol version: .. code-block:: yaml+jinja - {{ myvar | ansible.netcommon.ipv4 }} - {{ myvar | ansible.netcommon.ipv6 }} + {{ myvar | ansible.utils.ipv4 }} + {{ myvar | ansible.utils.ipv6 }} IP address filter can also be used to extract specific information from an IP address. For example, to get the IP address itself from a CIDR, you can use: .. code-block:: yaml+jinja - {{ '192.0.2.1/24' | ansible.netcommon.ipaddr('address') }} + {{ '192.0.2.1/24' | ansible.utils.ipaddr('address') }} # => 192.0.2.1 -More information about :ansplugin:`ansible.netcommon.ipaddr#filter` filter and complete usage guide can be found +More information about :ansplugin:`ansible.utils.ipaddr#filter` filter and complete usage guide can be found in :ref:`playbooks_filters_ipaddr`. .. _network_filters: From 461eff64e7b6fc05d7b6d6babc1a194aad8b0e94 Mon Sep 17 00:00:00 2001 From: Don Naro Date: Thu, 21 Mar 2024 15:49:33 +0000 Subject: [PATCH 2/2] update refs --- docs/docsite/rst/playbook_guide/playbooks_filters.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/docsite/rst/playbook_guide/playbooks_filters.rst b/docs/docsite/rst/playbook_guide/playbooks_filters.rst index 0e1791980fa..6c25eabc377 100644 --- a/docs/docsite/rst/playbook_guide/playbooks_filters.rst +++ b/docs/docsite/rst/playbook_guide/playbooks_filters.rst @@ -1240,7 +1240,7 @@ These filters help you with common network tasks. .. note:: - These filters have migrated to the `ansible.netcommon `_ collection. Follow the installation instructions to install that collection. + These filters have migrated to the `ansible.utils `_ collection. Follow the installation instructions to install that collection. .. _ipaddr_filter: @@ -1271,7 +1271,7 @@ address. For example, to get the IP address itself from a CIDR, you can use: # => 192.0.2.1 More information about :ansplugin:`ansible.utils.ipaddr#filter` filter and complete usage guide can be found -in :ref:`playbooks_filters_ipaddr`. +in :ref:`plugins_in_ansible.utils`. .. _network_filters: