Files
fish-config/functions/du.fish
T
rootiest 859f14a6e9 feat(functions): tag CLASSIFICATION across functions/ and conf.d/
Audits every function's interaction with the C1-shadowed commands
(uses-shadow/bypasses-shadow) and general hazards (destructive,
network, blocking-prompt) per the CLASSIFICATION schema.

Delegated the initial mechanical sweep to agy, then reviewed every
file by hand: fixed a systemic double-blank-comment-line formatting
bug from the delegate pass, and corrected several judgment errors
found on review -- three false blocking-prompt tags where a fish
'read' was consuming piped input rather than waiting on a terminal
(open-url.fish, sbver.fish, play-media.fish, now untagged entirely),
a blocking-prompt tag on mkrep.fish despite its documented --yes
escape hatch, an untagged read in jobrunner.fish's own baseless
blocking-prompt claim (removed, along with a destructive tag on
cleanup of its own mktemp output -- the schema explicitly excludes
that), the same own-output-cleanup false positive on
_zellij_dump_log.fish's destructive tag, an interactive fzf-gated
confirmation on logs.fish and replay.fish's piped read misread the
same way as the first three, and a uses-shadow(mkdir) on mkcd.fish
that actually belongs to the _fish_mkdir_p helper it delegates to,
not to mkcd itself.
2026-09-21 21:26:44 -04:00

96 lines
2.4 KiB
Fish

# Copyright (C) 2026 Rootiest
# SPDX-License-Identifier: AGPL-3.0-or-later
# CATEGORY
# 01-file-and-directory
#
# COMPONENT
# aliases/filesystem
#
# CLASSIFICATION
# bypasses-shadow(du)
#
# SYNOPSIS
# du [--disk|--dir|--dua] [args...]
#
# DESCRIPTION
# Smart disk-usage dispatcher. Without flags, routes to the most appropriate
# tool by context; explicit flags force one. Falls back to system du when the
# preferred tool is not installed.
#
# ARGUMENTS
# --disk Force duf (disk-level free/used overview)
# --dir Force dust (per-directory tree breakdown)
# --dua Force dua (fast interactive space analyzer)
# args... Files/directories or flags forwarded to the selected tool
#
# EXAMPLE
# du ~/Downloads
# du --disk
function du --description 'Execute du'
# Opinionated guard (C1): fall back to bare command du when disabled.
if not __fish_config_op_enabled (status current-function)
command du $argv
return $status
end
set cmd ""
set args
# Parse override flags and gather remaining args
for arg in $argv
switch $arg
case --disk
set cmd duf
case --dir
set cmd dust
case --dua
set cmd dua
case '*'
set args $args $arg
end
end
# Autodetect if no override flag given
if test -z "$cmd"
if count $args
set first_arg $args[1]
if test -d "$first_arg" -o -f "$first_arg"
set cmd dust
else
set cmd duf
end
else
set cmd duf
end
end
# Tool execution with graceful fallback
switch $cmd
case duf
if type -q duf
duf $args
else
echo "(duf not found — falling back to du)"
command du -sh $args
end
case dust
if type -q dust
dust $args
else
echo "(dust not found — falling back to du)"
command du -sh $args
end
case dua
if type -q dua
dua $args
else
echo "(dua not found — falling back to du)"
command du -sh $args
end
case '*'
# This shouldn't happen, but just in case
command du -sh $args
end
end