| @ -0,0 +1,597 @@ | |||
| # ------------------------------------------------------------------------------------------------- | |||
| # Copyright (c) 2010-2020 zsh-syntax-highlighting contributors | |||
| # All rights reserved. | |||
| # | |||
| # Redistribution and use in source and binary forms, with or without modification, are permitted | |||
| # provided that the following conditions are met: | |||
| # | |||
| # * Redistributions of source code must retain the above copyright notice, this list of conditions | |||
| # and the following disclaimer. | |||
| # * Redistributions in binary form must reproduce the above copyright notice, this list of | |||
| # conditions and the following disclaimer in the documentation and/or other materials provided | |||
| # with the distribution. | |||
| # * Neither the name of the zsh-syntax-highlighting contributors nor the names of its contributors | |||
| # may be used to endorse or promote products derived from this software without specific prior | |||
| # written permission. | |||
| # | |||
| # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR | |||
| # IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND | |||
| # FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR | |||
| # CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL | |||
| # DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, | |||
| # DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER | |||
| # IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT | |||
| # OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. | |||
| # ------------------------------------------------------------------------------------------------- | |||
| # -*- mode: zsh; sh-indentation: 2; indent-tabs-mode: nil; sh-basic-offset: 2; -*- | |||
| # vim: ft=zsh sw=2 ts=2 et | |||
| # ------------------------------------------------------------------------------------------------- | |||
| # First of all, ensure predictable parsing. | |||
| typeset zsh_highlight__aliases="$(builtin alias -Lm '[^+]*')" | |||
| # In zsh <= 5.2, aliases that begin with a plus sign ('alias -- +foo=42') | |||
| # are emitted by `alias -L` without a '--' guard, so they don't round trip. | |||
| # | |||
| # Hence, we exclude them from unaliasing: | |||
| builtin unalias -m '[^+]*' | |||
| # Set $0 to the expected value, regardless of functionargzero. | |||
| 0=${(%):-%N} | |||
| if true; then | |||
| # $0 is reliable | |||
| typeset -g ZSH_HIGHLIGHT_VERSION=$(<"${0:A:h}"/.version) | |||
| typeset -g ZSH_HIGHLIGHT_REVISION=$(<"${0:A:h}"/.revision-hash) | |||
| if [[ $ZSH_HIGHLIGHT_REVISION == \$Format:* ]]; then | |||
| # When running from a source tree without 'make install', $ZSH_HIGHLIGHT_REVISION | |||
| # would be set to '$Format:%H$' literally. That's an invalid value, and obtaining | |||
| # the valid value (via `git rev-parse HEAD`, as Makefile does) might be costly, so: | |||
| ZSH_HIGHLIGHT_REVISION=HEAD | |||
| fi | |||
| fi | |||
| # This function takes a single argument F and returns True iff F is an autoload stub. | |||
| _zsh_highlight__function_is_autoload_stub_p() { | |||
| if zmodload -e zsh/parameter; then | |||
| #(( ${+functions[$1]} )) && | |||
| [[ "$functions[$1]" == *"builtin autoload -X"* ]] | |||
| else | |||
| #[[ $(type -wa -- "$1") == *'function'* ]] && | |||
| [[ "${${(@f)"$(which -- "$1")"}[2]}" == $'\t'$histchars[3]' undefined' ]] | |||
| fi | |||
| # Do nothing here: return the exit code of the if. | |||
| } | |||
| # Return True iff the argument denotes a function name. | |||
| _zsh_highlight__is_function_p() { | |||
| if zmodload -e zsh/parameter; then | |||
| (( ${+functions[$1]} )) | |||
| else | |||
| [[ $(type -wa -- "$1") == *'function'* ]] | |||
| fi | |||
| } | |||
| # This function takes a single argument F and returns True iff F denotes the | |||
| # name of a callable function. A function is callable if it is fully defined | |||
| # or if it is marked for autoloading and autoloading it at the first call to it | |||
| # will succeed. In particular, if a function has been marked for autoloading | |||
| # but is not available in $fpath, then this function will return False therefor. | |||
| # | |||
| # See users/21671 http://www.zsh.org/cgi-bin/mla/redirect?USERNUMBER=21671 | |||
| _zsh_highlight__function_callable_p() { | |||
| if _zsh_highlight__is_function_p "$1" && | |||
| ! _zsh_highlight__function_is_autoload_stub_p "$1" | |||
| then | |||
| # Already fully loaded. | |||
| return 0 # true | |||
| else | |||
| # "$1" is either an autoload stub, or not a function at all. | |||
| # | |||
| # Use a subshell to avoid affecting the calling shell. | |||
| # | |||
| # We expect 'autoload +X' to return non-zero if it fails to fully load | |||
| # the function. | |||
| ( autoload -U +X -- "$1" 2>/dev/null ) | |||
| return $? | |||
| fi | |||
| } | |||
| # ------------------------------------------------------------------------------------------------- | |||
| # Core highlighting update system | |||
| # ------------------------------------------------------------------------------------------------- | |||
| # Use workaround for bug in ZSH? | |||
| # zsh-users/zsh@48cadf4 http://www.zsh.org/mla/workers//2017/msg00034.html | |||
| autoload -Uz is-at-least | |||
| if is-at-least 5.4; then | |||
| typeset -g zsh_highlight__pat_static_bug=false | |||
| else | |||
| typeset -g zsh_highlight__pat_static_bug=true | |||
| fi | |||
| # Array declaring active highlighters names. | |||
| typeset -ga ZSH_HIGHLIGHT_HIGHLIGHTERS | |||
| # Update ZLE buffer syntax highlighting. | |||
| # | |||
| # Invokes each highlighter that needs updating. | |||
| # This function is supposed to be called whenever the ZLE state changes. | |||
| _zsh_highlight() | |||
| { | |||
| # Store the previous command return code to restore it whatever happens. | |||
| local ret=$? | |||
| # Make it read-only. Can't combine this with the previous line when POSIX_BUILTINS may be set. | |||
| typeset -r ret | |||
| # $region_highlight should be predefined, either by zle or by the test suite's mock (non-special) array. | |||
| (( ${+region_highlight} )) || { | |||
| echo >&2 'zsh-syntax-highlighting: error: $region_highlight is not defined' | |||
| echo >&2 'zsh-syntax-highlighting: (Check whether zsh-syntax-highlighting was installed according to the instructions.)' | |||
| return $ret | |||
| } | |||
| # Probe the memo= feature, once. | |||
| (( ${+zsh_highlight__memo_feature} )) || { | |||
| region_highlight+=( " 0 0 fg=red, memo=zsh-syntax-highlighting" ) | |||
| case ${region_highlight[-1]} in | |||
| ("0 0 fg=red") | |||
| # zsh 5.8 or earlier | |||
| integer -gr zsh_highlight__memo_feature=0 | |||
| ;; | |||
| ("0 0 fg=red memo=zsh-syntax-highlighting") | |||
| # zsh 5.9 or later | |||
| integer -gr zsh_highlight__memo_feature=1 | |||
| ;; | |||
| (" 0 0 fg=red, memo=zsh-syntax-highlighting") ;& | |||
| (*) | |||
| # We can get here in two ways: | |||
| # | |||
| # 1. When not running as a widget. In that case, $region_highlight is | |||
| # not a special variable (= one with custom getter/setter functions | |||
| # written in C) but an ordinary one, so the third case pattern matches | |||
| # and we fall through to this block. (The test suite uses this codepath.) | |||
| # | |||
| # 2. When running under a future version of zsh that will have changed | |||
| # the serialization of $region_highlight elements from their underlying | |||
| # C structs, so that none of the previous case patterns will match. | |||
| # | |||
| # In either case, fall back to a version check. | |||
| # | |||
| # The memo= feature was added to zsh in commit zsh-5.8-172-gdd6e702ee. | |||
| # The version number at the time was 5.8.0.2-dev (see Config/version.mk). | |||
| # Therefore, on 5.8.0.3 and newer the memo= feature is available. | |||
| # | |||
| # On zsh version 5.8.0.2 between the aforementioned commit and the | |||
| # first Config/version.mk bump after it (which, at the time of writing, | |||
| # is yet to come), this condition will false negative. | |||
| if is-at-least 5.8.0.3 $ZSH_VERSION.0.0; then | |||
| integer -gr zsh_highlight__memo_feature=1 | |||
| else | |||
| integer -gr zsh_highlight__memo_feature=0 | |||
| fi | |||
| ;; | |||
| esac | |||
| region_highlight[-1]=() | |||
| } | |||
| # Reset region_highlight to build it from scratch | |||
| if (( zsh_highlight__memo_feature )); then | |||
| region_highlight=( "${(@)region_highlight:#*memo=zsh-syntax-highlighting*}" ) | |||
| else | |||
| # Legacy codepath. Not very interoperable with other plugins (issue #418). | |||
| region_highlight=() | |||
| fi | |||
| # Remove all highlighting in isearch, so that only the underlining done by zsh itself remains. | |||
| # For details see FAQ entry 'Why does syntax highlighting not work while searching history?'. | |||
| # This disables highlighting during isearch (for reasons explained in README.md) unless zsh is new enough | |||
| # and doesn't have the pattern matching bug | |||
| if [[ $WIDGET == zle-isearch-update ]] && { $zsh_highlight__pat_static_bug || ! (( $+ISEARCHMATCH_ACTIVE )) }; then | |||
| return $ret | |||
| fi | |||
| # Before we 'emulate -L', save the user's options | |||
| local -A zsyh_user_options | |||
| if zmodload -e zsh/parameter; then | |||
| zsyh_user_options=("${(kv)options[@]}") | |||
| else | |||
| local canonical_options onoff option raw_options | |||
| raw_options=(${(f)"$(emulate -R zsh; set -o)"}) | |||
| canonical_options=(${${${(M)raw_options:#*off}%% *}#no} ${${(M)raw_options:#*on}%% *}) | |||
| for option in "${canonical_options[@]}"; do | |||
| [[ -o $option ]] | |||
| case $? in | |||
| (0) zsyh_user_options+=($option on);; | |||
| (1) zsyh_user_options+=($option off);; | |||
| (*) # Can't happen, surely? | |||
| echo "zsh-syntax-highlighting: warning: '[[ -o $option ]]' returned $?" | |||
| ;; | |||
| esac | |||
| done | |||
| fi | |||
| typeset -r zsyh_user_options | |||
| emulate -L zsh | |||
| setopt localoptions warncreateglobal nobashrematch | |||
| local REPLY # don't leak $REPLY into global scope | |||
| # Do not highlight if there are more than 300 chars in the buffer. It's most | |||
| # likely a pasted command or a huge list of files in that case.. | |||
| [[ -n ${ZSH_HIGHLIGHT_MAXLENGTH:-} ]] && [[ $#BUFFER -gt $ZSH_HIGHLIGHT_MAXLENGTH ]] && return $ret | |||
| # Do not highlight if there are pending inputs (copy/paste). | |||
| [[ $PENDING -gt 0 ]] && return $ret | |||
| { | |||
| local cache_place | |||
| local -a region_highlight_copy | |||
| # Select which highlighters in ZSH_HIGHLIGHT_HIGHLIGHTERS need to be invoked. | |||
| local highlighter; for highlighter in $ZSH_HIGHLIGHT_HIGHLIGHTERS; do | |||
| # eval cache place for current highlighter and prepare it | |||
| cache_place="_zsh_highlight__highlighter_${highlighter}_cache" | |||
| typeset -ga ${cache_place} | |||
| # If highlighter needs to be invoked | |||
| if ! type "_zsh_highlight_highlighter_${highlighter}_predicate" >&/dev/null; then | |||
| echo "zsh-syntax-highlighting: warning: disabling the ${(qq)highlighter} highlighter as it has not been loaded" >&2 | |||
| # TODO: use ${(b)} rather than ${(q)} if supported | |||
| ZSH_HIGHLIGHT_HIGHLIGHTERS=( ${ZSH_HIGHLIGHT_HIGHLIGHTERS:#${highlighter}} ) | |||
| elif "_zsh_highlight_highlighter_${highlighter}_predicate"; then | |||
| # save a copy, and cleanup region_highlight | |||
| region_highlight_copy=("${region_highlight[@]}") | |||
| region_highlight=() | |||
| # Execute highlighter and save result | |||
| { | |||
| "_zsh_highlight_highlighter_${highlighter}_paint" | |||
| } always { | |||
| : ${(AP)cache_place::="${region_highlight[@]}"} | |||
| } | |||
| # Restore saved region_highlight | |||
| region_highlight=("${region_highlight_copy[@]}") | |||
| fi | |||
| # Use value form cache if any cached | |||
| region_highlight+=("${(@P)cache_place}") | |||
| done | |||
| # Re-apply zle_highlight settings | |||
| # region | |||
| () { | |||
| (( REGION_ACTIVE )) || return | |||
| integer min max | |||
| if (( MARK > CURSOR )) ; then | |||
| min=$CURSOR max=$MARK | |||
| else | |||
| min=$MARK max=$CURSOR | |||
| fi | |||
| if (( REGION_ACTIVE == 1 )); then | |||
| [[ $KEYMAP = vicmd ]] && (( max++ )) | |||
| elif (( REGION_ACTIVE == 2 )); then | |||
| local needle=$'\n' | |||
| # CURSOR and MARK are 0 indexed between letters like region_highlight | |||
| # Do not include the newline in the highlight | |||
| (( min = ${BUFFER[(Ib:min:)$needle]} )) | |||
| (( max = ${BUFFER[(ib:max:)$needle]} - 1 )) | |||
| fi | |||
| _zsh_highlight_apply_zle_highlight region standout "$min" "$max" | |||
| } | |||
| # yank / paste (zsh-5.1.1 and newer) | |||
| (( $+YANK_ACTIVE )) && (( YANK_ACTIVE )) && _zsh_highlight_apply_zle_highlight paste standout "$YANK_START" "$YANK_END" | |||
| # isearch | |||
| (( $+ISEARCHMATCH_ACTIVE )) && (( ISEARCHMATCH_ACTIVE )) && _zsh_highlight_apply_zle_highlight isearch underline "$ISEARCHMATCH_START" "$ISEARCHMATCH_END" | |||
| # suffix | |||
| (( $+SUFFIX_ACTIVE )) && (( SUFFIX_ACTIVE )) && _zsh_highlight_apply_zle_highlight suffix bold "$SUFFIX_START" "$SUFFIX_END" | |||
| return $ret | |||
| } always { | |||
| typeset -g _ZSH_HIGHLIGHT_PRIOR_BUFFER="$BUFFER" | |||
| typeset -gi _ZSH_HIGHLIGHT_PRIOR_CURSOR=$CURSOR | |||
| } | |||
| } | |||
| # Apply highlighting based on entries in the zle_highlight array. | |||
| # This function takes four arguments: | |||
| # 1. The exact entry (no patterns) in the zle_highlight array: | |||
| # region, paste, isearch, or suffix | |||
| # 2. The default highlighting that should be applied if the entry is unset | |||
| # 3. and 4. Two integer values describing the beginning and end of the | |||
| # range. The order does not matter. | |||
| _zsh_highlight_apply_zle_highlight() { | |||
| local entry="$1" default="$2" | |||
| integer first="$3" second="$4" | |||
| # read the relevant entry from zle_highlight | |||
| # | |||
| # ### In zsh≥5.0.8 we'd use ${(b)entry}, but we support older zsh's, so we don't | |||
| # ### add (b). The only effect is on the failure mode for callers that violate | |||
| # ### the precondition. | |||
| local region="${zle_highlight[(r)${entry}:*]-}" | |||
| if [[ -z "$region" ]]; then | |||
| # entry not specified at all, use default value | |||
| region=$default | |||
| else | |||
| # strip prefix | |||
| region="${region#${entry}:}" | |||
| # no highlighting when set to the empty string or to 'none' | |||
| if [[ -z "$region" ]] || [[ "$region" == none ]]; then | |||
| return | |||
| fi | |||
| fi | |||
| integer start end | |||
| if (( first < second )); then | |||
| start=$first end=$second | |||
| else | |||
| start=$second end=$first | |||
| fi | |||
| region_highlight+=("$start $end $region, memo=zsh-syntax-highlighting") | |||
| } | |||
| # ------------------------------------------------------------------------------------------------- | |||
| # API/utility functions for highlighters | |||
| # ------------------------------------------------------------------------------------------------- | |||
| # Array used by highlighters to declare user overridable styles. | |||
| typeset -gA ZSH_HIGHLIGHT_STYLES | |||
| # Whether the command line buffer has been modified or not. | |||
| # | |||
| # Returns 0 if the buffer has changed since _zsh_highlight was last called. | |||
| _zsh_highlight_buffer_modified() | |||
| { | |||
| [[ "${_ZSH_HIGHLIGHT_PRIOR_BUFFER:-}" != "$BUFFER" ]] | |||
| } | |||
| # Whether the cursor has moved or not. | |||
| # | |||
| # Returns 0 if the cursor has moved since _zsh_highlight was last called. | |||
| _zsh_highlight_cursor_moved() | |||
| { | |||
| [[ -n $CURSOR ]] && [[ -n ${_ZSH_HIGHLIGHT_PRIOR_CURSOR-} ]] && (($_ZSH_HIGHLIGHT_PRIOR_CURSOR != $CURSOR)) | |||
| } | |||
| # Add a highlight defined by ZSH_HIGHLIGHT_STYLES. | |||
| # | |||
| # Should be used by all highlighters aside from 'pattern' (cf. ZSH_HIGHLIGHT_PATTERN). | |||
| # Overwritten in tests/test-highlighting.zsh when testing. | |||
| _zsh_highlight_add_highlight() | |||
| { | |||
| local -i start end | |||
| local highlight | |||
| start=$1 | |||
| end=$2 | |||
| shift 2 | |||
| for highlight; do | |||
| if (( $+ZSH_HIGHLIGHT_STYLES[$highlight] )); then | |||
| region_highlight+=("$start $end $ZSH_HIGHLIGHT_STYLES[$highlight], memo=zsh-syntax-highlighting") | |||
| break | |||
| fi | |||
| done | |||
| } | |||
| # ------------------------------------------------------------------------------------------------- | |||
| # Setup functions | |||
| # ------------------------------------------------------------------------------------------------- | |||
| # Helper for _zsh_highlight_bind_widgets | |||
| # $1 is name of widget to call | |||
| _zsh_highlight_call_widget() | |||
| { | |||
| builtin zle "$@" && | |||
| _zsh_highlight | |||
| } | |||
| # Decide whether to use the zle-line-pre-redraw codepath (colloquially known as | |||
| # "feature/redrawhook", after the topic branch's name) or the legacy "bind all | |||
| # widgets" codepath. | |||
| # | |||
| # We use the new codepath under two conditions: | |||
| # | |||
| # 1. If it's available, which we check by testing for add-zle-hook-widget's availability. | |||
| # | |||
| # 2. If zsh has the memo= feature, which is required for interoperability reasons. | |||
| # See issues #579 and #735, and the issues referenced from them. | |||
| # | |||
| # We check this with a plain version number check, since a functional check, | |||
| # as done by _zsh_highlight, can only be done from inside a widget | |||
| # function — a catch-22. | |||
| # | |||
| # See _zsh_highlight for the magic version number. (The use of 5.8.0.2 | |||
| # rather than 5.8.0.3 as in the _zsh_highlight is deliberate.) | |||
| if is-at-least 5.8.0.2 $ZSH_VERSION.0.0 && _zsh_highlight__function_callable_p add-zle-hook-widget | |||
| then | |||
| autoload -U add-zle-hook-widget | |||
| _zsh_highlight__zle-line-finish() { | |||
| # Reset $WIDGET since the 'main' highlighter depends on it. | |||
| # | |||
| # Since $WIDGET is declared by zle as read-only in this function's scope, | |||
| # a nested function is required in order to shadow its built-in value; | |||
| # see "User-defined widgets" in zshall. | |||
| () { | |||
| local -h -r WIDGET=zle-line-finish | |||
| _zsh_highlight | |||
| } | |||
| } | |||
| _zsh_highlight__zle-line-pre-redraw() { | |||
| # Set $? to 0 for _zsh_highlight. Without this, subsequent | |||
| # zle-line-pre-redraw hooks won't run, since add-zle-hook-widget happens to | |||
| # call us with $? == 1 in the common case. | |||
| true && _zsh_highlight "$@" | |||
| } | |||
| _zsh_highlight_bind_widgets(){} | |||
| if [[ -o zle ]]; then | |||
| add-zle-hook-widget zle-line-pre-redraw _zsh_highlight__zle-line-pre-redraw | |||
| add-zle-hook-widget zle-line-finish _zsh_highlight__zle-line-finish | |||
| fi | |||
| else | |||
| # Rebind all ZLE widgets to make them invoke _zsh_highlights. | |||
| _zsh_highlight_bind_widgets() | |||
| { | |||
| setopt localoptions noksharrays | |||
| typeset -F SECONDS | |||
| local prefix=orig-s$SECONDS-r$RANDOM # unique each time, in case we're sourced more than once | |||
| # Load ZSH module zsh/zleparameter, needed to override user defined widgets. | |||
| zmodload zsh/zleparameter 2>/dev/null || { | |||
| print -r -- >&2 'zsh-syntax-highlighting: failed loading zsh/zleparameter.' | |||
| return 1 | |||
| } | |||
| # Override ZLE widgets to make them invoke _zsh_highlight. | |||
| local -U widgets_to_bind | |||
| widgets_to_bind=(${${(k)widgets}:#(.*|run-help|which-command|beep|set-local-history|yank|yank-pop)}) | |||
| # Always wrap special zle-line-finish widget. This is needed to decide if the | |||
| # current line ends and special highlighting logic needs to be applied. | |||
| # E.g. remove cursor imprint, don't highlight partial paths, ... | |||
| widgets_to_bind+=(zle-line-finish) | |||
| # Always wrap special zle-isearch-update widget to be notified of updates in isearch. | |||
| # This is needed because we need to disable highlighting in that case. | |||
| widgets_to_bind+=(zle-isearch-update) | |||
| local cur_widget | |||
| for cur_widget in $widgets_to_bind; do | |||
| case ${widgets[$cur_widget]:-""} in | |||
| # Already rebound event: do nothing. | |||
| user:_zsh_highlight_widget_*);; | |||
| # The "eval"'s are required to make $cur_widget a closure: the value of the parameter at function | |||
| # definition time is used. | |||
| # | |||
| # We can't use ${0/_zsh_highlight_widget_} because these widgets are always invoked with | |||
| # NO_function_argzero, regardless of the option's setting here. | |||
| # User defined widget: override and rebind old one with prefix "orig-". | |||
| user:*) zle -N $prefix-$cur_widget ${widgets[$cur_widget]#*:} | |||
| eval "_zsh_highlight_widget_${(q)prefix}-${(q)cur_widget}() { _zsh_highlight_call_widget ${(q)prefix}-${(q)cur_widget} -- \"\$@\" }" | |||
| zle -N $cur_widget _zsh_highlight_widget_$prefix-$cur_widget;; | |||
| # Completion widget: override and rebind old one with prefix "orig-". | |||
| completion:*) zle -C $prefix-$cur_widget ${${(s.:.)widgets[$cur_widget]}[2,3]} | |||
| eval "_zsh_highlight_widget_${(q)prefix}-${(q)cur_widget}() { _zsh_highlight_call_widget ${(q)prefix}-${(q)cur_widget} -- \"\$@\" }" | |||
| zle -N $cur_widget _zsh_highlight_widget_$prefix-$cur_widget;; | |||
| # Builtin widget: override and make it call the builtin ".widget". | |||
| builtin) eval "_zsh_highlight_widget_${(q)prefix}-${(q)cur_widget}() { _zsh_highlight_call_widget .${(q)cur_widget} -- \"\$@\" }" | |||
| zle -N $cur_widget _zsh_highlight_widget_$prefix-$cur_widget;; | |||
| # Incomplete or nonexistent widget: Bind to z-sy-h directly. | |||
| *) | |||
| if [[ $cur_widget == zle-* ]] && (( ! ${+widgets[$cur_widget]} )); then | |||
| _zsh_highlight_widget_${cur_widget}() { :; _zsh_highlight } | |||
| zle -N $cur_widget _zsh_highlight_widget_$cur_widget | |||
| else | |||
| # Default: unhandled case. | |||
| print -r -- >&2 "zsh-syntax-highlighting: unhandled ZLE widget ${(qq)cur_widget}" | |||
| print -r -- >&2 "zsh-syntax-highlighting: (This is sometimes caused by doing \`bindkey <keys> ${(q-)cur_widget}\` without creating the ${(qq)cur_widget} widget with \`zle -N\` or \`zle -C\`.)" | |||
| fi | |||
| esac | |||
| done | |||
| } | |||
| fi | |||
| # Load highlighters from directory. | |||
| # | |||
| # Arguments: | |||
| # 1) Path to the highlighters directory. | |||
| _zsh_highlight_load_highlighters() | |||
| { | |||
| setopt localoptions noksharrays bareglobqual | |||
| # Check the directory exists. | |||
| [[ -d "$1" ]] || { | |||
| print -r -- >&2 "zsh-syntax-highlighting: highlighters directory ${(qq)1} not found." | |||
| return 1 | |||
| } | |||
| # Load highlighters from highlighters directory and check they define required functions. | |||
| local highlighter highlighter_dir | |||
| for highlighter_dir ($1/*/(/)); do | |||
| highlighter="${highlighter_dir:t}" | |||
| [[ -f "$highlighter_dir${highlighter}-highlighter.zsh" ]] && | |||
| . "$highlighter_dir${highlighter}-highlighter.zsh" | |||
| if type "_zsh_highlight_highlighter_${highlighter}_paint" &> /dev/null && | |||
| type "_zsh_highlight_highlighter_${highlighter}_predicate" &> /dev/null; | |||
| then | |||
| # New (0.5.0) function names | |||
| elif type "_zsh_highlight_${highlighter}_highlighter" &> /dev/null && | |||
| type "_zsh_highlight_${highlighter}_highlighter_predicate" &> /dev/null; | |||
| then | |||
| # Old (0.4.x) function names | |||
| if false; then | |||
| # TODO: only show this warning for plugin authors/maintainers, not for end users | |||
| print -r -- >&2 "zsh-syntax-highlighting: warning: ${(qq)highlighter} highlighter uses deprecated entry point names; please ask its maintainer to update it: https://github.com/zsh-users/zsh-syntax-highlighting/issues/329" | |||
| fi | |||
| # Make it work. | |||
| eval "_zsh_highlight_highlighter_${(q)highlighter}_paint() { _zsh_highlight_${(q)highlighter}_highlighter \"\$@\" }" | |||
| eval "_zsh_highlight_highlighter_${(q)highlighter}_predicate() { _zsh_highlight_${(q)highlighter}_highlighter_predicate \"\$@\" }" | |||
| else | |||
| print -r -- >&2 "zsh-syntax-highlighting: ${(qq)highlighter} highlighter should define both required functions '_zsh_highlight_highlighter_${highlighter}_paint' and '_zsh_highlight_highlighter_${highlighter}_predicate' in ${(qq):-"$highlighter_dir${highlighter}-highlighter.zsh"}." | |||
| fi | |||
| done | |||
| } | |||
| # ------------------------------------------------------------------------------------------------- | |||
| # Setup | |||
| # ------------------------------------------------------------------------------------------------- | |||
| # Try binding widgets. | |||
| _zsh_highlight_bind_widgets || { | |||
| print -r -- >&2 'zsh-syntax-highlighting: failed binding ZLE widgets, exiting.' | |||
| return 1 | |||
| } | |||
| # Resolve highlighters directory location. | |||
| _zsh_highlight_load_highlighters "${ZSH_HIGHLIGHT_HIGHLIGHTERS_DIR:-${${0:A}:h}/highlighters}" || { | |||
| print -r -- >&2 'zsh-syntax-highlighting: failed loading highlighters, exiting.' | |||
| return 1 | |||
| } | |||
| # Reset scratch variables when commandline is done. | |||
| _zsh_highlight_preexec_hook() | |||
| { | |||
| typeset -g _ZSH_HIGHLIGHT_PRIOR_BUFFER= | |||
| typeset -gi _ZSH_HIGHLIGHT_PRIOR_CURSOR= | |||
| } | |||
| autoload -Uz add-zsh-hook | |||
| add-zsh-hook preexec _zsh_highlight_preexec_hook 2>/dev/null || { | |||
| print -r -- >&2 'zsh-syntax-highlighting: failed loading add-zsh-hook.' | |||
| } | |||
| # Load zsh/parameter module if available | |||
| zmodload zsh/parameter 2>/dev/null || true | |||
| # Initialize the array of active highlighters if needed. | |||
| [[ $#ZSH_HIGHLIGHT_HIGHLIGHTERS -eq 0 ]] && ZSH_HIGHLIGHT_HIGHLIGHTERS=(main) | |||
| if (( $+X_ZSH_HIGHLIGHT_DIRS_BLACKLIST )); then | |||
| print >&2 'zsh-syntax-highlighting: X_ZSH_HIGHLIGHT_DIRS_BLACKLIST is deprecated. Please use ZSH_HIGHLIGHT_DIRS_BLACKLIST.' | |||
| ZSH_HIGHLIGHT_DIRS_BLACKLIST=($X_ZSH_HIGHLIGHT_DIRS_BLACKLIST) | |||
| unset X_ZSH_HIGHLIGHT_DIRS_BLACKLIST | |||
| fi | |||
| # Restore the aliases we unned | |||
| eval "$zsh_highlight__aliases" | |||
| builtin unset zsh_highlight__aliases | |||
| # Set $?. | |||
| true | |||