Release 1.4.0 (#235)

Author: russoz

CHANGELOG.md

@@ -2,45 +2,68 @@
 
 **Topics**
 
-- <a href="#v1-3-0">v1\.3\.0</a>
+- <a href="#v1-4-0">v1\.4\.0</a>
     - <a href="#release-summary">Release Summary</a>
     - <a href="#minor-changes">Minor Changes</a>
+- <a href="#v1-3-0">v1\.3\.0</a>
+    - <a href="#release-summary-1">Release Summary</a>
+    - <a href="#minor-changes-1">Minor Changes</a>
     - <a href="#breaking-changes--porting-guide">Breaking Changes / Porting Guide</a>
     - <a href="#bugfixes">Bugfixes</a>
 - <a href="#v1-2-0">v1\.2\.0</a>
-    - <a href="#release-summary-1">Release Summary</a>
-    - <a href="#minor-changes-1">Minor Changes</a>
+    - <a href="#release-summary-2">Release Summary</a>
+    - <a href="#minor-changes-2">Minor Changes</a>
     - <a href="#bugfixes-1">Bugfixes</a>
     - <a href="#new-modules">New Modules</a>
 - <a href="#v1-1-0">v1\.1\.0</a>
-    - <a href="#release-summary-2">Release Summary</a>
-    - <a href="#minor-changes-2">Minor Changes</a>
+    - <a href="#release-summary-3">Release Summary</a>
+    - <a href="#minor-changes-3">Minor Changes</a>
     - <a href="#bugfixes-2">Bugfixes</a>
     - <a href="#new-modules-1">New Modules</a>
 - <a href="#v1-0-0">v1\.0\.0</a>
-    - <a href="#release-summary-3">Release Summary</a>
-- <a href="#v0-4-0">v0\.4\.0</a>
     - <a href="#release-summary-4">Release Summary</a>
-    - <a href="#minor-changes-3">Minor Changes</a>
+- <a href="#v0-4-0">v0\.4\.0</a>
+    - <a href="#release-summary-5">Release Summary</a>
+    - <a href="#minor-changes-4">Minor Changes</a>
     - <a href="#new-modules-2">New Modules</a>
 - <a href="#v0-3-0">v0\.3\.0</a>
-    - <a href="#release-summary-5">Release Summary</a>
-- <a href="#v0-2-0">v0\.2\.0</a>
     - <a href="#release-summary-6">Release Summary</a>
-    - <a href="#minor-changes-4">Minor Changes</a>
+- <a href="#v0-2-0">v0\.2\.0</a>
+    - <a href="#release-summary-7">Release Summary</a>
+    - <a href="#minor-changes-5">Minor Changes</a>
     - <a href="#new-modules-3">New Modules</a>
 - <a href="#v0-1-0">v0\.1\.0</a>
-    - <a href="#release-summary-7">Release Summary</a>
+    - <a href="#release-summary-8">Release Summary</a>
+
+<a id="v1-4-0"></a>
+## v1\.4\.0
+
+<a id="release-summary"></a>
+### Release Summary
+
+Regular release\.
+
+<a id="minor-changes"></a>
+### Minor Changes
+
+* copy action plugin \- declare <code>\_file</code> shell module utils dependency \([https\://github\.com/ansible\-collections/community\.openwrt/issues/44](https\://github\.com/ansible\-collections/community\.openwrt/issues/44)\, [https\://github\.com/ansible\-collections/community\.openwrt/pull/233](https\://github\.com/ansible\-collections/community\.openwrt/pull/233)\)\.
+* file action plugin \- declare <code>\_file</code> shell module utils dependency \([https\://github\.com/ansible\-collections/community\.openwrt/issues/44](https\://github\.com/ansible\-collections/community\.openwrt/issues/44)\, [https\://github\.com/ansible\-collections/community\.openwrt/pull/233](https\://github\.com/ansible\-collections/community\.openwrt/pull/233)\)\.
+* lineinfile action plugin \- declare <code>\_file</code> shell module utils dependency \([https\://github\.com/ansible\-collections/community\.openwrt/issues/44](https\://github\.com/ansible\-collections/community\.openwrt/issues/44)\, [https\://github\.com/ansible\-collections/community\.openwrt/pull/233](https\://github\.com/ansible\-collections/community\.openwrt/pull/233)\)\.
+* openwrt\_action plugin utils \- add shell <code>module\_utils</code> support\, allowing action plugins to declare shell libraries that are transferred to the remote node and sourced before the module script runs \([https\://github\.com/ansible\-collections/community\.openwrt/issues/44](https\://github\.com/ansible\-collections/community\.openwrt/issues/44)\, [https\://github\.com/ansible\-collections/community\.openwrt/pull/233](https\://github\.com/ansible\-collections/community\.openwrt/pull/233)\)\.
+* slurp action plugin \- declare <code>\_file</code> shell module utils dependency \([https\://github\.com/ansible\-collections/community\.openwrt/issues/44](https\://github\.com/ansible\-collections/community\.openwrt/issues/44)\, [https\://github\.com/ansible\-collections/community\.openwrt/pull/233](https\://github\.com/ansible\-collections/community\.openwrt/pull/233)\)\.
+* stat action plugin \- declare <code>\_file</code> shell module utils dependency \([https\://github\.com/ansible\-collections/community\.openwrt/issues/44](https\://github\.com/ansible\-collections/community\.openwrt/issues/44)\, [https\://github\.com/ansible\-collections/community\.openwrt/pull/233](https\://github\.com/ansible\-collections/community\.openwrt/pull/233)\)\.
+* uci action plugin \- declare <code>\_file</code> shell module utils dependency \([https\://github\.com/ansible\-collections/community\.openwrt/issues/44](https\://github\.com/ansible\-collections/community\.openwrt/issues/44)\, [https\://github\.com/ansible\-collections/community\.openwrt/pull/233](https\://github\.com/ansible\-collections/community\.openwrt/pull/233)\)\.
+* wrapper \- refactor into a thin bootstrapper that sources each entry in <code>\_openwrt\_libs</code> before executing the module\; all shared framework code moved to <code>module\_utils/\_core\.sh</code> \([https\://github\.com/ansible\-collections/community\.openwrt/issues/44](https\://github\.com/ansible\-collections/community\.openwrt/issues/44)\, [https\://github\.com/ansible\-collections/community\.openwrt/pull/233](https\://github\.com/ansible\-collections/community\.openwrt/pull/233)\)\.
 
 <a id="v1-3-0"></a>
 ## v1\.3\.0
 
-<a id="release-summary"></a>
+<a id="release-summary-1"></a>
 ### Release Summary
 
 Regular and bugfix release\. This release include one braking change in the setup module\.
 
-<a id="minor-changes"></a>
+<a id="minor-changes-1"></a>
 ### Minor Changes
 
 * init role \- improve error\-handling when no package manager is found \([https\://github\.com/ansible\-collections/community\.openwrt/issues/204](https\://github\.com/ansible\-collections/community\.openwrt/issues/204)\, [https\://github\.com/ansible\-collections/community\.openwrt/pull/207](https\://github\.com/ansible\-collections/community\.openwrt/pull/207)\)\.
@@ -63,12 +86,12 @@ Regular and bugfix release\. This release include one braking change in the setu
 <a id="v1-2-0"></a>
 ## v1\.2\.0
 
-<a id="release-summary-1"></a>
+<a id="release-summary-2"></a>
 ### Release Summary
 
 Regular and bugfix release\.
 
-<a id="minor-changes-1"></a>
+<a id="minor-changes-2"></a>
 ### Minor Changes
 
 * copy action plugin \- remove redundant code \([https\://github\.com/ansible\-collections/community\.openwrt/pull/192](https\://github\.com/ansible\-collections/community\.openwrt/pull/192)\)\.
@@ -88,12 +111,12 @@ Regular and bugfix release\.
 <a id="v1-1-0"></a>
 ## v1\.1\.0
 
-<a id="release-summary-2"></a>
+<a id="release-summary-3"></a>
 ### Release Summary
 
 See [https\://github\.com/ansible\-collections/community\.openwrt/blob/main/CHANGELOG\.md](https\://github\.com/ansible\-collections/community\.openwrt/blob/main/CHANGELOG\.md) for all changes\.
 
-<a id="minor-changes-2"></a>
+<a id="minor-changes-3"></a>
 ### Minor Changes
 
 * init role \- enable check mode in the task checking package manager compatibility \([https\://github\.com/ansible\-collections/community\.openwrt/pull/136](https\://github\.com/ansible\-collections/community\.openwrt/pull/136)\)\.
@@ -116,22 +139,22 @@ See [https\://github\.com/ansible\-collections/community\.openwrt/blob/main/CHAN
 <a id="v1-0-0"></a>
 ## v1\.0\.0
 
-<a id="release-summary-3"></a>
+<a id="release-summary-4"></a>
 ### Release Summary
 
 First GA release of the community\.openwrt collection\.
 
 <a id="v0-4-0"></a>
 ## v0\.4\.0
 
-<a id="release-summary-4"></a>
+<a id="release-summary-5"></a>
 ### Release Summary
 
 Establish mechanism for integration testing\.
 Add support to the <code>apk</code> package manager\.
 Modules now have lifecycle functions <code>init\(\)</code> and <code>validate\(\)</code>\.
 
-<a id="minor-changes-3"></a>
+<a id="minor-changes-4"></a>
 ### Minor Changes
 
 * command \- use functions <code>init\(\)</code> and <code>validate\(\)</code> \([https\://github\.com/ansible\-collections/community\.openwrt/issues/47](https\://github\.com/ansible\-collections/community\.openwrt/issues/47)\, [https\://github\.com/ansible\-collections/community\.openwrt/pull/67](https\://github\.com/ansible\-collections/community\.openwrt/pull/67)\)\.
@@ -154,7 +177,7 @@ Modules now have lifecycle functions <code>init\(\)</code> and <code>validate\(\
 <a id="v0-3-0"></a>
 ## v0\.3\.0
 
-<a id="release-summary-5"></a>
+<a id="release-summary-6"></a>
 ### Release Summary
 
 Add <code>\.devcontainer</code> setup\.
@@ -166,15 +189,15 @@ Rename setup role to <code>community\.openwrt\.init</code>\.
 <a id="v0-2-0"></a>
 ## v0\.2\.0
 
-<a id="release-summary-6"></a>
+<a id="release-summary-7"></a>
 ### Release Summary
 
 Use action plugins to \"wrap\" shell\-based modules\.
 Update <code>build\_ignore</code> in <code>galaxy\.yml</code>\.
 Move module docs to <code>\.py</code> files\.
 Mark <code>shell\=ash</code> for <code>shellcheck</code>\.
 
-<a id="minor-changes-4"></a>
+<a id="minor-changes-5"></a>
 ### Minor Changes
 
 * command \- revamp the shell wrapping mechanism \([https\://github\.com/ansible\-collections/community\.openwrt/pull/14](https\://github\.com/ansible\-collections/community\.openwrt/pull/14)\)\.
@@ -214,7 +237,7 @@ Mark <code>shell\=ash</code> for <code>shellcheck</code>\.
 <a id="v0-1-0"></a>
 ## v0\.1\.0
 
-<a id="release-summary-7"></a>
+<a id="release-summary-8"></a>
 ### Release Summary
 
 This is the first release of the <code>community\.openwrt</code> collection\.

CHANGELOG.rst

@@ -4,6 +4,26 @@ Community OpenWrt Release Notes
 
 .. contents:: Topics
 
+v1.4.0
+======
+
+Release Summary
+---------------
+
+Regular release.
+
+Minor Changes
+-------------
+
+- copy action plugin - declare ``_file`` shell module utils dependency (https://github.com/ansible-collections/community.openwrt/issues/44, https://github.com/ansible-collections/community.openwrt/pull/233).
+- file action plugin - declare ``_file`` shell module utils dependency (https://github.com/ansible-collections/community.openwrt/issues/44, https://github.com/ansible-collections/community.openwrt/pull/233).
+- lineinfile action plugin - declare ``_file`` shell module utils dependency (https://github.com/ansible-collections/community.openwrt/issues/44, https://github.com/ansible-collections/community.openwrt/pull/233).
+- openwrt_action plugin utils - add shell ``module_utils`` support, allowing action plugins to declare shell libraries that are transferred to the remote node and sourced before the module script runs (https://github.com/ansible-collections/community.openwrt/issues/44, https://github.com/ansible-collections/community.openwrt/pull/233).
+- slurp action plugin - declare ``_file`` shell module utils dependency (https://github.com/ansible-collections/community.openwrt/issues/44, https://github.com/ansible-collections/community.openwrt/pull/233).
+- stat action plugin - declare ``_file`` shell module utils dependency (https://github.com/ansible-collections/community.openwrt/issues/44, https://github.com/ansible-collections/community.openwrt/pull/233).
+- uci action plugin - declare ``_file`` shell module utils dependency (https://github.com/ansible-collections/community.openwrt/issues/44, https://github.com/ansible-collections/community.openwrt/pull/233).
+- wrapper - refactor into a thin bootstrapper that sources each entry in ``_openwrt_libs`` before executing the module; all shared framework code moved to ``module_utils/_core.sh`` (https://github.com/ansible-collections/community.openwrt/issues/44, https://github.com/ansible-collections/community.openwrt/pull/233).
+
 v1.3.0
 ======
 

README.md

@@ -17,13 +17,13 @@ SPDX-License-Identifier: GPL-3.0-or-later
 
 This collection enables the automated configuration of your OpenWrt devices.
 
-We encourage new users to read the [User Guide](https://ansible-collections.github.io/community.openwrt/branch/main/docsite/user_guide.html)
-and the [How-To Guides](https://ansible-collections.github.io/community.openwrt/branch/main/docsite/howto_guide.html).
+We encourage new users to read the [User Guide](https://ansible-collections.github.io/community.openwrt/tag/1.4.0/docsite/user_guide.html)
+and the [How-To Guides](https://ansible-collections.github.io/community.openwrt/tag/1.4.0/docsite/howto_guide.html).
 
 If you are migrating from the `gekmihesg.openwrt` role, please read the
-[Migration Guide](https://ansible-collections.github.io/community.openwrt/branch/main/docsite/migration_guide.html). If you are upgrading to OpenWrt >= 25.x, please read the  [Migration APK Guide](https://ansible-collections.github.io/community.openwrt/branch/main/docsite/migration_apk_guide.html).
+[Migration Guide](https://ansible-collections.github.io/community.openwrt/tag/1.4.0/docsite/migration_guide.html). If you are upgrading to OpenWrt >= 25.x, please read the  [Migration APK Guide](https://ansible-collections.github.io/community.openwrt/tag/1.4.0/docsite/migration_apk_guide.html).
 
-Check the [complete documentation](https://ansible-collections.github.io/community.openwrt/branch/main/index.html) for the collection.
+Check the [complete documentation](https://ansible-collections.github.io/community.openwrt/tag/1.4.0/index.html) for the collection.
 Please note that this documentation reflects the state of the development branch.
 
 ## Our mission

changelogs/changelog.yaml

@@ -201,3 +201,30 @@ releases:
       - 218-fix-wait-for-connection-handler.yml
       - 219-copy-diff.yml
     release_date: '2026-04-21'
+  1.4.0:
+    changes:
+      minor_changes:
+        - copy action plugin - declare ``_file`` shell module utils dependency (https://github.com/ansible-collections/community.openwrt/issues/44,
+          https://github.com/ansible-collections/community.openwrt/pull/233).
+        - file action plugin - declare ``_file`` shell module utils dependency (https://github.com/ansible-collections/community.openwrt/issues/44,
+          https://github.com/ansible-collections/community.openwrt/pull/233).
+        - lineinfile action plugin - declare ``_file`` shell module utils dependency
+          (https://github.com/ansible-collections/community.openwrt/issues/44, https://github.com/ansible-collections/community.openwrt/pull/233).
+        - openwrt_action plugin utils - add shell ``module_utils`` support, allowing
+          action plugins to declare shell libraries that are transferred to the remote
+          node and sourced before the module script runs (https://github.com/ansible-collections/community.openwrt/issues/44,
+          https://github.com/ansible-collections/community.openwrt/pull/233).
+        - slurp action plugin - declare ``_file`` shell module utils dependency (https://github.com/ansible-collections/community.openwrt/issues/44,
+          https://github.com/ansible-collections/community.openwrt/pull/233).
+        - stat action plugin - declare ``_file`` shell module utils dependency (https://github.com/ansible-collections/community.openwrt/issues/44,
+          https://github.com/ansible-collections/community.openwrt/pull/233).
+        - uci action plugin - declare ``_file`` shell module utils dependency (https://github.com/ansible-collections/community.openwrt/issues/44,
+          https://github.com/ansible-collections/community.openwrt/pull/233).
+        - wrapper - refactor into a thin bootstrapper that sources each entry in ``_openwrt_libs``
+          before executing the module; all shared framework code moved to ``module_utils/_core.sh``
+          (https://github.com/ansible-collections/community.openwrt/issues/44, https://github.com/ansible-collections/community.openwrt/pull/233).
+      release_summary: Regular release.
+    fragments:
+      - 1.4.0.yml
+      - 233-module-utils.yml
+    release_date: '2026-05-22'

changelogs/fragments/233-module-utils.yml

@@ -20,7 +20,7 @@ tags:
   - networking
   - router
 repository: https://github.com/ansible-collections/community.openwrt
-documentation: https://ansible-collections.github.io/community.openwrt/branch/main/
+documentation: https://ansible-collections.github.io/community.openwrt/tag/1.4.0/
 homepage: https://github.com/ansible-collections/community.openwrt
 issues: https://github.com/ansible-collections/community.openwrt/issues