mirror of
https://github.com/fish-shell/fish-shell
synced 2024-12-29 14:23:09 +00:00
340de73172
Previously, when a command wasn't found, fish would emit the
"fish_command_not_found" *event*.
This was annoying as it was hard to override (the code ended up
checking for a function called `__fish_command_not_found_handler`
anyway!), the setup was ugly,
and it's useless - there is no use case for multiple command-not-found handlers.
Instead, let's just call a function `fish_command_not_found` if it
exists, or print the default message otherwise.
The event is completely removed, but because a missing event is not an error
(MEISNAE in C++-speak) this isn't an issue.
Note that, for backwards-compatibility, we still keep the default
handler function around even tho the new one is hard-coded in C++.
Also, if we detect a previous handler, the new handler just calls it.
This way, the backwards-compatible way to install a custom handler is:
```fish
function __fish_command_not_found_handler --on-event fish_command_not_found
# do a little dance, make a little love, get down tonight
end
```
and the new hotness is
```fish
function fish_command_not_found
# do the thing
end
```
Fixes #7293.
251 lines
8.6 KiB
Fish
251 lines
8.6 KiB
Fish
# Main file for fish command completions. This file contains various
|
|
# common helper functions for the command completions. All actual
|
|
# completions are located in the completions subdirectory.
|
|
#
|
|
# Set default field separators
|
|
#
|
|
set -g IFS \n\ \t
|
|
set -qg __fish_added_user_paths
|
|
or set -g __fish_added_user_paths
|
|
|
|
# For one-off upgrades of the fish version, see __fish_config_interactive.fish
|
|
if not set -q __fish_initialized
|
|
set -U __fish_initialized 0
|
|
if set -q __fish_init_2_39_8
|
|
set __fish_initialized 2398
|
|
else if set -q __fish_init_2_3_0
|
|
set __fish_initialized 2300
|
|
end
|
|
end
|
|
|
|
#
|
|
# Create the default command_not_found handler
|
|
#
|
|
function __fish_default_command_not_found_handler
|
|
printf "fish: Unknown command: %s\n" (string escape -- $argv[1]) >&2
|
|
end
|
|
|
|
if not status --is-interactive
|
|
# Hook up the default as the command_not_found handler
|
|
# if we are not interactive to avoid custom handlers.
|
|
function fish_command_not_found --on-event fish_command_not_found
|
|
__fish_default_command_not_found_handler $argv
|
|
end
|
|
end
|
|
|
|
#
|
|
# Set default search paths for completions and shellscript functions
|
|
# unless they already exist
|
|
#
|
|
|
|
# __fish_data_dir, __fish_sysconf_dir, __fish_help_dir, __fish_bin_dir
|
|
# are expected to have been set up by read_init from fish.cpp
|
|
|
|
# Grab extra directories (as specified by the build process, usually for
|
|
# third-party packages to ship completions &c.
|
|
set -l __extra_completionsdir
|
|
set -l __extra_functionsdir
|
|
set -l __extra_confdir
|
|
if test -f $__fish_data_dir/__fish_build_paths.fish
|
|
source $__fish_data_dir/__fish_build_paths.fish
|
|
end
|
|
|
|
# Compute the directories for vendor configuration. We want to include
|
|
# all of XDG_DATA_DIRS, as well as the __extra_* dirs defined above.
|
|
set -l xdg_data_dirs
|
|
if set -q XDG_DATA_DIRS
|
|
set --path xdg_data_dirs $XDG_DATA_DIRS
|
|
set xdg_data_dirs (string replace -r '([^/])/$' '$1' -- $xdg_data_dirs)/fish
|
|
else
|
|
set xdg_data_dirs $__fish_data_dir
|
|
end
|
|
|
|
set -l vendor_completionsdirs
|
|
set -l vendor_functionsdirs
|
|
set -l vendor_confdirs
|
|
# Don't load vendor directories when running unit tests
|
|
if not set -q FISH_UNIT_TESTS_RUNNING
|
|
set vendor_completionsdirs $xdg_data_dirs/vendor_completions.d
|
|
set vendor_functionsdirs $xdg_data_dirs/vendor_functions.d
|
|
set vendor_confdirs $xdg_data_dirs/vendor_conf.d
|
|
|
|
# Ensure that extra directories are always included.
|
|
if not contains -- $__extra_completionsdir $vendor_completionsdirs
|
|
set -a vendor_completionsdirs $__extra_completionsdir
|
|
end
|
|
if not contains -- $__extra_functionsdir $vendor_functionsdirs
|
|
set -a vendor_functionsdirs $__extra_functionsdir
|
|
end
|
|
if not contains -- $__extra_confdir $vendor_confdirs
|
|
set -a vendor_confdirs $__extra_confdir
|
|
end
|
|
end
|
|
|
|
# Set up function and completion paths. Make sure that the fish
|
|
# default functions/completions are included in the respective path.
|
|
|
|
if not set -q fish_function_path
|
|
set fish_function_path $__fish_config_dir/functions $__fish_sysconf_dir/functions $vendor_functionsdirs $__fish_data_dir/functions
|
|
else if not contains -- $__fish_data_dir/functions $fish_function_path
|
|
set -a fish_function_path $__fish_data_dir/functions
|
|
end
|
|
|
|
if not set -q fish_complete_path
|
|
set fish_complete_path $__fish_config_dir/completions $__fish_sysconf_dir/completions $vendor_completionsdirs $__fish_data_dir/completions $__fish_user_data_dir/generated_completions
|
|
else if not contains -- $__fish_data_dir/completions $fish_complete_path
|
|
set -a fish_complete_path $__fish_data_dir/completions
|
|
end
|
|
|
|
# Add a handler for when fish_user_path changes, so we can apply the same changes to PATH
|
|
function __fish_reconstruct_path -d "Update PATH when fish_user_paths changes" --on-variable fish_user_paths
|
|
set -l local_path $PATH
|
|
|
|
for x in $__fish_added_user_paths
|
|
set -l idx (contains --index -- $x $local_path)
|
|
and set -e local_path[$idx]
|
|
end
|
|
|
|
set -g __fish_added_user_paths
|
|
if set -q fish_user_paths
|
|
# Explicitly split on ":" because $fish_user_paths might not be a path variable,
|
|
# but $PATH definitely is.
|
|
for x in (string split ":" -- $fish_user_paths[-1..1])
|
|
if set -l idx (contains --index -- $x $local_path)
|
|
set -e local_path[$idx]
|
|
else
|
|
set -ga __fish_added_user_paths $x
|
|
end
|
|
set -p local_path $x
|
|
end
|
|
end
|
|
|
|
set -xg PATH $local_path
|
|
end
|
|
|
|
#
|
|
# Launch debugger on SIGTRAP
|
|
#
|
|
function fish_sigtrap_handler --on-signal TRAP --no-scope-shadowing --description "Signal handler for the TRAP signal. Launches a debug prompt."
|
|
breakpoint
|
|
end
|
|
|
|
#
|
|
# When a prompt is first displayed, make sure that interactive
|
|
# mode-specific initializations have been performed.
|
|
# This handler removes itself after it is first called.
|
|
#
|
|
function __fish_on_interactive --on-event fish_prompt
|
|
__fish_config_interactive
|
|
functions -e __fish_on_interactive
|
|
end
|
|
|
|
# Set the locale if it isn't explicitly set. Allowing the lack of locale env vars to imply the
|
|
# C/POSIX locale causes too many problems. Do this before reading the snippets because they might be
|
|
# in UTF-8 (with non-ASCII characters).
|
|
__fish_set_locale
|
|
|
|
# Upgrade pre-existing abbreviations from the old "key=value" to the new "key value" syntax.
|
|
# This needs to be in share/config.fish because __fish_config_interactive is called after sourcing
|
|
# config.fish, which might contain abbr calls.
|
|
if test $__fish_initialized -lt 2300
|
|
if set -q fish_user_abbreviations
|
|
set -l fab
|
|
for abbr in $fish_user_abbreviations
|
|
set -a fab (string replace -r '^([^ =]+)=(.*)$' '$1 $2' -- $abbr)
|
|
end
|
|
set fish_user_abbreviations $fab
|
|
end
|
|
end
|
|
|
|
#
|
|
# Some things should only be done for login terminals
|
|
# This used to be in etc/config.fish - keep it here to keep the semantics
|
|
#
|
|
if status --is-login
|
|
if command -sq /usr/libexec/path_helper
|
|
# Adapt construct_path from the macOS /usr/libexec/path_helper
|
|
# executable for fish; see
|
|
# https://opensource.apple.com/source/shell_cmds/shell_cmds-203/path_helper/path_helper.c.auto.html .
|
|
function __fish_macos_set_env -d "set an environment variable like path_helper does (macOS only)"
|
|
set -l result
|
|
|
|
# Populate path according to config files
|
|
for path_file in $argv[2] $argv[3]/*
|
|
if [ -f $path_file ]
|
|
while read -l entry
|
|
if not contains -- $entry $result
|
|
test -n "$entry"
|
|
and set -a result $entry
|
|
end
|
|
end <$path_file
|
|
end
|
|
end
|
|
|
|
# Merge in any existing path elements
|
|
for existing_entry in $$argv[1]
|
|
if not contains -- $existing_entry $result
|
|
set -a result $existing_entry
|
|
end
|
|
end
|
|
|
|
set -xg $argv[1] $result
|
|
end
|
|
|
|
__fish_macos_set_env PATH /etc/paths '/etc/paths.d'
|
|
if [ -n "$MANPATH" ]
|
|
__fish_macos_set_env MANPATH /etc/manpaths '/etc/manpaths.d'
|
|
end
|
|
functions -e __fish_macos_set_env
|
|
end
|
|
|
|
#
|
|
# Put linux consoles in unicode mode.
|
|
#
|
|
if test "$TERM" = linux
|
|
and string match -qir '\.UTF' -- $LANG
|
|
and command -sq unicode_start
|
|
unicode_start
|
|
end
|
|
end
|
|
|
|
# Invoke this here to apply the current value of fish_user_path after
|
|
# PATH is possibly set above.
|
|
__fish_reconstruct_path
|
|
|
|
# Allow %n job expansion to be used with fg/bg/wait
|
|
# `jobs` is the only one that natively supports job expansion
|
|
function __fish_expand_pid_args
|
|
for arg in $argv
|
|
if string match -qr '^%\d+$' -- $arg
|
|
if not jobs -p $arg
|
|
return 1
|
|
end
|
|
else
|
|
printf "%s\n" $arg
|
|
end
|
|
end
|
|
end
|
|
|
|
for jobbltn in bg fg wait disown
|
|
function $jobbltn -V jobbltn
|
|
builtin $jobbltn (__fish_expand_pid_args $argv)
|
|
end
|
|
end
|
|
|
|
function kill
|
|
command kill (__fish_expand_pid_args $argv)
|
|
end
|
|
|
|
# As last part of initialization, source the conf directories.
|
|
# Implement precedence (User > Admin > Extra (e.g. vendors) > Fish) by basically doing "basename".
|
|
set -l sourcelist
|
|
for file in $__fish_config_dir/conf.d/*.fish $__fish_sysconf_dir/conf.d/*.fish $vendor_confdirs/*.fish
|
|
set -l basename (string replace -r '^.*/' '' -- $file)
|
|
contains -- $basename $sourcelist
|
|
and continue
|
|
set sourcelist $sourcelist $basename
|
|
# Also skip non-files or unreadable files.
|
|
# This allows one to use e.g. symlinks to /dev/null to "mask" something (like in systemd).
|
|
[ -f $file -a -r $file ]
|
|
and source $file
|
|
end
|