hyprcosmic/tools/install-assets.sh

#!/usr/bin/bash
#
# Install the parts of HyprCosmic that live outside a user's home directory.
#
# WHY THIS SCRIPT EXISTS
# ----------------------
# Everything here was placed by hand with `sudo install` while the desktop was
# being built, which left two problems that this script exists to close:
#
#   1. A fresh machine has none of it. rofi's config.rasi @imports
#      /usr/share/hyprcosmic/rofi/{palette,rules}.rasi by absolute path, and a
#      missing @import is an error rofi renders *in place of the launcher*
#      rather than a warning it skips. Miss those two files and Super+A shows a
#      parse error instead of a menu.
#
#   2. Hand-installed files drift. /usr/bin/start-hyprcosmic silently gained a
#      session-logging block during debugging that never made it back to the
#      copy under version control; nothing noticed until the two were diffed on
#      a hunch. `--check` is the cure: it compares every managed file against
#      its source and exits non-zero on any difference.
#
# WHAT IT DOES NOT DO
# -------------------
# Per-user files. `cosmic-conf import-theme --assets` writes those, because they
# depend on the installed theme and on $HOME; see PER_USER below for the list
# and its owner. The cosmic-conf, cosmic-session and cosmic-comp binaries are
# also out of scope. The top-level justfile installs them -- cosmic-conf from
# its own `install` line, the other two from their component's recipe -- and
# they are build outputs, so comparing them byte-for-byte here would only ever
# report a rebuild.
#
# Usage:
#   tools/install-assets.sh              install (needs write access to PREFIX)
#   tools/install-assets.sh --check      compare only; exit 1 on any drift
#   tools/install-assets.sh --dry-run    print what install would do
#   tools/install-assets.sh --no-session skip start-hyprcosmic and the .desktop
#
# Environment:
#   PREFIX   install prefix, default /usr    (see the warning below)
#   DESTDIR  staging root for packaging, prepended to every path

set -uo pipefail

REPO="$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")/.." && pwd)"
PREFIX="${PREFIX:-/usr}"
DESTDIR="${DESTDIR:-}"

MODE=install
WITH_SESSION=1

# Kept for the "re-run as sudo" hint, which has to quote the invocation the user
# actually made; $@ is long gone by the time a write fails.
ARGV=("$@")

die() { printf 'install-assets: %s\n' "$*" >&2; exit 1; }
warn() { printf 'install-assets: %s\n' "$*" >&2; }

while (($#)); do
    case "$1" in
        --check)      MODE=check ;;
        --dry-run)    MODE=dry-run ;;
        --no-session) WITH_SESSION=0 ;;
        -h|--help)    sed -n '2,/^set -uo/p' "${BASH_SOURCE[0]}" | sed 's/^# \?//;$d'; exit 0 ;;
        *)            die "unknown argument: $1 (try --help)" ;;
    esac
    shift
done

# Files under config/ that belong to the system, as "source:destination:mode".
# Destinations are relative to $PREFIX.
SHARED=(
    "config/waybar/bridge-hyde.css:share/hyprcosmic/waybar/bridge-hyde.css:644"
    "config/waybar/config.jsonc:share/hyprcosmic/waybar/config.jsonc:644"
    "config/waybar/palette.css:share/hyprcosmic/waybar/palette.css:644"
    "config/waybar/rules.css:share/hyprcosmic/waybar/rules.css:644"
    "config/rofi/palette.rasi:share/hyprcosmic/rofi/palette.rasi:644"
    "config/rofi/rules.rasi:share/hyprcosmic/rofi/rules.rasi:644"
    "config/bin/hyprcosmic-powermenu:bin/hyprcosmic-powermenu:755"
    "config/bin/hyprcosmic-fan:bin/hyprcosmic-fan:755"
    "config/bin/hyprcosmic-keybinds:bin/hyprcosmic-keybinds:755"
    "config/bin/hyprcosmic-wallpaper:bin/hyprcosmic-wallpaper:755"
)

