The highlighted zone stay highlighted?

zsh-history-substring-search

This is a clean-room implementation of the Fish shell's history search feature, where you can type in any part of any command from history and then press chosen keys, such as the UP and DOWN arrows, to cycle through matches.

Requirements

ZSH 4.3 or newer

Install

Using the Homebrew package manager:

brew install zsh-history-substring-search
echo 'source $(brew --prefix)/share/zsh-history-substring-search/zsh-history-substring-search.zsh' >> ~/.zshrc

Using Fig:

Fig adds apps, shortcuts, and autocomplete to your existing terminal.

Install zsh-history-substring-search in just one click.

Using Oh-my-zsh:

Clone this repository in oh-my-zsh's plugins directory:

 git clone https://github.com/zsh-users/zsh-history-substring-search ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-history-substring-search

Activate the plugin in ~/.zshrc:

 plugins=( [plugins...] zsh-history-substring-search)

Run exec zsh to take changes into account:
```
 exec zsh
```

Using zplug:

Add this repo to ~/.zshrc:

 zplug "zsh-users/zsh-history-substring-search", as: plugin

Using antigen:

Add the antigen bundle command just before antigen apply, like this:

antigen bundle zsh-users/zsh-history-substring-search
antigen apply

Then, after antigen apply, add the key binding configurations, like this:

# zsh-history-substring-search configuration
bindkey '^[[A' history-substring-search-up # or '\eOA'
bindkey '^[[B' history-substring-search-down # or '\eOB'
HISTORY_SUBSTRING_SEARCH_ENSURE_UNIQUE=1

Using Zinit:

Use the Oh-my-zsh Zinit snippet in ~/.zshrc:

 zinit snippet OMZ::plugins/git/git.plugin.zsh`

Load the plugin in ~/.zshrc:

 zinit load 'zsh-users/zsh-history-substring-search
 zinit ice wait atload'_history_substring_search_config'

Run exec zsh to take changes into account:
```
 exec zsh
