rootiest
390072e919
Both the auto-pull function and the PWD event handler hardcoded $XDG_CONFIG_HOME/.user-dots/fish as the registry directory. They now resolve $__fish_user_dots_path first, falling back to the same default, so a custom path set via config-settings is honoured.
152 lines
6.2 KiB
Fish
152 lines
6.2 KiB
Fish
# Copyright (C) 2026 Rootiest
|
|
# SPDX-License-Identifier: AGPL-3.0-or-later
|
|
|
|
# SYNOPSIS
|
|
# auto-pull [list]
|
|
# auto-pull add [PATH]
|
|
# auto-pull remove <NAME|PATH>
|
|
# auto-pull status
|
|
#
|
|
# DESCRIPTION
|
|
# Manages the auto-pull registry: the list of repositories that are
|
|
# background fast-forwarded when you enter them (see conf.d/auto-pull.fish
|
|
# and _auto_pull_sync). The fish-config repo is always covered as a baseline
|
|
# and does not need to be added. The registry is a plain text file, one
|
|
# absolute git-toplevel path per line, stored machine-locally in
|
|
# ~/.config/.user-dots/fish/auto-pull.list (never committed to the config).
|
|
#
|
|
# Registry management works regardless of the C2 auto-execution guard; only
|
|
# the background sync itself is gated by __fish_config_op_autoexec.
|
|
#
|
|
# ARGUMENTS
|
|
# list Show registered repos (default when no subcommand given)
|
|
# add [PATH] Register PATH's git root; defaults to the current repo
|
|
# remove <NAME|PATH> Unregister by basename or exact path
|
|
# status Show whether auto-pull is enabled and the registry path
|
|
# -h, --help Show this help message
|
|
#
|
|
# RETURNS
|
|
# 0 Subcommand succeeded
|
|
# 1 Bad usage, target is not a git repo, or target not registered
|
|
#
|
|
# EXAMPLE
|
|
# cd ~/src/qmk_firmware; and auto-pull add
|
|
# auto-pull add ~/work/api
|
|
# auto-pull list
|
|
# auto-pull remove qmk_firmware
|
|
function auto-pull --description 'Manage the auto-pull repository registry'
|
|
set -l c_head (set_color --bold cyan)
|
|
set -l c_cmd (set_color --bold white)
|
|
set -l c_flag (set_color yellow)
|
|
set -l c_ok (set_color green)
|
|
set -l c_warn (set_color yellow)
|
|
set -l c_err (set_color red)
|
|
set -l c_dim (set_color brblack)
|
|
set -l c_reset (set_color normal)
|
|
|
|
set -q __fish_config_dir; or set -l __fish_config_dir $XDG_CONFIG_HOME/fish
|
|
set -q __fish_user_dots_path; or set -l __fish_user_dots_path "$XDG_CONFIG_HOME/.user-dots/fish"
|
|
set -l list "$__fish_user_dots_path/auto-pull.list"
|
|
|
|
set -l cmd $argv[1]
|
|
set -e argv[1]
|
|
|
|
if test "$cmd" = -h; or test "$cmd" = --help; or contains -- -h $argv; or contains -- --help $argv
|
|
echo "$c_head""Usage:$c_reset $c_cmd""auto-pull$c_reset $c_flag""[list | add | remove | status]$c_reset $c_dim""[PATH|NAME]$c_reset"
|
|
echo
|
|
echo " Manage the registry of repos that are background fast-forwarded on entry."
|
|
echo
|
|
echo "$c_head""Subcommands:$c_reset"
|
|
echo " $c_flag""list$c_reset Show registered repos (default)"
|
|
echo " $c_flag""add$c_reset $c_dim""[PATH]$c_reset Register PATH's git root (default: current repo)"
|
|
echo " $c_flag""remove$c_reset $c_dim""<NAME|PATH>$c_reset Unregister by basename or exact path"
|
|
echo " $c_flag""status$c_reset Show enabled/disabled state and registry path"
|
|
echo " $c_flag-h$c_reset, $c_flag--help$c_reset Show this help message"
|
|
return 0
|
|
end
|
|
|
|
switch "$cmd"
|
|
case '' list
|
|
echo "$c_head""Auto-pull registry:$c_reset"
|
|
echo " $c_dim$__fish_config_dir$c_reset $c_dim(fish-config, baseline)$c_reset"
|
|
if test -r "$list"
|
|
for l in (command cat "$list" 2>/dev/null)
|
|
test -n "$l"; or continue
|
|
echo " $l $c_dim("(path basename "$l")")$c_reset"
|
|
end
|
|
end
|
|
return 0
|
|
|
|
case add
|
|
set -l target $argv[1]
|
|
test -n "$target"; or set target $PWD
|
|
set -l root (command git -C "$target" rev-parse --show-toplevel 2>/dev/null)
|
|
if test -z "$root"
|
|
echo "$c_err""auto-pull: not a git repository: $target$c_reset" >&2
|
|
return 1
|
|
end
|
|
if test "$root" = "$__fish_config_dir"
|
|
echo "$c_warn""auto-pull: fish-config is always covered (baseline); nothing to add$c_reset"
|
|
return 0
|
|
end
|
|
command mkdir -p (path dirname "$list")
|
|
test -f "$list"; or command touch "$list"
|
|
if contains -- "$root" (command cat "$list" 2>/dev/null)
|
|
echo "$c_dim""auto-pull: already registered: $root$c_reset"
|
|
return 0
|
|
end
|
|
echo "$root" >>"$list"
|
|
echo "$c_ok""→ auto-pull added: $root$c_reset"
|
|
return 0
|
|
|
|
case remove rm
|
|
set -l target $argv[1]
|
|
if test -z "$target"
|
|
echo "$c_err""auto-pull: usage: auto-pull remove <NAME|PATH>$c_reset" >&2
|
|
return 1
|
|
end
|
|
if not test -r "$list"
|
|
echo "$c_dim""auto-pull: registry is empty$c_reset"
|
|
return 1
|
|
end
|
|
set -l kept
|
|
set -l removed
|
|
for l in (command cat "$list" 2>/dev/null)
|
|
test -n "$l"; or continue
|
|
if test "$l" = "$target"; or test (path basename "$l") = "$target"
|
|
set -a removed "$l"
|
|
else
|
|
set -a kept "$l"
|
|
end
|
|
end
|
|
if test -z "$removed"
|
|
echo "$c_err""auto-pull: not registered: $target$c_reset" >&2
|
|
return 1
|
|
end
|
|
if test -n "$kept"
|
|
printf '%s\n' $kept >"$list"
|
|
else
|
|
printf '' >"$list"
|
|
end
|
|
echo "$c_warn""→ auto-pull removed: $removed$c_reset"
|
|
return 0
|
|
|
|
case status
|
|
if __fish_config_op_enabled __fish_config_op_autoexec
|
|
echo "$c_ok""auto-pull: ENABLED$c_reset $c_dim(C2 auto-execution on)$c_reset"
|
|
else
|
|
echo "$c_warn""auto-pull: DISABLED$c_reset $c_dim(via __fish_config_op_autoexec)$c_reset"
|
|
end
|
|
set -l repos
|
|
test -r "$list"; and set repos (command cat "$list" 2>/dev/null | string match -rv '^\s*$')
|
|
echo " registered repos: "(count $repos)" $c_dim(+ fish-config baseline)$c_reset"
|
|
echo " list file: $c_dim$list$c_reset"
|
|
return 0
|
|
|
|
case '*'
|
|
echo "$c_err""auto-pull: unknown subcommand: $cmd$c_reset" >&2
|
|
echo "$c_dim""try: auto-pull --help$c_reset" >&2
|
|
return 1
|
|
end
|
|
end
|