saltext-apk 0.1.0

Salt extension restoring the apk package provider (apkpkg) removed from Salt core in 3008

saltext-apk

A Salt extension that restores the apkpkg execution module — the pkg provider for apk-based systems (Alpine Linux; OpenWrt 25.12+).

Why this exists

Salt 3008 removed salt/modules/apkpkg.py in its purge of community extensions (it was last present in v3007.14). Unlike many purged modules — saltext-zfs, for example — no replacement extension was published, so on Salt 3008 there is no pkg provider for apk at all. This package restores it.

It matters now because OpenWrt 25.12 switched its package manager from opkg to apk: Salt 3008 minions on OpenWrt have no working pkg module without this.

Status

0.1.0 is the v3007.14 module repackaged unchanged (only reformatted with ruff), so it behaves exactly as it did in Salt core: it enables on os_family == "Alpine", and on OpenWrt you still need a providers: pkg: apkpkg override.

The OpenWrt adaptation lands in 0.2.0:

• __virtual__ auto-detecting apk by its presence, so it loads on OpenWrt (os_family: OpenWrt) too — no override.
• list_pkgs using apk list --installed --manifest to correctly parse packages whose names contain hyphens or whose versions lack a -rN suffix — e.g. luci-app-mwan3 25.360.65088~78a62f2, which the original recorded under the wrong name so pkg.installed could never confirm it.

Install

Into the same environment as Salt (onedir / uv / system):

salt-pip install saltext-apk

or as a Salt state:

saltext.apk:
  pip.installed:
    - bin_env: /usr/bin/salt-pip

License

Apache-2.0 — the same license as the Salt code it derives from; see LICENSE. The apkpkg module is derived from SaltStack's salt/modules/apkpkg.py; copyright of the original portions remains with the SaltStack authors.