fix(roles/init): add assertion for package manager (#207)

* fix(roles/init): add assertion for package manager

* add changelog frag

Author: russoz

changelogs/fragments/207-init-assert-pkgmgr.yml

@@ -0,0 +1,2 @@
+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/pull/207).

roles/init/molecule/no_pkg_manager/converge.yml

@@ -0,0 +1,43 @@
+# Copyright (c) 2026, Alexei Znamensky (@russoz)
+# GNU General Public License v3.0+ (see LICENSE or https://www.gnu.org/licenses/gpl-3.0.txt)
+# SPDX-License-Identifier: GPL-3.0-or-later
+
+- name: Remove package manager
+  hosts: all
+  gather_facts: false
+  tasks:
+    - name: Block for init role (ssh failure)
+      block:
+        - name: Invoke init role
+          ansible.builtin.include_role:
+            name: community.openwrt.init
+          vars:
+            ansible_host: 192.168.255.255
+            openwrt_install_recommended_packages: false
+      rescue:
+        - name: Assert role fails
+          ansible.builtin.assert:
+            that:
+              - ansible_failed_result is failed
+              - >-
+                'Could not find package manager:' in ansible_failed_result.msg
+
+    - name: Remove package managers
+      community.openwrt.command:
+        cmd: mv /bin/opkg /bin/opkg.orig || mv /usr/bin/apk /usr/bin/apk.orig
+        uses_shell: true
+
+    - name: Block for init role (package manager is not there)
+      block:
+        - name: Invoke init role
+          ansible.builtin.include_role:
+            name: community.openwrt.init
+          vars:
+            openwrt_install_recommended_packages: false
+      rescue:
+        - name: Assert role fails
+          ansible.builtin.assert:
+            that:
+              - ansible_failed_result is failed
+              - >-
+                'Could not find package manager:' in ansible_failed_result.msg

roles/init/molecule/no_pkg_manager/molecule.yml

@@ -0,0 +1,11 @@
+# Copyright (c) 2026, Alexei Znamensky (@russoz)
+# GNU General Public License v3.0+ (see LICENSE or https://www.gnu.org/licenses/gpl-3.0.txt)
+# SPDX-License-Identifier: GPL-3.0-or-later
+
+driver:
+  name: docker
+scenario:
+  test_sequence:
+    - create
+    - converge
+    - destroy

roles/init/tasks/main.yml

@@ -32,13 +32,18 @@
   changed_when: false
   failed_when: false
 
+- name: Assert package manager is found
+  ansible.builtin.assert:
+    fail_msg: "Could not find package manager: neither `apk` nor `opkg` is available."
+    that:
+      - _apk_available.rc | default(1) == 0 or _opkg_available.rc | default(1) == 0
+
 - name: Check for package manager availability
   vars:
     has_apk: "{{ _apk_available.rc == 0 }}"
     has_opkg: "{{ _opkg_available.rc == 0 }}"
   ansible.builtin.set_fact:
     openwrt_package_manager: "{{ 'apk' if has_apk else ('opkg' if has_opkg else None) }}"
-  failed_when: not openwrt_package_manager
   check_mode: false
 
 - name: Install recommended packages for module compatibility