# The session entry point. Kept apart from SHARED because it is versioned in the
# cosmic-session fork rather than in this repository -- that fork is a separate
# checkout and may simply be absent, in which case these are skipped.
SESSION=(
    "cosmic-session/data/start-hyprcosmic:bin/start-hyprcosmic:755"
    "cosmic-session/data/hyprcosmic.desktop:share/wayland-sessions/hyprcosmic.desktop:644"
)

# Files under config/ that produce a SHARED file rather than being one. They are
# inputs to a generator and have no place on the system: installing the template
# would put a file full of @@TOKEN@@ placeholders next to the real config, and
# whichever one a future reader opened first would be a coin toss.
SOURCES=(
    "config/waybar/config.jsonc.in"       # -> config/waybar/config.jsonc
    "config/waybar/generate-config.py"    # the generator, and the icon table
)

# Per-user files. These cannot live in share/hyprcosmic with the rest: style.css
# and config.rasi reach their theme through relative @imports, which resolve
# against the importing file, so the importer has to sit in the same per-user
# directory as the theme it picks up.
#
# They are still installed, as a skeleton. start-hyprcosmic copies anything
# missing out of share/hyprcosmic/skel into $XDG_CONFIG_HOME when a session
# starts, and never overwrites. Destinations below therefore mirror the layout
# under ~/.config exactly -- skel/hyprcosmic/autostart becomes
# ~/.config/hyprcosmic/autostart -- because the seeding is a plain copy that
# reads the layout off this tree rather than a list it keeps in step by hand.
#
# Before this existed the answer was "by hand", which meant a machine that had
# never seen HyprCosmic logged into a bare compositor: no autostart, so no
# waybar and no wallpaper, and no keybindings, on a screen with nothing drawn on
# it. Nothing reported an error, because from the session's point of view
# nothing had gone wrong.
SKEL=(
    "config/autostart:share/hyprcosmic/skel/hyprcosmic/autostart:644"
    "config/cosmic.conf:share/hyprcosmic/skel/hyprcosmic/cosmic.conf:644"
    "config/waybar/style.css:share/hyprcosmic/skel/hyprcosmic/waybar/style.css:644"
    "config/waybar/theme.css:share/hyprcosmic/skel/hyprcosmic/waybar/theme.css:644"
    "config/rofi/config.rasi:share/hyprcosmic/skel/rofi/config.rasi:644"
    "config/rofi/theme.rasi:share/hyprcosmic/skel/rofi/theme.rasi:644"
    "config/rofi/local.rasi:share/hyprcosmic/skel/rofi/local.rasi:644"
)