```

Usage

Load this script into your interactive ZSH session:
```
source zsh-history-substring-search.zsh
```
If you want to use zsh-syntax-highlighting along with this script, then make sure that you load it before you load this script:
```
source zsh-syntax-highlighting.zsh
source zsh-history-substring-search.zsh
```
Bind keyboard shortcuts to this script's functions.

Users typically bind their UP and DOWN arrow keys to this script, thus:
- Run cat -v in your favorite terminal emulator to observe key codes. (NOTE: In some cases, cat -v shows the wrong key codes. If the key codes shown by cat -v don't work for you, press <C-v><UP> and <C-v><DOWN> at your ZSH command line prompt for correct key codes.)
- Press the UP arrow key and observe what is printed in your terminal.
- Press the DOWN arrow key and observe what is printed in your terminal.
- Press the Control and C keys simultaneously to terminate the cat -v.
- Use your observations from the previous steps to create key bindings. For example, if you observed ^[[A for UP and ^[[B for DOWN, then:
```
bindkey '^[[A' history-substring-search-up
bindkey '^[[B' history-substring-search-down
```
  However, if the observed values don't work, you can try using terminfo:
```
bindkey "$terminfo[kcuu1]" history-substring-search-up
bindkey "$terminfo[kcud1]" history-substring-search-down
```
  Users have also observed that [OA and [OB are correct values, even if these were not the observed values. If you are having trouble with the observed values, give these a try.
  
  You might also want to bind the Control-P/N keys for use in EMACS mode:
```
bindkey -M emacs '^P' history-substring-search-up
bindkey -M emacs '^N' history-substring-search-down
```
  You might also want to bind the k and j keys for use in VI mode:
```
bindkey -M vicmd 'k' history-substring-search-up
bindkey -M vicmd 'j' history-substring-search-down
```
Type any part of any previous command and then:
- Press the history-substring-search-up key, which was configured in step 2 above, to select the nearest command that (1) contains your query and (2) is also older than the current command in your command history.
- Press the history-substring-search-down key, which was configured in step 2 above, to select the nearest command that (1) contains your query and (2) is also newer than the current command in your command history.
- Press ^U the Control and U keys simultaneously to abort the search.
If a matching command spans more than one line of text, press the LEFT arrow key to move the cursor away from the end of the command, and then:
- Press the history-substring-search-up key, which was configured in step 2 above, to move the cursor to the line above the cursored line. When the cursor reaches the first line of the command, pressing the history-substring-search-up key again will cause this script to perform another search.
- Press the history-substring-search-down key, which was configured in step 2 above, to move the cursor to the line below the cursored line. When the cursor reaches the last line of the command, pressing the history-substring-search-down key, which was configured in step 2 above, again will cause this script to perform another search.

Configuration

This script defines the following global variables. You may override their default values.

HISTORY_SUBSTRING_SEARCH_HIGHLIGHT_FOUND is a global variable that defines how the query should be highlighted inside a matching command. Its default value causes this script to highlight using bold, white text on a magenta background. See the "Character Highlighting" section in the zshzle(1) man page to learn about the kinds of values you may assign to this variable.
HISTORY_SUBSTRING_SEARCH_HIGHLIGHT_NOT_FOUND is a global variable that defines how the query should be highlighted when no commands in the history match it. Its default value causes this script to highlight using bold, white text on a red background. See the "Character Highlighting" section in the zshzle(1) man page to learn about the kinds of values you may assign to this variable.
HISTORY_SUBSTRING_SEARCH_GLOBBING_FLAGS is a global variable that defines how the command history will be searched for your query. Its default value causes this script to perform a case-insensitive search. See the "Globbing Flags" section in the zshexpn(1) man page to learn about the kinds of values you may assign to this variable.
HISTORY_SUBSTRING_SEARCH_FUZZY is a global variable that defines how the command history will be searched for your query. If set to a non-empty value, causes this script to perform a fuzzy search by words, matching in given order e.g. ab c will match *ab*c*
HISTORY_SUBSTRING_SEARCH_PREFIXED is a global variable that defines how the command history will be searched for your query. If set to a non-empty value, your query will be matched against the start of each history entry. For example, if this variable is empty, ls will match ls -l and echo ls; if it is non-empty, ls will only match ls -l.
HISTORY_SUBSTRING_SEARCH_ENSURE_UNIQUE is a global variable that defines whether all search results returned are unique. If set to a non-empty value, then only unique search results are presented. This behaviour is off by default. An alternative way to ensure that search results are unique is to use setopt HIST_IGNORE_ALL_DUPS. If this configuration variable is off and setopt HIST_IGNORE_ALL_DUPS is unset, then setopt HIST_FIND_NO_DUPS is still respected and it makes this script skip duplicate adjacent search results as you cycle through them, but this does not guarantee that search results are unique: if your search results were "Dog", "Dog", "HotDog", "Dog", then cycling them gives "Dog", "HotDog", "Dog". Notice that the "Dog" search result appeared twice as you cycled through them. If you wish to receive globally unique search results only once, then use this configuration variable, or use setopt HIST_IGNORE_ALL_DUPS.
HISTORY_SUBSTRING_SEARCH_HIGHLIGHT_TIMEOUT is a global variable that defines a timeout in seconds for clearing the search highlight.

History

September 2009: Peter Stephenson originally wrote this script and it published to the zsh-users mailing list.
January 2011: Guido van Steen (@guidovansteen) revised this script and released it under the 3-clause BSD license as part of fizsh, the Friendly Interactive ZSHell.
January 2011: Suraj N. Kurapati (@sunaku) extracted this script from fizsh 1.0.1, refactored it heavily, and finally repackaged it as an oh-my-zsh plugin and as an independently loadable ZSH script.
July 2011: Guido van Steen, Suraj N. Kurapati, and Sorin Ionescu (@sorin-ionescu) further developed it with Vincent Guerci (@vguerci).
March 2016: Geza Lore (@gezalore) greatly refactored it in pull request #55.

	if [[ $+functions[_zsh_highlight] -eq 0 ]]; then
	#
	# Dummy implementation of _zsh_highlight() that
	# simply removes any existing highlights when the
	# user inserts printable characters into $BUFFER.
	#
	_zsh_highlight() {
	if [[ $KEYS == [[:print:]] ]]; then
	region_highlight=()
	fi
	}

	#
	# The following snippet was taken from the zsh-syntax-highlighting project:
	#
	# https://github.com/zsh-users/zsh-syntax-highlighting/blob/56b134f5d62ae3d4e66c7f52bd0cc2595f9b305b/zsh-syntax-highlighting.zsh#L126-161
	#
	# Copyright (c) 2010-2011 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.
	#
	#--------------8<-------------------8<-------------------8<-----------------
	# Rebind all ZLE widgets to make them invoke _zsh_highlights.
	_zsh_highlight_bind_widgets()
	{
	# Load ZSH module zsh/zleparameter, needed to override user defined widgets.
	zmodload zsh/zleparameter 2>/dev/null \|\| {
	echo 'zsh-syntax-highlighting: failed loading zsh/zleparameter.' >&2
	return 1
	}

	# Override ZLE widgets to make them invoke _zsh_highlight.
	local cur_widget
	for cur_widget in ${${(f)"$(builtin zle -la)"}:#(.\|_\|orig-\|run-help\|which-command\|beep\|yank)}; do
	case $widgets[$cur_widget] in

	# Already rebound event: do nothing.
	user:$cur_widget\|user:_zsh_highlight_widget_*);;

	# User defined widget: override and rebind old one with prefix "orig-".
	user:) eval "zle -N orig-$cur_widget ${widgets[$cur_widget]#:}; \
	_zsh_highlight_widget_$cur_widget() { builtin zle orig-$cur_widget -- \"\$@\" && _zsh_highlight }; \
	zle -N $cur_widget _zsh_highlight_widget_$cur_widget";;

	# Completion widget: override and rebind old one with prefix "orig-".
	completion:) eval "zle -C orig-$cur_widget ${${widgets[$cur_widget]#:}/:/ }; \
	_zsh_highlight_widget_$cur_widget() { builtin zle orig-$cur_widget -- \"\$@\" && _zsh_highlight }; \
	zle -N $cur_widget _zsh_highlight_widget_$cur_widget";;

	# Builtin widget: override and make it call the builtin ".widget".
	builtin) eval "_zsh_highlight_widget_$cur_widget() { builtin zle .$cur_widget -- \"\$@\" && _zsh_highlight }; \
	zle -N $cur_widget _zsh_highlight_widget_$cur_widget";;

	# Default: unhandled case.
	*) echo "zsh-syntax-highlighting: unhandled ZLE widget '$cur_widget'" >&2 ;;
	esac
	done
	}
	#-------------->8------------------->8------------------->8-----------------

	_zsh_highlight_bind_widgets
	fi

zsh-users / zsh-history-substring-search Goto Github PK

zsh-history-substring-search's Introduction

zsh-history-substring-search

Requirements

Install

Usage

Configuration

History

zsh-history-substring-search's People

Stargazers

Watchers

Forkers

zsh-history-substring-search's Issues

Recommend Projects

Recommend Topics

Recommend Org