updates

Pending package upgrades (pacman, optionally AUR), install progress and whether a reboot is due.

mantle.updates:configure({ interval = 3600 })

button {
    on_click = function() mantle.updates:check() end,
    children = {
        text {
            content = mantle.updates:map(function(updates)
                if updates == nil or updates.checking then
                    return "…"
                end
                return updates.count > 0 and (updates.count .. " updates") or "up to date"
            end),
        },
    },
}

State

mantle.updates:get() returns UpdatesState, nil before the first push. A field marked ? may be absent.

mantle.updates’s payload.

UpdateCandidate

One installed package with a newer version.

Actions

Call each as mantle.updates:<action>(arguments...); ? marks an argument you may omit.

UpdatesConfigure

configure’s table. One wrong-typed key drops the whole call.

Backend

The first manager that owns / wins, each on PATH at start: pacman with packages in /var/lib/pacman/local, else apt-get with packages in /var/lib/dpkg/status, else dnf. With none, package_manager is nil and every action is ignored. The dnf and apt backends are verified in containers only, untested on a Fedora or Ubuntu install for now.

Every check runs as you and leaves the system’s package databases untouched. pkexec asks the session’s polkit agent; the polkit rule makes that one approval per run for wheel users of pacman, and dnf and apt install in one pkexec call, so one prompt. reboot_required mirrors /run/mantle-reboot-required through an inotify watch on /run, whatever the manager.

What packages holds differs by manager:

How do I…

Remember the last check across restarts

Save each successful check in a persistent_table, and send configure only once the file has loaded, so its seed lands before the first scheduled check.

local dir = (os.getenv("HOME") or "") .. "/.local/state/myshell"
local cache = persistent_table { path = dir, name = "updates.json" }
local file = dir .. "/updates.json"

mantle.storage:on_change(function(storage, previous)
    local saved = storage.files[file]
    if saved and not (previous and previous.files[file]) then
        mantle.updates:configure({
            interval = 3600,
            checked_at = saved.checked_at,
            packages = saved.packages,
        })
    end
end)

mantle.updates:on_change(function(updates, previous)
    local at = updates.last_successful_check
    if at and at ~= (previous and previous.last_successful_check) then
        cache:set("checked_at", at)
        cache:set("packages", updates.packages)
    end
end)

return text {
    content = mantle.updates:map(function(updates)
        return updates and tostring(updates.count) or ""
    end),
}

Gotchas

Source: supervisor/src/capabilities/updates/