Prepare release 4.1.0 (#350)

* Prepare release 4.1.0

* [pre-commit.ci] auto fixes from pre-commit.com hooks

for more information, see https://pre-commit.ci

* review changes

* [pre-commit.ci] auto fixes from pre-commit.com hooks

for more information, see https://pre-commit.ci

---------

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>

CHANGELOG.rst

@@ -4,19 +4,28 @@ Ansible Utils Collection Release Notes
 
 .. contents:: Topics
 
+v4.1.0
+======
+
+Release Summary
+---------------
+
+In the last release (`v4.0.0`), we bumped the minimum required `netaddr` version to be `>=0.10.1`. However, since `netaddr>=0.10.1` is not yet available in many sources other than PyPI, we have temporarily added a fallback method to support the `ipaddr` filter with older `netaddr` versions with this release. Once the latest `netaddr` is available in all major sources, we will deprecate this support and eventually remove it.
+
 v4.0.0
 ======
 
 Release Summary
 ---------------
+
 Starting from this release, the minimum `netaddr` version this collection requires is `>=0.10.1`.
 
 Major Changes
 -------------
 
+- Bumping `netaddr` to `>=0.10.1`, means that starting from this release, the minimum `netaddr` version this collection requires is `>=0.10.1`.
 - This release mainly addresses the breaking changes in the `netaddr` library.
 - With the new release of `netaddr` 1.0.0, the `IPAddress.is_private()` method has been removed and instead, the `IPAddress.is_global()` method has been extended to support the same functionality. This change has been reflected in the `ipaddr` filter plugin.
-- Bumping `netaddr` to `>=0.10.1`, means that starting from this release, the minimum `netaddr` version this collection requires is `>=0.10.1`.
 
 v3.1.0
 ======

changelogs/changelog.yaml

@@ -97,6 +97,62 @@ releases:
       - add_missing_test_requirements.yml
       - fix_tests.yaml
     release_date: "2021-04-27"
+  2.10.0:
+    release_date: "2023-05-11"
+  2.10.1:
+    release_date: "2023-05-12"
+  2.10.2:
+    changes:
+      minor_changes:
+        - validate - Add option `check_format` for the jsonschema engine to disable
+          JSON Schema format checking.
+        - validate - Add support for JSON Schema draft 2019-09 and 2020-12 as well as
+          automatically choosing the draft from the `$schema` field of the criteria.
+    fragments:
+      - netaddr_error.yml
+      - pre-commit.yaml
+      - validate_jsonschema_update.yaml
+    release_date: "2023-05-13"
+  2.10.3:
+    fragments:
+      - fix_workflow_names.yml
+    release_date: "2023-05-17"
+  2.10.4:
+    release_date: "2023-05-19"
+  2.11.0:
+    changes:
+      bugfixes:
+        - Validate input for ipv4_hex(https://github.com/ansible-collections/ansible.utils/issues/281)
+      minor_changes:
+        - Add ipcut filter plugin.(https://github.com/ansible-collections/ansible.utils/issues/251)
+        - Add ipv6form filter plugin.(https://github.com/ansible-collections/ansible.utils/issues/230)
+    fragments:
+      - Bugfix_ipv4_hex.yaml
+      - ipcut.yaml
+      - ipv6form.yaml
+    plugins:
+      filter:
+        - description: This filter is designed to get 1st or last few bits of IP address.
+          name: ipcut
+          namespace: null
+        - description:
+            This filter is designed to convert ipv6 address in different
+            formats. For example expand, compressetc.
+          name: ipv6form
+          namespace: null
+    release_date: "2023-09-07"
+  2.12.0:
+    changes:
+      minor_changes:
+        - Fact_diff filter plugin - Add fact_diff filter plugin. (https://github.com/ansible-collections/ansible.utils/issues/78).
+    fragments:
+      - fact_diff_filter_plugin.yaml
+    plugins:
+      filter:
+        - description: Find the difference between currently set facts
+          name: fact_diff
+          namespace: null
+    release_date: "2023-11-27"
   2.2.0:
     changes:
       minor_changes:
@@ -322,62 +378,6 @@ releases:
       - fix_pre_commit.yaml
       - to_xml_disable_xml_declaration.yaml
     release_date: "2023-01-30"
-  2.10.0:
-    release_date: "2023-05-11"
-  2.10.1:
-    release_date: "2023-05-12"
-  2.10.2:
-    changes:
-      minor_changes:
-        - validate - Add option `check_format` for the jsonschema engine to disable
-          JSON Schema format checking.
-        - validate - Add support for JSON Schema draft 2019-09 and 2020-12 as well as
-          automatically choosing the draft from the `$schema` field of the criteria.
-    fragments:
-      - netaddr_error.yml
-      - pre-commit.yaml
-      - validate_jsonschema_update.yaml
-    release_date: "2023-05-13"
-  2.10.3:
-    fragments:
-      - fix_workflow_names.yml
-    release_date: "2023-05-17"
-  2.10.4:
-    release_date: "2023-05-19"
-  2.11.0:
-    changes:
-      bugfixes:
-        - Validate input for ipv4_hex(https://github.com/ansible-collections/ansible.utils/issues/281)
-      minor_changes:
-        - Add ipcut filter plugin.(https://github.com/ansible-collections/ansible.utils/issues/251)
-        - Add ipv6form filter plugin.(https://github.com/ansible-collections/ansible.utils/issues/230)
-    fragments:
-      - Bugfix_ipv4_hex.yaml
-      - ipcut.yaml
-      - ipv6form.yaml
-    plugins:
-      filter:
-        - description: This filter is designed to get 1st or last few bits of IP address.
-          name: ipcut
-          namespace: null
-        - description:
-            This filter is designed to convert ipv6 address in different
-            formats. For example expand, compressetc.
-          name: ipv6form
-          namespace: null
-    release_date: "2023-09-07"
-  2.12.0:
-    changes:
-      minor_changes:
-        - Fact_diff filter plugin - Add fact_diff filter plugin. (https://github.com/ansible-collections/ansible.utils/issues/78).
-    fragments:
-      - fact_diff_filter_plugin.yaml
-    plugins:
-      filter:
-        - description: Find the difference between currently set facts
-          name: fact_diff
-          namespace: null
-    release_date: "2023-11-27"
   3.0.0:
     changes:
       major_changes:
@@ -410,11 +410,29 @@ releases:
   4.0.0:
     changes:
       major_changes:
+        - Bumping `netaddr` to `>=0.10.1`, means that starting from this release, the
+          minimum `netaddr` version this collection requires is `>=0.10.1`.
         - This release mainly addresses the breaking changes in the `netaddr` library.
-        - With the new release of `netaddr` 1.0.0, the `IPAddress.is_private()` method has been removed and instead, the `IPAddress.is_global()` method has been extended to support the same functionality. This change has been reflected in the `ipaddr` filter plugin.
+        - With the new release of `netaddr` 1.0.0, the `IPAddress.is_private()` method
-        - Bumping `netaddr` to `>=0.10.1`, means that starting from this release, the minimum `netaddr` version this collection requires is `>=0.10.1`.
+          has been removed and instead, the `IPAddress.is_global()` method has been
-      release_summary: Starting from this release, the minimum `netaddr` version this collection requires is `>=0.10.1`.
+          extended to support the same functionality. This change has been reflected
+          in the `ipaddr` filter plugin.
+      release_summary:
+        Starting from this release, the minimum `netaddr` version this
+        collection requires is `>=0.10.1`.
     fragments:
       - netaddr_is_private_deprecation.yaml
       - trivial_tests_updates.yaml
     release_date: "2024-03-28"
+  4.1.0:
+    changes:
+      release_summary:
+        In the last release (`v4.0.0`), we bumped the minimum required
+        `netaddr` version to be `>=0.10.1`. However, since `netaddr>=0.10.1` is not
+        yet available in many sources other than PyPI, we have temporarily added a
+        fallback method to support the `ipaddr` filter with older `netaddr` versions
+        with this release. Once the latest `netaddr` is available in all major sources,
+        we will deprecate this support and eventually remove it.
+    fragments:
+      - ipaddress_is_global_fallback.yaml
+    release_date: "2024-04-15"

changelogs/fragments/ipaddress_is_global_fallback.yaml

@@ -1,5 +0,0 @@
----
-minor_changes:
-  - Implemented fallback to the IPAddress.is_private() method in cases where IPAddress.is_global() is not available. This adjustment ensures compatibility with netaddr versions older than 0.10.0.
-  - With the release of netaddr 1.0 (on 2024-02-10), the IPAddress.is_private() method was removed. Consequently, ansible.utils < 4.0 is only compatible with netaddr < 1.0, while ansible.utils >= 4.0 requires netaddr >= 0.10.1.
-  - To address compatibility issues with older netaddr versions, this pull request introduces backward compatibility by reverting to IPAddress.is_private() when IPAddress.is_global() is unavailable. This ensures smooth operation with netaddr versions prior to 0.10.0.

galaxy.yml

@@ -19,4 +19,4 @@ tags:
   - data
   - validation
   - utils
-version: 4.0.0
+version: 4.1.0