From c290e4f33074d853790a12fd64b94a9478be1df4 Mon Sep 17 00:00:00 2001 From: Gil Portenseigne Date: Fri, 12 Dec 2025 11:11:26 +0100 Subject: [PATCH] suppression completion non voulue --- .config/bash/complete_alias.sh | 1065 -------------------------------- 1 file changed, 1065 deletions(-) delete mode 100644 .config/bash/complete_alias.sh diff --git a/.config/bash/complete_alias.sh b/.config/bash/complete_alias.sh deleted file mode 100644 index 7b71da1..0000000 --- a/.config/bash/complete_alias.sh +++ /dev/null @@ -1,1065 +0,0 @@ -#!/bin/bash - -### https://github.com/cykerway/complete-alias/blob/master/complete_alias - -## :::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: -## automagical shell alias completion; -## :::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: - -## ============================================================================ -## Copyright (C) 2016-2021 Cyker Way -## -## This program is free software: you can redistribute it and/or modify it -## under the terms of the GNU General Public License as published by the Free -## Software Foundation, either version 3 of the License, or (at your option) -## any later version. -## -## This program is distributed in the hope that it will be useful, but WITHOUT -## ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or -## FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for -## more details. -## -## You should have received a copy of the GNU General Public License along with -## this program. If not, see . -## ============================================================================ - -## ============================================================================ -## # environment variables -## -## these are envars read by this script; users are advised to set these envars -## before sourcing this script to customize its behavior, even though some may -## still work if set after sourcing this script; these envar names must follow -## this naming convention: all letters uppercase, no leading underscore, words -## separated by one underscore; -## ============================================================================ - -## bool: true iff auto unmask alias commands; set it to false if auto unmask -## feels too slow, or custom unmask is necessary to make an unusual behavior; -COMPAL_AUTO_UNMASK="${COMPAL_AUTO_UNMASK:-0}" - -## ============================================================================ -## # variables -## ============================================================================ - -## register for keeping function return value; -__compal__retval= - -## refcnt for alias expansion; expand aliases iff `_refcnt == 0`; -__compal__refcnt=0 - -## an associative array of vanilla completions, keyed by command names; -## -## when we say this array stores "parsed" cspecs, we actually mean the cspecs -## have been parsed and indexed by command names in this array; cspec strings -## themselves have no difference between this array and `_raw_vanilla_cspecs`; -## -## example: -## -## _vanilla_cspecs["tee"]="complete -F _longopt tee" -## _vanilla_cspecs["type"]="complete -c type" -## _vanilla_cspecs["unalias"]="complete -a unalias" -## ... -## -declare -A __compal__vanilla_cspecs - -## a set of raw vanilla completions, keyed by cspec; these raw cspecs will be -## parsed and loaded into `_vanilla_cspecs` on use; we need this lazy loading -## because parsing all cspecs on sourcing incurs a large performance overhead; -## -## vanilla completions are alias-free and fetched before `_complete_alias` is -## set as the completion function for alias commands; the way we enforce this -## partial order is to init this array on source; the sourcing happens before -## `complete -F _complete_alias ...` for obvious reasons; -## -## this is made a set, not an array, to avoid duplication when this script is -## sourced repeatedly; each sourcing overwrites previous ones on duplication; -## -## example: -## -## _raw_vanilla_cspecs["complete -F _longopt tee"]="" -## _raw_vanilla_cspecs["complete -c type"]="" -## _raw_vanilla_cspecs["complete -a unalias"]="" -## ... -## -declare -A __compal__raw_vanilla_cspecs - -## ============================================================================ -## # functions -## ============================================================================ - -## debug bash programmable completion variables; -__compal__debug() { - echo - echo "#COMP_WORDS=${#COMP_WORDS[@]}" - echo "COMP_WORDS=(" - for x in "${COMP_WORDS[@]}"; do - echo "'$x'" - done - echo ")" - echo "COMP_CWORD=${COMP_CWORD}" - echo "COMP_LINE='${COMP_LINE}'" - echo "COMP_POINT=${COMP_POINT}" - echo -} - -## debug vanilla cspecs; -## -## $1 -## : if "key" dump keys, else dump values; -__compal__debug_vanilla_cspecs() { - if [[ "$1" == "key" ]]; then - for x in "${!__compal__vanilla_cspecs[@]}"; do - echo "$x" - done - else - for x in "${__compal__vanilla_cspecs[@]}"; do - echo "$x" - done - fi -} - -## debug raw vanilla cspecs; -__compal__debug_raw_vanilla_cspecs() { - for x in "${!__compal__raw_vanilla_cspecs[@]}"; do - echo "$x" - done -} - -## debug `_split_cmd_line`; -## -## this function is very easy to use; just call it with a string argument in an -## interactive shell and look at the result; some interesting string arguments: -## -## - (fail) `&> /dev/null ping` -## - (fail) `2> /dev/null ping` -## - (fail) `2>&1 > /dev/null ping` -## - (fail) `> /dev/null ping` -## - (work) `&>/dev/null ping` -## - (work) `2>&1 >/dev/null ping` -## - (work) `2>&1 ping` -## - (work) `2>/dev/null ping` -## - (work) `>/dev/null ping` -## - (work) `FOO=foo true && BAR=bar ping` -## - (work) `echo & echo & ping` -## - (work) `echo ; echo ; ping` -## - (work) `echo | echo | ping` -## - (work) `ping &> /dev/null` -## - (work) `ping &>/dev/null` -## - (work) `ping 2> /dev/null` -## - (work) `ping 2>&1 > /dev/null` -## - (work) `ping 2>&1 >/dev/null` -## - (work) `ping 2>&1` -## - (work) `ping 2>/dev/null` -## - (work) `ping > /dev/null` -## - (work) `ping >/dev/null` -## -## these failed examples are not an emergency because you can easily find their -## equivalents in those working ones; and we will check for emergency on failed -## examples added in the future; -## -## $1 -## : command line string; -__compal__debug_split_cmd_line() { - ## command line string; - local str="$1" - - __compal__split_cmd_line "$str" - - for x in "${__compal__retval[@]}"; do - echo "'$x'" - done -} - -## print an error message; -## -## $1 -## : error message; -__compal__error() { - printf "error: %s\n" "$1" >&2 -} - -## test whether an element is in array; -## -## $@ -## : ( elem arr[0] arr[1] ... ) -__compal__inarr() { - for e in "${@:2}"; do - [[ "$e" == "$1" ]] && return 0 - done - return 1 -} - -## get alias body from alias name; -## -## this is made a separate function so that users can override this function to -## provide alternate alias body for specific aliases; such aliases would run as -## one thing but complete as another; this could be weird and confusing so this -## is not formally documented; -## -## $1 -## : alias name; -## $? -## : alias body; -__compal__get_alias_body() { - local cmd; cmd="$1" - - local body; body="$(alias "$cmd")" - echo "${body#*=}" | command xargs -} - -## split command line into words; -## -## the `bash` reference implementation shows how bash splits command line into -## word list `COMP_WORDS`: -## -## - git repo ; -## - commit `ce23728687ce9e584333367075c9deef413553fa`; -## - function `bashline.c:attempt_shell_completion`; -## - function `bashline.c:find_cmd_end`; -## - function `bashline.c:find_cmd_start`; -## - function `pcomplete.c:command_line_to_word_list`; -## - function `pcomplete.c:programmable_completions`; -## - function `subst.c:skip_to_delim`; -## - function `subst.c:split_at_delims`; -## -## this function shall give similar result as `bash` reference implementation -## for common use cases, but will not strive for full compatibility, which is -## too complicated when written in bash; we will support additional use cases -## as they show up and prove worthy; -## -## another reason we not pursue full compatibility is, even bash itself fails -## on some use cases, such as `ping 2>&1` and `ping &>/dev/null`; ironically, -## if we define an alias and complete using `_complete_alias`, then it works: -## -## $ alias ping='ping 2>&1' -## $ complete -F _complete_alias ping -## $ ping -## {ip} -## {ip} -## {ip} -## -## backslash: a non-quoted backslash (`\`) preserves the literal value of the -## next character that follows with the exception of ``; a backslash -## enclosed in single quotes loses such special meaning; a backslash enclosed -## in double quotes retains such special meaning only when followed by one of -## the following (5) characters: -## -## $ ` " \ -## -## we do not allow `` in alias body; this simplifies our argument: a -## non-quoted backslash always preserves next character; a backslash enclosed -## in double quotes only preserves the above 4 characters (minus ``); -## -## when a command substitution is enclosed in double quotes, backslash within -## the command substitution may retain such special meaning, despite whatever -## bash manual says; compare: -## -## "`\"`" -## "$(\")" -## -## in the first form the backslash is not literal even though not followed by -## characters mentioned in section command substitution, bash manual; we will -## not handle backquote correctly in this case; as an advice, avoid backquote; -## -## warn: the output of this function is *not* a faithful split of the input; -## this function drops redirections and assignments, and only keeps the last -## command in the last pipeline; -## -## warn: this function is made for alias body expansion; as such it does not -## support commmand substitutions, etc.; if you run its output as argv, then -## you run at your own risk; quotes and escapes may also disturb the result; -## -## $1 -## : command line string; -__compal__split_cmd_line() { - ## command line string; - local str="$1" - - ## an array that will contain words after split; - local words=() - - ## alloc a temp stack to track open and close chars when splitting; - local sta=() - - ## we adopt some bool flags to handle redirections and assignments at the - ## beginning of the command line, if any; we can simply drop redirections - ## and assignments for sake of alias completion; for detail, read `SIMPLE - ## COMMAND EXPANSION` in `man bash`; - - ## bool: check (outmost) redirection or assignment; - local check_redass=1 - - ## bool: found (outmost) redirection or assignment in current word; - local found_redass=0 - - ## examine each char of `str`; test branches are ordered; this order has - ## two importances: first is to respect substring relationship (eg: `&&` - ## must be tested before `&`); second is to test in optimistic order for - ## speeding up the testing; the first importance is compulsory and takes - ## precedence; - local i=0 j=0 - for (( ; j < ${#str}; j++ )); do - if (( ${#sta[@]} == 0 )); then - if [[ "${str:j:1}" =~ [_a-zA-Z0-9] ]]; then - : - elif [[ $' \t\n' == *"${str:j:1}"* ]]; then - if (( i < j )); then - if (( $found_redass == 1 )); then - if (( $check_redass == 0 )); then - words+=( "${str:i:j-i}" ) - fi - found_redass=0 - else - ## no redass in current word; stop checking; - check_redass=0 - words+=( "${str:i:j-i}" ) - fi - fi - (( i = j + 1 )) - elif [[ ":" == *"${str:j:1}"* ]]; then - if (( i < j )); then - if (( $found_redass == 1 )); then - if (( $check_redass == 0 )); then - words+=( "${str:i:j-i}" ) - fi - found_redass=0 - else - ## no redass in current word; stop checking; - check_redass=0 - words+=( "${str:i:j-i}" ) - fi - fi - words+=( "${str:j:1}" ) - (( i = j + 1 )) - elif [[ '$(' == "${str:j:2}" ]]; then - sta+=( ')' ) - (( j++ )) - elif [[ '`' == "${str:j:1}" ]]; then - sta+=( '`' ) - elif [[ '(' == "${str:j:1}" ]]; then - sta+=( ')' ) - elif [[ '{' == "${str:j:1}" ]]; then - sta+=( '}' ) - elif [[ '"' == "${str:j:1}" ]]; then - sta+=( '"' ) - elif [[ "'" == "${str:j:1}" ]]; then - sta+=( "'" ) - elif [[ '\' == "${str:j:1}" ]]; then - (( j++ )) - elif [[ '&>' == "${str:j:2}" ]]; then - found_redass=1 - (( j++ )) - elif [[ '>&' == "${str:j:2}" ]]; then - found_redass=1 - (( j++ )) - elif [[ "><=" == *"${str:j:1}"* ]]; then - found_redass=1 - elif [[ '&&' == "${str:j:2}" ]]; then - words=() - check_redass=1 - (( i = j + 2 )) - elif [[ '||' == "${str:j:2}" ]]; then - words=() - check_redass=1 - (( i = j + 2 )) - elif [[ '&' == "${str:j:1}" ]]; then - words=() - check_redass=1 - (( i = j + 1 )) - elif [[ '|' == "${str:j:1}" ]]; then - words=() - check_redass=1 - (( i = j + 1 )) - elif [[ ';' == "${str:j:1}" ]]; then - words=() - check_redass=1 - (( i = j + 1 )) - fi - elif [[ "${sta[-1]}" == ')' ]]; then - if [[ ')' == "${str:j:1}" ]]; then - unset sta[-1] - elif [[ '$(' == "${str:j:2}" ]]; then - sta+=( ')' ) - (( j++ )) - elif [[ '`' == "${str:j:1}" ]]; then - sta+=( '`' ) - elif [[ '(' == "${str:j:1}" ]]; then - sta+=( ')' ) - elif [[ '{' == "${str:j:1}" ]]; then - sta+=( '}' ) - elif [[ '"' == "${str:j:1}" ]]; then - sta+=( '"' ) - elif [[ "'" == "${str:j:1}" ]]; then - sta+=( "'" ) - elif [[ '\' == "${str:j:1}" ]]; then - (( j++ )) - fi - elif [[ "${sta[-1]}" == '}' ]]; then - if [[ '}' == "${str:j:1}" ]]; then - unset sta[-1] - elif [[ '$(' == "${str:j:2}" ]]; then - sta+=( ')' ) - (( j++ )) - elif [[ '`' == "${str:j:1}" ]]; then - sta+=( '`' ) - elif [[ '(' == "${str:j:1}" ]]; then - sta+=( ')' ) - elif [[ '{' == "${str:j:1}" ]]; then - sta+=( '}' ) - elif [[ '"' == "${str:j:1}" ]]; then - sta+=( '"' ) - elif [[ "'" == "${str:j:1}" ]]; then - sta+=( "'" ) - elif [[ '\' == "${str:j:1}" ]]; then - (( j++ )) - fi - elif [[ "${sta[-1]}" == '`' ]]; then - if [[ '`' == "${str:j:1}" ]]; then - unset sta[-1] - elif [[ '$(' == "${str:j:2}" ]]; then - sta+=( ')' ) - (( j++ )) - elif [[ '(' == "${str:j:1}" ]]; then - sta+=( ')' ) - elif [[ '{' == "${str:j:1}" ]]; then - sta+=( '}' ) - elif [[ '"' == "${str:j:1}" ]]; then - sta+=( '"' ) - elif [[ "'" == "${str:j:1}" ]]; then - sta+=( "'" ) - elif [[ '\' == "${str:j:1}" ]]; then - (( j++ )) - fi - elif [[ "${sta[-1]}" == "'" ]]; then - if [[ "'" == "${str:j:1}" ]]; then - unset sta[-1] - fi - elif [[ "${sta[-1]}" == '"' ]]; then - if [[ '"' == "${str:j:1}" ]]; then - unset sta[-1] - elif [[ '$(' == "${str:j:2}" ]]; then - sta+=( ')' ) - (( j++ )) - elif [[ '`' == "${str:j:1}" ]]; then - sta+=( '`' ) - elif [[ '\$' == "${str:j:2}" ]]; then - (( j++ )) - elif [[ '\`' == "${str:j:2}" ]]; then - (( j++ )) - elif [[ '\"' == "${str:j:2}" ]]; then - (( j++ )) - elif [[ '\\' == "${str:j:2}" ]]; then - (( j++ )) - fi - fi - done - - ## append the last word; - if (( i < j )); then - if (( $found_redass == 1 )); then - if (( $check_redass == 0 )); then - words+=( "${str:i:j-i}" ) - fi - found_redass=0 - else - ## no redass in current word; stop checking; - check_redass=0 - words+=( "${str:i:j-i}" ) - fi - fi - - ## unset the temp stack; - unset sta - - ## return value; - __compal__retval=( "${words[@]}" ) -} - -## expand aliases in command line; -## -## $1 -## : beg word index; -## $2 -## : end word index; -## $3 -## : ignored word index (can be null); -## $4 -## : number of used aliases; -## ${@:4} -## : used aliases; -## $? -## : difference of `${#COMP_WORDS}` before and after expansion; -__compal__expand_alias() { - local beg="$1" end="$2" ignore="$3" n_used="$4"; shift 4 - local used=( "${@:1:$n_used}" ); shift "$n_used" - - if (( $beg == $end )) ; then - ## case 1: range is empty; - __compal__retval=0 - elif [[ -n "$ignore" ]] && (( $beg == $ignore )); then - ## case 2: beg index is ignored; pass it; - __compal__expand_alias \ - "$(( $beg + 1 ))" \ - "$end" \ - "$ignore" \ - "${#used[@]}" \ - "${used[@]}" - elif ! alias "${COMP_WORDS[$beg]}" &>/dev/null; then - ## case 3: command is not an alias; - __compal__retval=0 - elif ( __compal__inarr "${COMP_WORDS[$beg]}" "${used[@]}" ); then - ## case 4: command is an used alias; - __compal__retval=0 - else - ## case 5: command is an unused alias; - - ## get alias name; - local cmd="${COMP_WORDS[$beg]}" - - ## get alias body; - local str0; str0="$(__compal__get_alias_body "$cmd")" - - ## split alias body into words; - __compal__split_cmd_line "$str0" - local words0=( "${__compal__retval[@]}" ) - - ## rebuild alias body; we need this because function `_split_cmd_line` - ## drops redirections and assignments, and only keeps the last command - ## in the last pipeline, in `words0`; therefore `str0` is not a simple - ## concat of `words0`; we rebuild this simple concat as `nstr0`; maybe - ## it is easier to view `str0` as raw and `nstr0` as genuine; - local nstr0="${words0[*]}" - - ## find index range of word `$COMP_WORDS[$beg]` in string `$COMP_LINE`; - local i=0 j=0 - for (( i = 0; i <= $beg; i++ )); do - for (( ; j <= ${#COMP_LINE}; j++ )); do - [[ "${COMP_LINE:j}" == "${COMP_WORDS[i]}"* ]] && break - done - (( i == $beg )) && break - (( j += ${#COMP_WORDS[i]} )) - done - - ## now `j` is at the beginning of word `$COMP_WORDS[$beg]`; and we know - ## the index range is `[j, j+${#cmd})`; - - ## update `$COMP_LINE` and `$COMP_POINT`; - COMP_LINE="${COMP_LINE:0:j}${nstr0}${COMP_LINE:j+${#cmd}}" - if (( $COMP_POINT < j )); then - : - elif (( $COMP_POINT < j + ${#cmd} )); then - ## set current cursor position to the end of replacement string; - (( COMP_POINT = j + ${#nstr0} )) - else - (( COMP_POINT += ${#nstr0} - ${#cmd} )) - fi - - ## update `$COMP_WORDS` and `$COMP_CWORD`; - COMP_WORDS=( - "${COMP_WORDS[@]:0:beg}" - "${words0[@]}" - "${COMP_WORDS[@]:beg+1}" - ) - if (( $COMP_CWORD < $beg )); then - : - elif (( $COMP_CWORD < $beg + 1 )); then - ## set current word index to the last of replacement words; - (( COMP_CWORD = $beg + ${#words0[@]} - 1 )) - else - (( COMP_CWORD += ${#words0[@]} - 1 )) - fi - - ## update `$ignore` if it is not empty; if so, we know `$ignore` is not - ## equal to `$beg` because we checked that in case 2; we need to update - ## `$ignore` only when `$ignore > $beg`; save this condition in a local - ## var `$ignore_gt_beg` because we need it later; - if [[ -n "$ignore" ]]; then - local ignore_gt_beg=0 - if (( $ignore > $beg )); then - ignore_gt_beg=1 - (( ignore += ${#words0[@]} - 1 )) - fi - fi - - ## recursively expand part 0; - local used0=( "${used[@]}" "$cmd" ) - __compal__expand_alias \ - "$beg" \ - "$(( $beg + ${#words0[@]} ))" \ - "$ignore" \ - "${#used0[@]}" \ - "${used0[@]}" - local diff0="$__compal__retval" - - ## update `$ignore` if it is not empty and `$ignore_gt_beg` is true; - if [[ -n "$ignore" ]] && (( $ignore_gt_beg == 1 )); then - (( ignore += $diff0 )) - fi - - ## recursively expand part 1; must check `str0` not `nstr0`; - if [[ -n "$str0" ]] && [[ "${str0: -1}" == ' ' ]]; then - local used1=( "${used[@]}" ) - __compal__expand_alias \ - "$(( $beg + ${#words0[@]} + $diff0 ))" \ - "$(( $end + ${#words0[@]} - 1 + $diff0 ))" \ - "$ignore" \ - "${#used1[@]}" \ - "${used1[@]}" - local diff1="$__compal__retval" - else - local diff1=0 - fi - - ## return value; - __compal__retval=$(( ${#words0[@]} - 1 + diff0 + diff1 )) - fi -} - -## run a cspec using its args in argv fashion; -## -## despite as described in `man bash`, `complete -p` does not always print an -## existing completion in a way that can be reused as input; what complicates -## the matter here are quotes and escapes; -## -## as an example, when `complete -p` prints: -## -## $ complete -p -## complete -F _known_hosts "/tmp/aaa bbb" -## -## copy-paste running the above output gives wrong result: -## -## $ complete -F _known_hosts "/tmp/aaa bbb" -## $ complete -p -## complete -F _known_hosts /tmp/aaa bbb -## -## the correct command to give the same `complete -p` result is: -## -## $ complete -F _known_hosts '"/tmp/aaa bbb"' -## $ complete -p -## complete -F _known_hosts "/tmp/aaa bbb" -## -## to see another issue, this command gives a different result: -## -## $ complete -F _known_hosts '/tmp/aaa\ \ \ bbb' -## $ complete -p -## complete -F _known_hosts /tmp/aaa\ \ \ bbb -## -## note that these two `complete -p` results are *not* the same: -## -## complete -F _known_hosts "/tmp/aaa bbb" -## complete -F _known_hosts /tmp/aaa\ \ \ bbb -## -## despite this is true: -## -## [[ "/tmp/aaa bbb" == /tmp/aaa\ \ \ bbb ]] -## -## so we must parse the `complete -p` result and run parsed result; -## -## using `_split_cmd_line` to parse a cspec should be ok, because a cspec has -## only one command without redirections or assignments, also without command -## substitutions, etc.; we can then rerun this cspec in an argv fashion using -## this function; -## -## $@ -## : cspec args; -__compal__run_cspec_args() { - local cspec_args=( "$@" ) - - ## ensure this is indeed a cspec; - if [[ "${cspec_args[0]}" == "complete" ]]; then - ## run parsed completion command; - "${cspec_args[@]}" - else - __compal__error "not a complete command: ${cspec_args[*]}" - fi -} - -## the "auto" implementation of `_unmask_alias`; -## -## this function is called only when using auto unmask; -## -## $1 -## : alias command; -__compal__unmask_alias_auto() { - local cmd="$1" - - ## load vanilla completion of this command; - local cspec="${__compal__vanilla_cspecs[$cmd]}" - - if [[ -n "$cspec" ]]; then - ## a vanilla cspec for this command is found; due to some issues with - ## `complete -p` we cannot eval this cspec directly; instead, we need - ## to parse and run it in argv fashion; see `_run_cspec_args` comment; - __compal__split_cmd_line "$cspec" - local cspec_args=( "${__compal__retval[@]}" ) - __compal__run_cspec_args "${cspec_args[@]}" - else - ## a (parsed) vanilla cspec for this command is not found; search raw - ## vanilla cspecs for this command; if a matched raw vanilla cspec is - ## found, then parse, save and run it; search is a loop because these - ## raw cspecs are not parsed yet; - for _cspec in "${!__compal__raw_vanilla_cspecs[@]}"; do - if [[ "$_cspec" == *" $cmd" ]]; then - __compal__split_cmd_line "$_cspec" - local _cspec_args=( "${__compal__retval[@]}" ) - - ## ensure this cspec has the correct command; - local _cspec_cmd="${_cspec_args[-1]}" - if [[ "$_cspec_cmd" == "$cmd" ]]; then - __compal__vanilla_cspecs["$_cspec_cmd"]="$_cspec" - unset __compal__raw_vanilla_cspecs["$_cspec"] - __compal__run_cspec_args "${_cspec_args[@]}" - return - fi - fi - done - - ## no vanilla cspec for this command is found; we remove the current - ## cspec for this command (which should be `_complete_alias`), which - ## effectively uses the default cspec (ie: `complete -D`) to process - ## this command; we do not fallback to `_completion_loader`, because - ## the default cspec could be something else, and here we want to be - ## consistent; - complete -r "$cmd" - fi -} - -## the "manual" implementation of `_unmask_alias`; -## -## this function is called only when using manual unmask; -## -## users may edit this function to customize vanilla command completions; -## -## $1 -## : alias command; -__compal__unmask_alias_manual() { - local cmd="$1" - - case "$cmd" in - bind) - complete -A binding "$cmd" - ;; - help) - complete -A helptopic "$cmd" - ;; - set) - complete -A setopt "$cmd" - ;; - shopt) - complete -A shopt "$cmd" - ;; - bg) - complete -A stopped -P '"%' -S '"' "$cmd" - ;; - service) - complete -F _service "$cmd" - ;; - unalias) - complete -a "$cmd" - ;; - builtin) - complete -b "$cmd" - ;; - command|type|which) - complete -c "$cmd" - ;; - fg|jobs|disown) - complete -j -P '"%' -S '"' "$cmd" - ;; - groups|slay|w|sux) - complete -u "$cmd" - ;; - readonly|unset) - complete -v "$cmd" - ;; - traceroute|traceroute6|tracepath|tracepath6|fping|fping6|telnet|rsh|\ - rlogin|ftp|dig|mtr|ssh-installkeys|showmount) - complete -F _known_hosts "$cmd" - ;; - aoss|command|do|else|eval|exec|ltrace|nice|nohup|padsp|then|time|\ - tsocks|vsound|xargs) - complete -F _command "$cmd" - ;; - fakeroot|gksu|gksudo|kdesudo|really) - complete -F _root_command "$cmd" - ;; - a2ps|awk|base64|bash|bc|bison|cat|chroot|colordiff|cp|csplit|cut|date|\ - df|diff|dir|du|enscript|env|expand|fmt|fold|gperf|grep|grub|head|\ - irb|ld|ldd|less|ln|ls|m4|md5sum|mkdir|mkfifo|mknod|mv|netstat|nl|\ - nm|objcopy|objdump|od|paste|pr|ptx|readelf|rm|rmdir|sed|seq|\ - sha{,1,224,256,384,512}sum|shar|sort|split|strip|sum|tac|tail|tee|\ - texindex|touch|tr|uname|unexpand|uniq|units|vdir|wc|who) - complete -F _longopt "$cmd" - ;; - *) - _completion_loader "$cmd" - ;; - esac -} - -## set completion function of an alias command to the vanilla one; -## -## $1 -## : alias command; -__compal__unmask_alias() { - local cmd="$1" - - ## ensure current completion function of this command is `_complete_alias`; - if [[ "$(complete -p "$cmd")" != *"-F _complete_alias"* ]]; then - __compal__error "cannot unmask alias command: $cmd" - return - fi - - ## decide which unmask function to call; - if (( "$COMPAL_AUTO_UNMASK" == 1 )); then - __compal__unmask_alias_auto "$@" - else - __compal__unmask_alias_manual "$@" - fi -} - -## set completion function of an alias command to `_complete_alias`; doing so -## overwrites the original completion function for this command, if any; this -## makes `_complete_alias` look like a "mask" on the alias command; then, why -## is this function called a "remask"? because this function is always called -## in pair with (and after) a corresponding "unmask" function; the 1st "mask" -## happens when user directly runs `complete -F _complete_alias ...`; -## -## $1 -## : alias command; -__compal__remask_alias() { - local cmd="$1" - - complete -F _complete_alias "$cmd" -} - -## delegate completion to `bash-completion`; -__compal__delegate() { - ## `_command_offset` is a meta-command completion function provided by - ## `bash-completion`; the documentation does not say it will work with - ## argument `0`, but looking at its code (version 2.11) it should; - _command_offset 0 -} - -## delegate completion to `bash-completion`, within a transient context in -## which the input alias command is unmasked; -## -## this function expects current completion function of this command to be -## `_complete_alias`; -## -## $1 -## : alias command to be unmasked; -__compal__delegate_in_context() { - local cmd="$1" - - ## unmask alias: - __compal__unmask_alias "$cmd" - - ## do actual completion; - __compal__delegate - - ## remask alias: - __compal__remask_alias "$cmd" -} - -## save vanilla completions; run this function when this script is sourced; -## this ensures vanilla completions of alias commands are fetched and saved -## before they are overwritten by `complete -F _complete_alias`; -## -## this function saves raw cspecs and does not parse them; for other useful -## comments about parsing and running cspecs see function `_run_cspec_args`; -## -## running this function on source is mandatory only when using auto unmask; -## when using manual unmask, it is safe to skip this function on source; -__compal__save_vanilla_cspecs() { - ## get default cspec; - local def_cspec; def_cspec="$(complete -p -D 2>/dev/null)" - - ## `complete -p` prints cspec for one command per line; so we can loop; - while IFS= read -r cspec; do - - ## skip default cspec; - [[ "$cspec" != "$def_cspec" ]] || continue - - ## skip `-F _complete_alias` cspecs; - [[ "$cspec" != *"-F _complete_alias"* ]] || continue - - ## now we have a vanilla cspec; save it in `_raw_vanilla_cspecs`; - __compal__raw_vanilla_cspecs["$cspec"]="" - - done < <(complete -p 2>/dev/null) -} - -## completion function for non-alias commands; normally, the mere invocation of -## this function indicates an error of command completion configuration because -## we are invoking `_complete_alias` on a non-alias command; but there can be a -## special case: `_command_offset` will try with command basename when there is -## no completion for the command itself; an example is `sudo /bin/ls` when both -## `sudo` and `ls` are aliases; this function takes care of this special case; -## -## $1 -## : the name of the command whose arguments are being completed; -## $2 -## : the word being completed; -## $3 -## : the word preceding the word being completed on the current command line; -__compal__complete_non_alias() { - ## get command name; must be non-alias; - local cmd="${COMP_WORDS[0]}" - - ## get command basename; - local compcmd="${cmd##*/}" - - if alias "$compcmd" &>/dev/null; then - ## if command basename is an alias, delegate completion; - __compal__delegate_in_context "$compcmd" - else - ## else, this indicates an error; - __compal__error "command is not an alias: $cmd" - fi -} - -## completion function for alias commands; -## -## $1 -## : the name of the command whose arguments are being completed; -## $2 -## : the word being completed; -## $3 -## : the word preceding the word being completed on the current command line; -__compal__complete_alias() { - ## get command name; must be alias; - local cmd="${COMP_WORDS[0]}" - - ## we expand aliases only for the original command line (ie: the command - ## line on which user pressed ``); unfortunately, we may not have a - ## chance to see the original command line, and we have no way to ensure - ## that; we take an approximation: we expand aliases only in the outmost - ## call of this function, which implies only on the first occasion of an - ## alias command; we can ensure this condition using a refcnt and expand - ## aliases iff the refcnt is equal to 0; this approximation always works - ## correctly when the 1st word on the original command line is an alias; - ## - ## this approximation may fail when the 1st word on the original command - ## line is not an alias; an example that expects files but gets ip addrs: - ## - ## $ unalias sudo - ## $ complete -r sudo - ## $ alias ls='ping' - ## $ complete -F _complete_alias ls - ## $ sudo ls - ## {ip} - ## {ip} - ## {ip} - ## ... - ## - if (( __compal__refcnt == 0 )); then - - ## find index range of word `$COMP_WORDS[$COMP_CWORD]` in string - ## `$COMP_LINE`; dont expand this word if `$COMP_POINT` (cursor - ## position) lies in this range because the word may be incomplete; - local i=0 j=0 - for (( ; i <= $COMP_CWORD; i++ )); do - for (( ; j <= ${#COMP_LINE}; j++ )); do - [[ "${COMP_LINE:j}" == "${COMP_WORDS[i]}"* ]] && break - done - (( i == $COMP_CWORD )) && break - (( j += ${#COMP_WORDS[i]} )) - done - - ## now `j` is at the beginning of word `$COMP_WORDS[$COMP_CWORD]`; and - ## we know the index range is `[j, j+${#COMP_WORDS[$COMP_CWORD]}]`; we - ## include the right endpoint to cover the case where cursor is at the - ## exact end of the word; compare the index range with `$COMP_POINT`; - if (( j <= $COMP_POINT )) && \ - (( $COMP_POINT <= j + ${#COMP_WORDS[$COMP_CWORD]} )); then - local ignore="$COMP_CWORD" - else - local ignore="" - fi - - ## expand aliases; - __compal__expand_alias 0 "${#COMP_WORDS[@]}" "$ignore" 0 - fi - - ## increase refcnt; - (( __compal__refcnt++ )) - - ## delegate completion in context; this actually contains several steps: - ## - ## - unmask alias: - ## - ## since aliases have been fully expanded, no need to consider aliases - ## in the resulting command line; therefore, we now set the completion - ## function for this alias to the vanilla, alias-free one; this avoids - ## infinite recursion when using self-aliases (eg: `alias ls='ls -a'`); - ## - ## - do actual completion: - ## - ## `_command_offset` is a meta-command completion function provided by - ## `bash-completion`; the documentation does not say it will work with - ## argument `0`, but looking at its code (version 2.11) it should; - ## - ## - remask alias: - ## - ## reset this command completion function to `_complete_alias`; - ## - ## these steps are put into one function `_delegate_in_context`; - __compal__delegate_in_context "$cmd" - - ## decrease refcnt; - (( __compal__refcnt-- )) -} - -## this is the function to be set with `complete -F`; this function expects -## alias commands, but can also handle non-alias commands in rare occasions; -## -## as a standard completion function, this function can take 3 arguments as -## described in `man bash`; they are currently not being used, though; -## -## $1 -## : the name of the command whose arguments are being completed; -## $2 -## : the word being completed; -## $3 -## : the word preceding the word being completed on the current command line; -_complete_alias() { - ## get command; - local cmd="${COMP_WORDS[0]}" - - ## complete command; - if ! alias "$cmd" &>/dev/null; then - __compal__complete_non_alias "$@" - else - __compal__complete_alias "$@" - fi -} - -## main function; -__compal__main() { - if (( "$COMPAL_AUTO_UNMASK" == 1 )); then - ## save vanilla completions; - __compal__save_vanilla_cspecs - fi -} - -## ============================================================================ -## # script -## ============================================================================ - -## run main function; -__compal__main - -## ============================================================================ -## # complete user-defined aliases -## ============================================================================ - -## to complete specific aliases, uncomment and edit these lines; -#complete -F _complete_alias myalias1 -#complete -F _complete_alias myalias2 -#complete -F _complete_alias myalias3 - -## to complete all aliases, run this line after all aliases have been defined; -#complete -F _complete_alias "${!BASH_ALIASES[@]}" - -