aboutsummaryrefslogtreecommitdiff
path: root/installer/lib/raid.sh
diff options
context:
space:
mode:
authorCraig Jennings <c@cjennings.net>2026-04-26 01:08:50 -0500
committerCraig Jennings <c@cjennings.net>2026-04-26 01:08:50 -0500
commit6b65665eca8a4b36b0b6eae4d761fccd7b4c1fc4 (patch)
tree69cbf8bf23d4d97c89979909d2f96f799ced92e2 /installer/lib/raid.sh
parentbdda6b17c83e0e298c76bbaf146f082218389cd8 (diff)
downloadarchangel-6b65665eca8a4b36b0b6eae4d761fccd7b4c1fc4.tar.gz
archangel-6b65665eca8a4b36b0b6eae4d761fccd7b4c1fc4.zip
refactor: extract get_raid_level fzf preview into raid.sh helper
`get_raid_level()` carried a 98-line inline fzf `--preview` shell snippet that contained five nearly-parallel `case` branches emitting per-level preview text, plus three exported variables (`RAID_DISK_COUNT`, `RAID_TOTAL_GB`, `RAID_SMALLEST_GB`) just to pass values into the fzf preview subshell. The inline shell-in-shell had no syntax highlighting, no shellcheck on the inner snippet, and any edit to preview copy meant editing inside a single-quoted argument. I extracted the per-level text into a new `raid_preview(level, disk_count, total_gb, smallest_gb)` helper in `lib/raid.sh`. It reuses the existing `raid_fault_tolerance` and `raid_usable_bytes` primitives for the data lines instead of redoing the arithmetic inline. That keeps the math in one place. The fzf `--preview` argument is now a one-liner that calls `raid_preview` with the sizing values, and the env-var exports are gone. `export -f raid_preview raid_fault_tolerance raid_usable_bytes` makes the functions visible in fzf's preview subshell. I verified this against a fresh `bash -c` subshell, which is what fzf spawns internally. `get_raid_level()` shrinks from 144 to 49 lines. Preview text is now bats-tested. Added 8 unit tests across the 5 RAID levels (headline, fault-tolerance line, computed usable space), mixed-size handling for mirror (smallest disk, not average), unknown level returning 1 with empty output, and a sanity loop confirming every valid level produces non-empty output. No behavior change. The preview pane shows the same text, the same level options, the same selected output. The pure logic in `lib/raid.sh` is unchanged.
Diffstat (limited to 'installer/lib/raid.sh')
-rw-r--r--installer/lib/raid.sh119
1 files changed, 119 insertions, 0 deletions
diff --git a/installer/lib/raid.sh b/installer/lib/raid.sh
index 3e28177..6eccfa7 100644
--- a/installer/lib/raid.sh
+++ b/installer/lib/raid.sh
@@ -68,3 +68,122 @@ raid_fault_tolerance() {
*) return 1 ;;
esac
}
+
+#############################
+# Preview text
+#############################
+
+# Print preview text for a single RAID level. Used by get_raid_level()
+# in the fzf preview pane. Calls raid_fault_tolerance and
+# raid_usable_bytes for the data lines so the math stays in one place.
+# Numeric arguments are unit-agnostic — pass GB if you want GB out.
+#
+# Usage: raid_preview LEVEL DISK_COUNT TOTAL_GB SMALLEST_GB
+# Returns 1 for unknown level (no output).
+raid_preview() {
+ local level=$1 count=$2 total=$3 small=$4
+ local tol usable
+
+ tol=$(raid_fault_tolerance "$level" "$count") || return 1
+ usable=$(raid_usable_bytes "$level" "$count" "$small" "$total") || return 1
+
+ case "$level" in
+ mirror)
+ cat <<EOF
+MIRROR
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+All disks contain identical copies of data.
+Maximum redundancy. Can survive loss of all
+disks except one.
+
+Redundancy: Can lose $tol of $count disks
+Usable space: ~${usable}GB (smallest disk)
+Read speed: Fast (parallel reads)
+Write speed: Normal
+
+Best for:
+ - Boot drives
+ - Critical data
+ - Maximum safety
+EOF
+ ;;
+ stripe)
+ cat <<EOF
+STRIPE (RAID0)
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+WARNING: NO REDUNDANCY!
+Data is striped across all disks.
+ANY disk failure = ALL data lost!
+
+Redundancy: NONE
+Usable space: ~${usable}GB (all disks)
+Read speed: Very fast
+Write speed: Very fast
+
+Best for:
+ - Scratch/temp space
+ - Replaceable data
+ - Maximum performance
+EOF
+ ;;
+ raidz1)
+ cat <<EOF
+RAIDZ1 (Single Parity)
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+One disk worth of parity distributed
+across all disks.
+
+Redundancy: Can lose $tol of $count disks
+Usable space: ~${usable}GB ($((count - 1)) of $count disks)
+Read speed: Fast
+Write speed: Good
+
+Best for:
+ - General storage
+ - Good balance of space/safety
+EOF
+ ;;
+ raidz2)
+ cat <<EOF
+RAIDZ2 (Double Parity)
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+Two disks worth of parity distributed
+across all disks.
+
+Redundancy: Can lose $tol of $count disks
+Usable space: ~${usable}GB ($((count - 2)) of $count disks)
+Read speed: Fast
+Write speed: Good
+
+Best for:
+ - Large arrays (5+ disks)
+ - Important data
+EOF
+ ;;
+ raidz3)
+ cat <<EOF
+RAIDZ3 (Triple Parity)
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+Three disks worth of parity distributed
+across all disks.
+
+Redundancy: Can lose $tol of $count disks
+Usable space: ~${usable}GB ($((count - 3)) of $count disks)
+Read speed: Fast
+Write speed: Moderate
+
+Best for:
+ - Very large arrays (8+ disks)
+ - Archival storage
+EOF
+ ;;
+ *)
+ return 1
+ ;;
+ esac
+}