os-mnemo/System-Sync-Restore
Public Access
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Add shell auto-completion for zsh, bash, and fish

Browse Source 
- completions/_ssr            zsh #compdef completion using _arguments/_values
- completions/ssr.bash        bash complete -F function (works with bash-completion@2)
- completions/ssr.fish        fish completions with __ssr_needs_subcmd predicates
- bin/ssr-completions         install/uninstall/status subcommand
                              - auto-detects $SHELL, --shell zsh|bash|fish|all
                              - symlinks into user-scoped paths (no sudo):
                                ~/.zsh/completions/_ssr
                                ~/.local/share/bash-completion/completions/ssr
                                ~/.config/fish/completions/ssr.fish
                              - prints fpath/bash-completion setup hints if not configured
- bin/ssr                     dispatcher knows `completions`; help line added
- bin/ssr-install             offers completion install after schedule prompt
- README                      Shell completions section, command list, layout entry

Verified:
- zsh -n  on _ssr        OK; autoload registers function
- bash -n on ssr.bash    OK; `complete -p ssr` returns the registration after source
- end-to-end install/status/uninstall against an ephemeral $HOME

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
Oliver Surke
2026-05-11 16:16:22 +02:00
parent 69541209dc
commit c1848f66e8
7 changed files with 383 additions and 1 deletions
Download Patch File Download Diff File Expand all files Collapse all files
completions/ssr.fish
+71
View File
@@ -0,0 +1,71 @@
# fish completion for ssr — System Sync & Restore.
# Install: drop into ~/.config/fish/completions/ssr.fish
set -l ssr_cmds install sync restore update schedule config completions status version help
# True when no subcommand has been picked yet (only flags / option-args seen so far).
function __ssr_needs_subcmd
set -l tokens (commandline -opc)
set -l skip_next 0
for tok in $tokens[2..-1]
if test $skip_next -eq 1
set skip_next 0
continue
end
switch $tok
case -c --config
set skip_next 1
case '-*'
# ignore other flags
case '*'
return 1
end
end
return 0
end
# True when the chosen subcommand equals $argv[1].
function __ssr_using_subcmd
set -l target $argv[1]
set -l tokens (commandline -opc)
set -l skip_next 0
for tok in $tokens[2..-1]
if test $skip_next -eq 1
set skip_next 0
continue
end
switch $tok
case -c --config
set skip_next 1
case '-*'
case '*'
test "$tok" = "$target"; and return 0
return 1
end
end
return 1
end
# Global flags
complete -c ssr -s c -l config -d 'Config file path' -r -F
complete -c ssr -s h -l help -d 'Show help'
# Subcommands
complete -c ssr -n __ssr_needs_subcmd -a install -d 'First-time install'
complete -c ssr -n __ssr_needs_subcmd -a sync -d 'Run a backup → cloud'
complete -c ssr -n __ssr_needs_subcmd -a restore -d 'Restore a machine'
complete -c ssr -n __ssr_needs_subcmd -a update -d 'Pull latest ssr code'
complete -c ssr -n __ssr_needs_subcmd -a schedule -d 'Manage launchd schedule'
complete -c ssr -n __ssr_needs_subcmd -a config -d 'Show/edit config'
complete -c ssr -n __ssr_needs_subcmd -a completions -d 'Install shell completions'
complete -c ssr -n __ssr_needs_subcmd -a status -d 'Show state summary'
complete -c ssr -n __ssr_needs_subcmd -a version -d 'Print version'
complete -c ssr -n __ssr_needs_subcmd -a help -d 'Show top-level help'
# Per-subcommand args
complete -c ssr -n '__ssr_using_subcmd restore' -F
complete -c ssr -n '__ssr_using_subcmd update' -s n -l dry-run -d 'Preview without pulling'
complete -c ssr -n '__ssr_using_subcmd schedule' -a 'on off status'
complete -c ssr -n '__ssr_using_subcmd config' -a 'show edit path'
complete -c ssr -n '__ssr_using_subcmd completions' -a 'install uninstall status'