Files
fish-config/functions/cat.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

62 lines
1.8 KiB
Fish

# Copyright (C) 2026 Rootiest
# SPDX-License-Identifier: AGPL-3.0-or-later
# CATEGORY
# 01-file-and-directory
#
# COMPONENT
# aliases/filesystem
#
# CLASSIFICATION
# uses-shadow(ls), bypasses-shadow(cat)
#
# SYNOPSIS
# cat [args...]
#
# DESCRIPTION
# Enhanced cat replacement. Wraps bat for files, giving syntax highlighting
# and line numbers; passes directories to ls; falls back to raw cat for
# ANSI-colored log files, and finally to /usr/bin/cat if bat is not
# installed.
#
# ARGUMENTS
# args... Files or directories to display
#
# EXAMPLE
# cat README.md
# cat ~/projects/myapp
function cat --wraps='bat' --description 'Use bat for files, ls for directories, and raw cat for ANSI logs'
# Opinionated guard (C1): fall back to bare command cat when disabled.
if not __fish_config_op_enabled (status current-function)
command cat $argv
return $status
end
# If no arguments are provided, cat usually waits for stdin.
# We'll maintain that behavior by skipping the directory check if $argv is empty.
if set -q argv[1]
if test -d $argv[1]
# If it's a directory, run your custom ls function
ls $argv
return
end
# NEW: Check if the target file lives in your scrollback snapshot directory OR
# contains raw terminal ANSI color escape sequences.
if test -f $argv[1]
if string match -q "$SCROLLBACK_HISTORY_DIR/*" $argv[1]
or string match -qr -- '\e\[[0-9;]*m' (head -n 5 $argv[1] 2>/dev/null)
command cat $argv
return
end
end
end
# Fallback to bat or standard cat
if type -q bat
bat --plain --no-pager $argv
else
command cat $argv
end
end