Files
fish-config/functions/top.fish
T
Claude fd64335207 docs: add DEPENDENCIES sections to function doc headers
Documents what each function needs for full functionality -- other
repo functions it calls, and external CLI tools it uses or falls
back gracefully without (e.g. rm/trash, ls/eza+lsd) -- matching the
existing CLASSIFICATION convention's placement and the ~20 functions
that already carried this label.

Also broadens verify-manual.py's dependency-resolution check to
recognize this repo's other existence-check idioms (command -q,
command -v, which -- not just type -q) and dng2avif's dynamic
type -q $cmd loop, since several genuine dependencies (eza, lsd,
fastfetch, fd, ps, ...) are only ever guarded that way.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01HdzcdfzUSzskSsCS1U4j5X
2026-09-22 22:21:02 -04:00

44 lines
989 B
Fish

# Copyright (C) 2026 Rootiest
# SPDX-License-Identifier: AGPL-3.0-or-later
# CATEGORY
# 07-system-and-monitoring
#
# COMPONENT
# aliases/monitor
#
# DEPENDENCIES
# btop
#
# CLASSIFICATION
# bypasses-shadow(top)
#
# SYNOPSIS
# top [args...]
#
# DESCRIPTION
# Wraps btop as a modern replacement for top. Falls back to system top
# if btop is not installed.
#
# ARGUMENTS
# args... Arguments forwarded to btop or system top
#
# EXAMPLE
# top
function top --wraps='btop' --description 'Use btop as a modern replacement for top'
# Opinionated guard (C1): fall back to bare command top when disabled.
if not __fish_config_op_enabled (status current-function)
command top $argv
return $status
end
# 1. Check if btop is actually installed
if type -q btop
# 2. Launch btop with any arguments passed
btop $argv
else
# 3. Fallback to the original system top if btop is missing
command top $argv
end
end