Capture the catalogue modules' remaining files directories and templates at mesh-catalog bb0fe93b for the moved catalogue tests (issue 1379)

Part 4 of 4 of go/testdata/beside.
2026-10-20 08:20:05 +00:00
parent 013d6231ed
commit 781ba6aeb4
163 changed files with 3255 additions and 0 deletions
@@ -0,0 +1,90 @@
+#!/bin/sh
+# power-moment MOMENT [--force] — run every module's code for one power moment (novox/hq ADR 0211).
+# Shipped by the mesh's power module; edit the catalogue.
+#
+# MOMENT is after-boot, before-sleep, after-wake, before-shutdown, on-mains or on-battery, or
+# `supply`, which reads the machine's power source and runs on-mains or on-battery once per change.
+#
+# The moment's file holds what the controller placed: each module's code under a line `# <module>`.
+# Each module's piece runs on its own, with sh, as root, bounded by MESH_POWER_BOUND seconds
+# (default 30) and killed 5 s after that, so one module that hangs cannot hold the machine awake or
+# stop the next module. Every outcome goes to the journal under the tag mesh-power.
+set -u
+
+moment=${1:-}
+force=${2:-}
+moments=/etc/mesh-power/moments
+bound=${MESH_POWER_BOUND:-30}
+runtime=/run/mesh-power
+
+say() { logger -t mesh-power -- "$*" 2>/dev/null || true; printf '%s\n' "$*"; }
+
+# The power source as the kernel says it: on mains when any Mains supply is online. A machine with
+# no Mains supply (a desktop, a server, a USB-C source only) has no source to change.
+source_now() {
+	found=no
+	for s in /sys/class/power_supply/*; do
+		[ "$(cat "$s/type" 2>/dev/null)" = Mains ] || continue
+		found=yes
+		[ "$(cat "$s/online" 2>/dev/null)" = 1 ] && { echo on-mains; return; }
+	done
+	[ "$found" = yes ] && echo on-battery || echo none
+}
+
+case "$moment" in
+supply)
+	now=$(source_now)
+	[ "$now" = none ] && exit 0
+	mkdir -p "$runtime"
+	last=$(cat "$runtime/source" 2>/dev/null || true)
+	[ "$now" = "$last" ] && [ "$force" != --force ] && exit 0
+	echo "$now" >"$runtime/source"
+	moment=$now
+	;;
+after-boot | before-sleep | after-wake | on-mains | on-battery) ;;
+before-shutdown)
+	# Run only while the machine is really going down. The unit that runs it is stopped at shutdown,
+	# and also when the module is taken off the machine; the second must not run anyone's shutdown code.
+	state=$(systemctl is-system-running 2>/dev/null || true)
+	if [ "$state" != stopping ] && [ "$force" != --force ]; then
+		say "moment=before-shutdown skipped: the system is $state, not stopping"
+		exit 0
+	fi
+	;;
+*)
+	echo "power-moment: no moment $moment (after-boot, before-sleep, after-wake, before-shutdown, on-mains, on-battery, supply)" >&2
+	exit 2
+	;;
+esac
+
+file="$moments/$moment"
+[ -r "$file" ] || { say "moment=$moment: nothing placed"; exit 0; }
+
+work=$(mktemp -d) || exit 1
+trap 'rm -rf "$work"' EXIT
+
+# One file per module piece, in the order the controller placed them. A line that is exactly
+# "# <module name>" opens a piece; lines before the first are the holder's own header.
+awk -v dir="$work" '
+	/^# [a-z0-9][a-z0-9-]*$/ { n++; name = substr($0, 3); out = sprintf("%s/%03d-%s", dir, n, name); next }
+	n > 0 { print > out }
+' "$file"
+
+ran=0 failed=0
+for piece in "$work"/*; do
+	[ -e "$piece" ] || continue
+	module=${piece##*/}
+	module=${module#*-}
+	start=$(date +%s)
+	timeout --kill-after=5 "$bound" sh "$piece" </dev/null >"$piece.out" 2>&1
+	rc=$?
+	took=$(($(date +%s) - start))
+	ran=$((ran + 1))
+	case $rc in
+	0) say "moment=$moment module=$module ok in ${took}s" ;;
+	124 | 137) failed=$((failed + 1)); say "moment=$moment module=$module ended after ${bound}s: it did not finish" ;;
+	*) failed=$((failed + 1)); say "moment=$moment module=$module exited $rc: $(tail -n 3 "$piece.out" | tr '\n' ' ')" ;;
+	esac
+done
+say "moment=$moment: $ran piece(s), $failed failed"
+exit 0
@@ -0,0 +1,9 @@
+[[block]]
+block = "battery"
+format = "$icon $percentage{ $time|}"
+charging_format = "$icon $percentage{ $time|}"
+not_charging_format = "$icon $percentage"
+full_format = "$icon $percentage"
+empty_format = "$icon $percentage"
+missing_format = ""
+
@@ -0,0 +1,6 @@
+[[block]]
+block = "custom"
+command = "~/.local/bin/i3status-value power.draw ${machine:name}"
+interval = 5
+hide_when_empty = true
+
@@ -0,0 +1,4 @@
+# What every module on this machine runs at the moment after-boot, as the mesh placed it (module power,
+# novox/hq ADR 0211). Replaced on every push: code is added by the module it belongs to, as a
+# contribution for this moment. Each module's piece runs on its own, as root, bounded in time.
+${shell:after-boot:first}${shell:after-boot:normal}${shell:after-boot:last}
@@ -0,0 +1,4 @@
+# What every module on this machine runs at the moment after-wake, as the mesh placed it (module power,
+# novox/hq ADR 0211). Replaced on every push: code is added by the module it belongs to, as a
+# contribution for this moment. Each module's piece runs on its own, as root, bounded in time.
+${shell:after-wake:first}${shell:after-wake:normal}${shell:after-wake:last}
@@ -0,0 +1,4 @@
+# What every module on this machine runs at the moment before-shutdown, as the mesh placed it (module power,
+# novox/hq ADR 0211). Replaced on every push: code is added by the module it belongs to, as a
+# contribution for this moment. Each module's piece runs on its own, as root, bounded in time.
+${shell:before-shutdown:first}${shell:before-shutdown:normal}${shell:before-shutdown:last}
@@ -0,0 +1,4 @@
+# What every module on this machine runs at the moment before-sleep, as the mesh placed it (module power,
+# novox/hq ADR 0211). Replaced on every push: code is added by the module it belongs to, as a
+# contribution for this moment. Each module's piece runs on its own, as root, bounded in time.
+${shell:before-sleep:first}${shell:before-sleep:normal}${shell:before-sleep:last}
@@ -0,0 +1,4 @@
+# What every module on this machine runs at the moment on-battery, as the mesh placed it (module power,
+# novox/hq ADR 0211). Replaced on every push: code is added by the module it belongs to, as a
+# contribution for this moment. Each module's piece runs on its own, as root, bounded in time.
+${shell:on-battery:first}${shell:on-battery:normal}${shell:on-battery:last}
@@ -0,0 +1,4 @@
+# What every module on this machine runs at the moment on-mains, as the mesh placed it (module power,
+# novox/hq ADR 0211). Replaced on every push: code is added by the module it belongs to, as a
+# contribution for this moment. Each module's piece runs on its own, as root, bounded in time.
+${shell:on-mains:first}${shell:on-mains:normal}${shell:on-mains:last}
@@ -0,0 +1,8 @@
+# Written by the mesh (module power, novox/hq ADR 0211). Replaced on every push.
+#
+# The power key and the lid, from this module's settings: the mesh's, then this machine's.
+[Login]
+HandlePowerKey=${config:handle-power-key}
+HandleLidSwitch=${config:handle-lid-switch}
+HandleLidSwitchExternalPower=${config:handle-lid-switch-external-power}
+HandleLidSwitchDocked=${config:handle-lid-switch-docked}
@@ -0,0 +1,3 @@
+# Written by the mesh (module power, novox/hq ADR 0211). Replaced on every push.
+[Unit]
+Wants=mesh-power-after-wake.service
@@ -0,0 +1,3 @@
+# Written by the mesh (module power, novox/hq ADR 0211). Replaced on every push.
+[Unit]
+Wants=mesh-power-after-wake.service
@@ -0,0 +1,13 @@
+# Written by the mesh (module power, novox/hq ADR 0211). Replaced on every push.
+[Unit]
+Description=Every module's code after boot (mesh power)
+Wants=network-online.target
+After=network-online.target
+
+[Service]
+Type=oneshot
+RemainAfterExit=yes
+ExecStart=/usr/local/lib/mesh-power/bin/power-moment after-boot
+
+[Install]
+WantedBy=multi-user.target
@@ -0,0 +1,11 @@
+# Written by the mesh (module power, novox/hq ADR 0211). Replaced on every push.
+#
+# Pulled in by the four sleep targets through this module's drop-ins on them, and ordered after
+# them, so it runs once the machine is awake again. Never enabled.
+[Unit]
+Description=Every module's code after waking (mesh power)
+After=suspend.target hibernate.target hybrid-sleep.target suspend-then-hibernate.target
+
+[Service]
+Type=oneshot
+ExecStart=/usr/local/lib/mesh-power/bin/power-moment after-wake
@@ -0,0 +1,18 @@
+# Written by the mesh (module power, novox/hq ADR 0211). Replaced on every push.
+#
+# Started at boot and left active; stopping it is the shutdown. Ordered after the network, so at
+# shutdown it stops, and runs every module's code, while the network is still up.
+[Unit]
+Description=Every module's code before shutdown (mesh power)
+Wants=network-online.target
+After=network-online.target
+
+[Service]
+Type=oneshot
+RemainAfterExit=yes
+ExecStart=/bin/true
+ExecStop=/usr/local/lib/mesh-power/bin/power-moment before-shutdown
+TimeoutStopSec=120
+
+[Install]
+WantedBy=multi-user.target
@@ -0,0 +1,11 @@
+# Written by the mesh (module power, novox/hq ADR 0211). Replaced on every push.
+#
+# Pulled in by sleep.target through this module's drop-in on it, never enabled: a one-shot waiting
+# for a sleep is not a service whose state the mesh can declare.
+[Unit]
+Description=Every module's code before sleep (mesh power)
+Before=sleep.target
+
+[Service]
+Type=oneshot
+ExecStart=/usr/local/lib/mesh-power/bin/power-moment before-sleep
@@ -0,0 +1,10 @@
+# Written by the mesh (module power, novox/hq ADR 0211). Replaced on every push.
+#
+# Started by the module's udev rule when a power supply changes; runs on-mains or on-battery once per
+# change of source.
+[Unit]
+Description=Every module's code for the power source (mesh power)
+
+[Service]
+Type=oneshot
+ExecStart=/usr/local/lib/mesh-power/bin/power-moment supply
@@ -0,0 +1,3 @@
+# Written by the mesh (module power, novox/hq ADR 0211). Replaced on every push.
+[Unit]
+Wants=mesh-power-before-sleep.service
@@ -0,0 +1,3 @@
+# Written by the mesh (module power, novox/hq ADR 0211). Replaced on every push.
+[Unit]
+Wants=mesh-power-after-wake.service
@@ -0,0 +1,3 @@
+# Written by the mesh (module power, novox/hq ADR 0211). Replaced on every push.
+[Unit]
+Wants=mesh-power-after-wake.service
@@ -0,0 +1,5 @@
+# Written by the mesh (module power, novox/hq ADR 0211). Replaced on every push.
+# Only the charger's change can switch the machine between mains and battery. A battery reports its
+# level many times a minute, and USB-C supplies come and go; matching them started the supply unit
+# every second or two on the laptop.
+SUBSYSTEM=="power_supply", ACTION=="change", ATTR{type}=="Mains", RUN+="/usr/bin/systemctl --no-block start mesh-power-supply.service"