mirror of
https://github.com/outbackdingo/hyprcosmic.git
synced 2026-08-25 14:53:21 +00:00
gitops
620941e18b
The header said the binaries were out of scope because `cargo` installs them. That was true when they were built by hand in three separate checkouts. The top-level justfile now installs all three, so the sentence pointed at the wrong thing -- someone looking for where cosmic-conf lands would have gone to cargo and found nothing. The scope is unchanged; only the reason was stale.
229 lines
8.9 KiB
Bash
Executable File
229 lines
8.9 KiB
Bash
Executable File
#!/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"
|
|
)
|
|
|
|
# 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
|
|
)
|
|
|
|
# Files under config/ that are deliberately NOT installed here, each with the
|
|
# thing that does install it. This list is not decoration: the audit below
|
|
# refuses to run unless every file under config/ appears in exactly one of the
|
|
# three lists, so adding a file forces a decision about where it belongs instead
|
|
# of letting it be quietly left out of all of them.
|
|
PER_USER=(
|
|
"config/autostart" # ~/.config/hyprcosmic/autostart, by hand
|
|
"config/cosmic.conf" # ~/.config/hyprcosmic/cosmic.conf, by hand
|
|
"config/waybar/style.css" # ~/.config/hyprcosmic/waybar/style.css; @imports a sibling theme.css
|
|
"config/rofi/config.rasi" # ~/.config/rofi/config.rasi, by `cosmic-conf import-theme --assets`
|
|
)
|
|
|
|
audit_config_tree() {
|
|
local f rel known=" ${PER_USER[*]} ${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
|
|
|
|
while IFS= read -r -d '' f; do
|
|
rel="${f#"$REPO"/}"
|
|
[[ "$known" == *" $rel "* ]] || unclassified+=("$rel")
|
|
done < <(find "$REPO/config" -type f -print0 | sort -z)
|
|
|
|
((${#unclassified[@]} == 0)) || die "not listed as shared or per-user: ${unclassified[*]}
|
|
Add each to SHARED or PER_USER 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/ 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"
|
|
}
|
|
|
|
# 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[@]}")
|
|
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
|