# Refuses to run unless every file under config/ appears in exactly one of
# SHARED, SKEL or SOURCES. This is not decoration: adding a file forces a
# decision about where it belongs instead of letting it be quietly left out of
# all three and never installed.
audit_config_tree() {
    local f rel known=" ${SOURCES[*]} " unclassified=()
    # Built with a loop, not `${SHARED[*]%%:*}`: that form strips the suffix
    # from the first element only and silently keeps the rest whole.
    for f in "${SHARED[@]}"; do known+="${f%%:*} "; done
    for f in "${SKEL[@]}"; do known+="${f%%:*} "; done

    while IFS= read -r -d '' f; do
        rel="${f#"$REPO"/}"
        [[ "$known" == *" $rel "* ]] || unclassified+=("$rel")
    # Dot-directories are pruned. Nothing shipped lives in one, and tooling
    # drops state inside the tree without asking -- .omc/ appeared under
    # config/waybar/ and failed this audit with six files that are gitignored
    # and are not assets. Failing on those trains you to ignore the one message
    # that catches a genuinely unclassified file. Dot *files* are still walked;
    # only directories are pruned.
    done < <(find "$REPO/config" -name '.?*' -type d -prune -o -type f -print0 | sort -z)

    ((${#unclassified[@]} == 0)) || die "not listed as shared, skeleton or generator input: ${unclassified[*]}
  Add each to SHARED, SKEL or SOURCES in $(basename "${BASH_SOURCE[0]}") and say which."
}

# The prefix is only half honoured, and pretending otherwise would be worse than
# saying so. Some consumers name /usr/share/hyprcosmic as a literal because they
# have no way to interpolate one: rofi's .rasi has no variables, and the
# autostart file is explicitly not a shell. Report them by grepping rather than
# from a hardcoded list, so this warning cannot go stale.
check_prefix_assumptions() {
    [[ "$PREFIX" == /usr ]] && return 0
    local hits
    hits="$(cd "$REPO" && grep -rl '/usr/share/hyprcosmic' config/ cosmic-session/data/ 2>/dev/null | sort | tr '\n' ' ')"
    [[ -z "$hits" ]] && return 0
    warn "PREFIX=$PREFIX, but these name /usr/share/hyprcosmic literally and cannot interpolate it:"
    warn "  $hits"
    warn "they will keep reading /usr/share unless you edit them; rofi will show a parse error if it is empty"
    warn "start-hyprcosmic is the exception: set HYPRCOSMIC_SKEL=$PREFIX/share/hyprcosmic/skel to point the seeding at this prefix"
}

# Fail before touching anything rather than half way through. The nearest
# existing ancestor is what matters: install(1) creates the leaf directories, so
# an absent share/hyprcosmic/rofi is fine as long as share/ can be written.
assert_writable() {
    local dest="$1" dir
    dir="$(dirname "$dest")"
    while [[ ! -e "$dir" && "$dir" != / ]]; do dir="$(dirname "$dir")"; done
    [[ -w "$dir" ]] && return 0
    if ((EUID != 0)); then
        die "$dir is not writable. Re-run as: sudo ${BASH_SOURCE[0]}${ARGV[*]:+ ${ARGV[*]}}"
    fi
    die "$dir is not writable, even as root"
}

status=0
installed=0 skipped=0 differs=0

handle() {
    local src="$REPO/$1" dest="$DESTDIR$PREFIX/$2" mode="$3"

    if [[ ! -f "$src" ]]; then
        warn "missing source, skipped: $1"
        skipped=$((skipped + 1))
        return
    fi

    case "$MODE" in
        check)
            if [[ ! -e "$dest" ]]; then
                printf '  MISSING  %s\n' "$dest"
                differs=$((differs + 1))
            elif cmp -s "$src" "$dest"; then
                printf '  ok       %s\n' "$dest"
            else
                printf '  DIFFERS  %s\n' "$dest"
                differs=$((differs + 1))
            fi
            ;;
        dry-run)
            printf '  would install -m %s %s -> %s\n' "$mode" "$1" "$dest"
            ;;
        install)
            assert_writable "$dest"
            install -D -m "$mode" "$src" "$dest" || die "failed to install $dest"
            printf '  %s\n' "$dest"
            installed=$((installed + 1))
            ;;
    esac
}

audit_config_tree
[[ "$MODE" == install ]] && check_prefix_assumptions

targets=("${SHARED[@]}" "${SKEL[@]}")
if ((WITH_SESSION)); then
    if [[ -d "$REPO/cosmic-session/data" ]]; then
        targets+=("${SESSION[@]}")
    else
        warn "cosmic-session/data is absent; skipping the session entry point"
    fi
fi

case "$MODE" in
    check)   echo "Checking against $DESTDIR$PREFIX:" ;;
    dry-run) echo "Dry run against $DESTDIR$PREFIX:" ;;
    install) echo "Installing to $DESTDIR$PREFIX:" ;;
esac

for spec in "${targets[@]}"; do
    IFS=: read -r src dest mode <<<"$spec"
    handle "$src" "$dest" "$mode"
done

case "$MODE" in
    check)
        if ((differs)); then
            echo "$differs file(s) missing or out of date; re-run without --check to fix" >&2
            status=1
        else
            echo "All ${#targets[@]} file(s) match."
        fi
        ;;
    install)
        echo "Installed $installed file(s)."
        ((skipped)) && echo "Skipped $skipped missing source(s)." >&2
        ;;
esac

exit $status