rootiest
1341e2559e
Replace all ad-hoc inline comments between license headers and function declarations with consistent SYNOPSIS / DESCRIPTION / ARGUMENTS / RETURNS / EXAMPLE blocks across all 99 project-owned functions/ files. No executable logic, variable names, or exit codes were modified. Completes Task #6 from AGENTS.md (Retroactive Function Documentation Standardization).
59 lines
2.1 KiB
Fish
59 lines
2.1 KiB
Fish
# Copyright (C) 2026 Rootiest
|
|
# SPDX-License-Identifier: AGPL-3.0-or-later
|
|
|
|
# SYNOPSIS
|
|
# _fish_deps_status
|
|
#
|
|
# DESCRIPTION
|
|
# Prints a colored installed/missing status report for all managed fish shell
|
|
# dependencies, grouped by tier (required, integrations, recommended).
|
|
#
|
|
# EXAMPLE
|
|
# _fish_deps_status
|
|
function _fish_deps_status
|
|
_fish_deps_catalog
|
|
|
|
function __fds_print_dep --argument-names bin tier
|
|
if type -q $bin
|
|
# Special version check: fish < 4.0 is functionally incompatible
|
|
if test "$bin" = fish
|
|
set -l _major (fish --version 2>&1 | string match -r 'version (\d+)')[2]
|
|
if test -n "$_major"; and test "$_major" -lt 4
|
|
set -l _ver (fish --version 2>&1 | string replace 'fish, ' '')
|
|
set_color yellow; echo -n " ⚠ "; set_color normal
|
|
echo -n "$bin "
|
|
set_color brblack; echo "($_ver — upgrade to 4.0+ required)"; set_color normal
|
|
return
|
|
end
|
|
end
|
|
set_color green; echo -n " ✓ "; set_color normal
|
|
echo -n "$bin "
|
|
set_color brblack; echo "(Found at "(type -p $bin)")"; set_color normal
|
|
else if test "$tier" = rec
|
|
set_color yellow; echo -n " ⚠ "; set_color normal
|
|
echo -n "$bin "
|
|
set_color brblack; echo "(Not installed)"; set_color normal
|
|
else
|
|
set_color red; echo -n " ✗ "; set_color normal
|
|
echo -n "$bin "
|
|
set_color brblack; echo "(Not installed)"; set_color normal
|
|
end
|
|
end
|
|
|
|
for tier_label in "Required Dependencies:req" "Integrations:int" "Recommended Dependencies:rec"
|
|
set -l label (string split : $tier_label)[1]
|
|
set -l tier (string split : $tier_label)[2]
|
|
set_color cyan; echo $label; set_color normal
|
|
set -l i 1
|
|
for bin in $_fdc_bins
|
|
if test "$_fdc_tiers[$i]" = $tier
|
|
__fds_print_dep $bin $tier
|
|
end
|
|
set i (math $i + 1)
|
|
end
|
|
echo ""
|
|
end
|
|
|
|
functions -e __fds_print_dep
|
|
end
|