mirror of
https://github.com/zsh-users/zsh-autosuggestions.git
synced 2025-12-06 15:20:40 +01:00
Compare commits
21 Commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
9d100f4f32 | ||
|
|
ddb7284852 | ||
|
|
2a5791710a | ||
|
|
03fac1f0d7 | ||
|
|
aa859a282d | ||
|
|
f08a5a1baa | ||
|
|
70438d233d | ||
|
|
ba029e83d0 | ||
|
|
acc129de6c | ||
|
|
aa5ceee256 | ||
|
|
113ca0ad10 | ||
|
|
2b449a62f8 | ||
|
|
6d25df6864 | ||
|
|
0faa2b6584 | ||
|
|
a2d8d91196 | ||
|
|
dd9a8789a7 | ||
|
|
1b98af5b33 | ||
|
|
45ab49d1f2 | ||
|
|
41f15d5c9f | ||
|
|
3ce1adb55d | ||
|
|
2461a98857 |
24
README.md
24
README.md
@@ -4,6 +4,7 @@ _[Fish](http://fishshell.com/)-like fast/unobtrusive autosuggestions for zsh._
|
|||||||
|
|
||||||
It suggests commands as you type, based on command history.
|
It suggests commands as you type, based on command history.
|
||||||
|
|
||||||
|
<a href="https://asciinema.org/a/36578" target="_blank"><img src="https://asciinema.org/a/36578.png" width="520"/></a>
|
||||||
|
|
||||||
## Installation
|
## Installation
|
||||||
|
|
||||||
@@ -40,8 +41,6 @@ It suggests commands as you type, based on command history.
|
|||||||
|
|
||||||
3. Start a new terminal session.
|
3. Start a new terminal session.
|
||||||
|
|
||||||
**Note:** There is an open issue ([#102](https://github.com/tarruda/zsh-autosuggestions/issues/102)) when using this plugin with `bracketed-paste-magic`, which is enabled by default by Oh My Zsh. See the comments in that issue for a workaround.
|
|
||||||
|
|
||||||
|
|
||||||
## Usage
|
## Usage
|
||||||
|
|
||||||
@@ -95,32 +94,13 @@ bindkey '^ ' autosuggest-accept
|
|||||||
|
|
||||||
### [`zsh-history-substring-search`](https://github.com/zsh-users/zsh-history-substring-search)
|
### [`zsh-history-substring-search`](https://github.com/zsh-users/zsh-history-substring-search)
|
||||||
|
|
||||||
When the buffer is empty and one of the `history-substring-search-up/down` widgets is invoked, it will call the `up/down-line-or-history` widget. If the `up/down-line-or-history` widgets are in `ZSH_AUTOSUGGEST_CLEAR_WIDGETS` (the list of widgets that clear the suggestion), this can create an infinite recursion, crashing the shell session.
|
The `history-substring-search-up` and `history-substring-search-down` widgets are not bound by default. You'll probably want to add them to `ZSH_AUTOSUGGEST_CLEAR_WIDGETS` so that the suggestion will be cleared when you start searching through history:
|
||||||
|
|
||||||
For best results, you'll want to remove `up-line-or-history` and `down-line-or-history` from `ZSH_AUTOSUGGEST_CLEAR_WIDGETS`:
|
|
||||||
|
|
||||||
```
|
|
||||||
# Remove *-line-or-history widgets from list of widgets that clear the autosuggestion to avoid conflict with history-substring-search-* widgets
|
|
||||||
ZSH_AUTOSUGGEST_CLEAR_WIDGETS=("${(@)ZSH_AUTOSUGGEST_CLEAR_WIDGETS:#(up|down)-line-or-history}")
|
|
||||||
```
|
|
||||||
|
|
||||||
Additionally, the `history-substring-search-up` and `history-substring-search-down` widgets are not bound by default. You'll probably want to add them to `ZSH_AUTOSUGGEST_CLEAR_WIDGETS` so that the suggestion will be cleared when you start searching through history:
|
|
||||||
|
|
||||||
```sh
|
```sh
|
||||||
# Add history-substring-search-* widgets to list of widgets that clear the autosuggestion
|
# Add history-substring-search-* widgets to list of widgets that clear the autosuggestion
|
||||||
ZSH_AUTOSUGGEST_CLEAR_WIDGETS+=(history-substring-search-up history-substring-search-down)
|
ZSH_AUTOSUGGEST_CLEAR_WIDGETS+=(history-substring-search-up history-substring-search-down)
|
||||||
```
|
```
|
||||||
|
|
||||||
For example:
|
|
||||||
|
|
||||||
```sh
|
|
||||||
source ~/.zsh/zsh-autosuggestions/zsh-autosuggestions.zsh
|
|
||||||
source ~/Code/zsh-history-substring-search/zsh-history-substring-search.zsh
|
|
||||||
|
|
||||||
ZSH_AUTOSUGGEST_CLEAR_WIDGETS=("${(@)ZSH_AUTOSUGGEST_CLEAR_WIDGETS:#(up|down)-line-or-history}")
|
|
||||||
ZSH_AUTOSUGGEST_CLEAR_WIDGETS+=(history-substring-search-up history-substring-search-down)
|
|
||||||
```
|
|
||||||
|
|
||||||
|
|
||||||
## Troubleshooting
|
## Troubleshooting
|
||||||
|
|
||||||
|
|||||||
@@ -85,7 +85,7 @@ testWidgetFunctionClear() {
|
|||||||
BUFFER="ec"
|
BUFFER="ec"
|
||||||
POSTDISPLAY="ho hello"
|
POSTDISPLAY="ho hello"
|
||||||
|
|
||||||
_zsh_autosuggest_clear
|
_zsh_autosuggest_clear "original-widget"
|
||||||
|
|
||||||
assertEquals \
|
assertEquals \
|
||||||
"BUFFER was modified" \
|
"BUFFER was modified" \
|
||||||
@@ -109,7 +109,7 @@ testWidgetFunctionModify() {
|
|||||||
_zsh_autosuggest_suggestion \
|
_zsh_autosuggest_suggestion \
|
||||||
"echo hello"
|
"echo hello"
|
||||||
|
|
||||||
_zsh_autosuggest_modify
|
_zsh_autosuggest_modify "original-widget"
|
||||||
|
|
||||||
assertTrue \
|
assertTrue \
|
||||||
"original widget not invoked" \
|
"original widget not invoked" \
|
||||||
@@ -136,7 +136,7 @@ testWidgetFunctionAcceptCursorAtEnd() {
|
|||||||
|
|
||||||
stub _zsh_autosuggest_invoke_original_widget
|
stub _zsh_autosuggest_invoke_original_widget
|
||||||
|
|
||||||
_zsh_autosuggest_accept
|
_zsh_autosuggest_accept "original-widget"
|
||||||
|
|
||||||
assertTrue \
|
assertTrue \
|
||||||
"original widget not invoked" \
|
"original widget not invoked" \
|
||||||
@@ -160,7 +160,7 @@ testWidgetFunctionAcceptCursorNotAtEnd() {
|
|||||||
|
|
||||||
stub _zsh_autosuggest_invoke_original_widget
|
stub _zsh_autosuggest_invoke_original_widget
|
||||||
|
|
||||||
_zsh_autosuggest_accept
|
_zsh_autosuggest_accept "original-widget"
|
||||||
|
|
||||||
assertTrue \
|
assertTrue \
|
||||||
"original widget not invoked" \
|
"original widget not invoked" \
|
||||||
@@ -186,7 +186,7 @@ testWidgetFunctionPartialAcceptCursorMovesOutOfBuffer() {
|
|||||||
_zsh_autosuggest_invoke_original_widget \
|
_zsh_autosuggest_invoke_original_widget \
|
||||||
'CURSOR=5; LBUFFER="echo "; RBUFFER="hello"'
|
'CURSOR=5; LBUFFER="echo "; RBUFFER="hello"'
|
||||||
|
|
||||||
_zsh_autosuggest_partial_accept
|
_zsh_autosuggest_partial_accept "original-widget"
|
||||||
|
|
||||||
assertTrue \
|
assertTrue \
|
||||||
"original widget not invoked" \
|
"original widget not invoked" \
|
||||||
@@ -212,7 +212,7 @@ testWidgetFunctionPartialAcceptCursorStaysInBuffer() {
|
|||||||
_zsh_autosuggest_invoke_original_widget \
|
_zsh_autosuggest_invoke_original_widget \
|
||||||
'CURSOR=5; LBUFFER="echo "; RBUFFER="hello"'
|
'CURSOR=5; LBUFFER="echo "; RBUFFER="hello"'
|
||||||
|
|
||||||
_zsh_autosuggest_partial_accept
|
_zsh_autosuggest_partial_accept "original-widget"
|
||||||
|
|
||||||
assertTrue \
|
assertTrue \
|
||||||
"original widget not invoked" \
|
"original widget not invoked" \
|
||||||
@@ -236,7 +236,7 @@ testWidgetAccept() {
|
|||||||
|
|
||||||
# Call the function pointed to by the widget since we can't call
|
# Call the function pointed to by the widget since we can't call
|
||||||
# the widget itself when zle is not active
|
# the widget itself when zle is not active
|
||||||
${widgets[autosuggest-accept]#*:}
|
${widgets[autosuggest-accept]#*:} "original-widget"
|
||||||
|
|
||||||
assertTrue \
|
assertTrue \
|
||||||
"autosuggest-accept widget does not exist" \
|
"autosuggest-accept widget does not exist" \
|
||||||
@@ -262,7 +262,7 @@ testWidgetClear() {
|
|||||||
|
|
||||||
# Call the function pointed to by the widget since we can't call
|
# Call the function pointed to by the widget since we can't call
|
||||||
# the widget itself when zle is not active
|
# the widget itself when zle is not active
|
||||||
${widgets[autosuggest-clear]#*:}
|
${widgets[autosuggest-clear]#*:} "original-widget"
|
||||||
|
|
||||||
assertTrue \
|
assertTrue \
|
||||||
"autosuggest-clear widget does not exist" \
|
"autosuggest-clear widget does not exist" \
|
||||||
@@ -281,6 +281,43 @@ testWidgetClear() {
|
|||||||
"stub_called _zsh_autosuggest_highlight_apply"
|
"stub_called _zsh_autosuggest_highlight_apply"
|
||||||
}
|
}
|
||||||
|
|
||||||
|
testEscapeCommandPrefix() {
|
||||||
|
assertEquals \
|
||||||
|
"Did not escape single backslash" \
|
||||||
|
"\\\\" \
|
||||||
|
"$(_zsh_autosuggest_escape_command_prefix "\\")"
|
||||||
|
|
||||||
|
assertEquals \
|
||||||
|
"Did not escape two backslashes" \
|
||||||
|
"\\\\\\\\" \
|
||||||
|
"$(_zsh_autosuggest_escape_command_prefix "\\\\")"
|
||||||
|
|
||||||
|
assertEquals \
|
||||||
|
"Did not escape parentheses" \
|
||||||
|
"\\(\\)" \
|
||||||
|
"$(_zsh_autosuggest_escape_command_prefix "()")"
|
||||||
|
|
||||||
|
assertEquals \
|
||||||
|
"Did not escape square brackets" \
|
||||||
|
"\\[\\]" \
|
||||||
|
"$(_zsh_autosuggest_escape_command_prefix "[]")"
|
||||||
|
|
||||||
|
assertEquals \
|
||||||
|
"Did not escape pipe" \
|
||||||
|
"\\|" \
|
||||||
|
"$(_zsh_autosuggest_escape_command_prefix "|")"
|
||||||
|
|
||||||
|
assertEquals \
|
||||||
|
"Did not escape star" \
|
||||||
|
"\\*" \
|
||||||
|
"$(_zsh_autosuggest_escape_command_prefix "*")"
|
||||||
|
|
||||||
|
assertEquals \
|
||||||
|
"Did not escape question mark" \
|
||||||
|
"\\?" \
|
||||||
|
"$(_zsh_autosuggest_escape_command_prefix "?")"
|
||||||
|
}
|
||||||
|
|
||||||
# For zsh compatibility
|
# For zsh compatibility
|
||||||
setopt shwordsplit
|
setopt shwordsplit
|
||||||
SHUNIT_PARENT=$0
|
SHUNIT_PARENT=$0
|
||||||
|
|||||||
23
src/bind.zsh
23
src/bind.zsh
@@ -12,7 +12,7 @@ _zsh_autosuggest_bind_widget() {
|
|||||||
# Save a reference to the original widget
|
# Save a reference to the original widget
|
||||||
case $widgets[$widget] in
|
case $widgets[$widget] in
|
||||||
# Already bound
|
# Already bound
|
||||||
user:_zsh_autosuggest_(widget|orig)_*);;
|
user:_zsh_autosuggest_(bound|orig)_*);;
|
||||||
|
|
||||||
# User-defined widget
|
# User-defined widget
|
||||||
user:*)
|
user:*)
|
||||||
@@ -31,8 +31,18 @@ _zsh_autosuggest_bind_widget() {
|
|||||||
;;
|
;;
|
||||||
esac
|
esac
|
||||||
|
|
||||||
|
# Pass the original widget's name explicitly into the autosuggest
|
||||||
|
# function. Use this passed in widget name to call the original
|
||||||
|
# widget instead of relying on the $WIDGET variable being set
|
||||||
|
# correctly. $WIDGET cannot be trusted because other plugins call
|
||||||
|
# zle without the `-w` flag (e.g. `zle self-insert` instead of
|
||||||
|
# `zle self-insert -w`).
|
||||||
|
eval "_zsh_autosuggest_bound_$widget() {
|
||||||
|
_zsh_autosuggest_widget_$autosuggest_action $prefix$widget \$@
|
||||||
|
}"
|
||||||
|
|
||||||
# Create the bound widget
|
# Create the bound widget
|
||||||
zle -N $widget _zsh_autosuggest_widget_$autosuggest_action
|
zle -N $widget _zsh_autosuggest_bound_$widget
|
||||||
}
|
}
|
||||||
|
|
||||||
# Map all configured widgets to the right autosuggest widgets
|
# Map all configured widgets to the right autosuggest widgets
|
||||||
@@ -54,9 +64,14 @@ _zsh_autosuggest_bind_widgets() {
|
|||||||
done
|
done
|
||||||
}
|
}
|
||||||
|
|
||||||
# Given the name of a widget, invoke the original we saved, if it exists
|
# Given the name of an original widget and args, invoke it, if it exists
|
||||||
_zsh_autosuggest_invoke_original_widget() {
|
_zsh_autosuggest_invoke_original_widget() {
|
||||||
local original_widget_name="$ZSH_AUTOSUGGEST_ORIGINAL_WIDGET_PREFIX$WIDGET"
|
# Do nothing unless called with at least one arg
|
||||||
|
[ $# -gt 0 ] || return
|
||||||
|
|
||||||
|
local original_widget_name=$1
|
||||||
|
|
||||||
|
shift
|
||||||
|
|
||||||
if [ $widgets[$original_widget_name] ]; then
|
if [ $widgets[$original_widget_name] ]; then
|
||||||
zle $original_widget_name -- $@
|
zle $original_widget_name -- $@
|
||||||
|
|||||||
@@ -5,15 +5,19 @@
|
|||||||
|
|
||||||
# Get a suggestion from history that matches a given prefix
|
# Get a suggestion from history that matches a given prefix
|
||||||
_zsh_autosuggest_suggestion() {
|
_zsh_autosuggest_suggestion() {
|
||||||
setopt localoptions extendedglob
|
local prefix=$(_zsh_autosuggest_escape_command_prefix "$1")
|
||||||
|
|
||||||
# Escape the prefix (requires EXTENDED_GLOB)
|
|
||||||
local prefix=${1//(#m)[\][()|\\*?#<>~^]/\\$MATCH}
|
|
||||||
|
|
||||||
# Get all history items (reversed) that match pattern $prefix*
|
# Get all history items (reversed) that match pattern $prefix*
|
||||||
local history_matches
|
local history_matches
|
||||||
history_matches=(${history[(R)$prefix*]})
|
history_matches=(${(j:\0:s:\0:)history[(R)$prefix*]})
|
||||||
|
|
||||||
# Echo the first item that matches
|
# Echo the first item that matches
|
||||||
echo ${history_matches[1]}
|
echo -E "$history_matches[1]"
|
||||||
|
}
|
||||||
|
|
||||||
|
_zsh_autosuggest_escape_command_prefix() {
|
||||||
|
setopt localoptions EXTENDED_GLOB
|
||||||
|
|
||||||
|
# Escape special chars in the string (requires EXTENDED_GLOB)
|
||||||
|
echo -E "${1//(#m)[\\()\[\]|*?]/\\$MATCH}"
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -19,7 +19,7 @@ _zsh_autosuggest_modify() {
|
|||||||
# Get a new suggestion if the buffer is not empty after modification
|
# Get a new suggestion if the buffer is not empty after modification
|
||||||
local suggestion
|
local suggestion
|
||||||
if [ $#BUFFER -gt 0 ]; then
|
if [ $#BUFFER -gt 0 ]; then
|
||||||
suggestion=$(_zsh_autosuggest_suggestion $BUFFER)
|
suggestion=$(_zsh_autosuggest_suggestion "$BUFFER")
|
||||||
fi
|
fi
|
||||||
|
|
||||||
# Add the suggestion to the POSTDISPLAY
|
# Add the suggestion to the POSTDISPLAY
|
||||||
|
|||||||
@@ -1,6 +1,6 @@
|
|||||||
# Fish-like fast/unobtrusive autosuggestions for zsh.
|
# Fish-like fast/unobtrusive autosuggestions for zsh.
|
||||||
# https://github.com/tarruda/zsh-autosuggestions
|
# https://github.com/tarruda/zsh-autosuggestions
|
||||||
# v0.2.5
|
# v0.2.14
|
||||||
# Copyright (c) 2013 Thiago de Arruda
|
# Copyright (c) 2013 Thiago de Arruda
|
||||||
# Copyright (c) 2016 Eric Freese
|
# Copyright (c) 2016 Eric Freese
|
||||||
#
|
#
|
||||||
@@ -114,7 +114,7 @@ _zsh_autosuggest_bind_widget() {
|
|||||||
# Save a reference to the original widget
|
# Save a reference to the original widget
|
||||||
case $widgets[$widget] in
|
case $widgets[$widget] in
|
||||||
# Already bound
|
# Already bound
|
||||||
user:_zsh_autosuggest_(widget|orig)_*);;
|
user:_zsh_autosuggest_(bound|orig)_*);;
|
||||||
|
|
||||||
# User-defined widget
|
# User-defined widget
|
||||||
user:*)
|
user:*)
|
||||||
@@ -133,8 +133,18 @@ _zsh_autosuggest_bind_widget() {
|
|||||||
;;
|
;;
|
||||||
esac
|
esac
|
||||||
|
|
||||||
|
# Pass the original widget's name explicitly into the autosuggest
|
||||||
|
# function. Use this passed in widget name to call the original
|
||||||
|
# widget instead of relying on the $WIDGET variable being set
|
||||||
|
# correctly. $WIDGET cannot be trusted because other plugins call
|
||||||
|
# zle without the `-w` flag (e.g. `zle self-insert` instead of
|
||||||
|
# `zle self-insert -w`).
|
||||||
|
eval "_zsh_autosuggest_bound_$widget() {
|
||||||
|
_zsh_autosuggest_widget_$autosuggest_action $prefix$widget \$@
|
||||||
|
}"
|
||||||
|
|
||||||
# Create the bound widget
|
# Create the bound widget
|
||||||
zle -N $widget _zsh_autosuggest_widget_$autosuggest_action
|
zle -N $widget _zsh_autosuggest_bound_$widget
|
||||||
}
|
}
|
||||||
|
|
||||||
# Map all configured widgets to the right autosuggest widgets
|
# Map all configured widgets to the right autosuggest widgets
|
||||||
@@ -156,9 +166,14 @@ _zsh_autosuggest_bind_widgets() {
|
|||||||
done
|
done
|
||||||
}
|
}
|
||||||
|
|
||||||
# Given the name of a widget, invoke the original we saved, if it exists
|
# Given the name of an original widget and args, invoke it, if it exists
|
||||||
_zsh_autosuggest_invoke_original_widget() {
|
_zsh_autosuggest_invoke_original_widget() {
|
||||||
local original_widget_name="$ZSH_AUTOSUGGEST_ORIGINAL_WIDGET_PREFIX$WIDGET"
|
# Do nothing unless called with at least one arg
|
||||||
|
[ $# -gt 0 ] || return
|
||||||
|
|
||||||
|
local original_widget_name=$1
|
||||||
|
|
||||||
|
shift
|
||||||
|
|
||||||
if [ $widgets[$original_widget_name] ]; then
|
if [ $widgets[$original_widget_name] ]; then
|
||||||
zle $original_widget_name -- $@
|
zle $original_widget_name -- $@
|
||||||
@@ -207,7 +222,7 @@ _zsh_autosuggest_modify() {
|
|||||||
# Get a new suggestion if the buffer is not empty after modification
|
# Get a new suggestion if the buffer is not empty after modification
|
||||||
local suggestion
|
local suggestion
|
||||||
if [ $#BUFFER -gt 0 ]; then
|
if [ $#BUFFER -gt 0 ]; then
|
||||||
suggestion=$(_zsh_autosuggest_suggestion $BUFFER)
|
suggestion=$(_zsh_autosuggest_suggestion "$BUFFER")
|
||||||
fi
|
fi
|
||||||
|
|
||||||
# Add the suggestion to the POSTDISPLAY
|
# Add the suggestion to the POSTDISPLAY
|
||||||
@@ -276,17 +291,21 @@ zle -N autosuggest-clear _zsh_autosuggest_widget_clear
|
|||||||
|
|
||||||
# Get a suggestion from history that matches a given prefix
|
# Get a suggestion from history that matches a given prefix
|
||||||
_zsh_autosuggest_suggestion() {
|
_zsh_autosuggest_suggestion() {
|
||||||
setopt localoptions extendedglob
|
local prefix=$(_zsh_autosuggest_escape_command_prefix "$1")
|
||||||
|
|
||||||
# Escape the prefix (requires EXTENDED_GLOB)
|
|
||||||
local prefix=${1//(#m)[\][()|\\*?#<>~^]/\\$MATCH}
|
|
||||||
|
|
||||||
# Get all history items (reversed) that match pattern $prefix*
|
# Get all history items (reversed) that match pattern $prefix*
|
||||||
local history_matches
|
local history_matches
|
||||||
history_matches=(${history[(R)$prefix*]})
|
history_matches=(${(j:\0:s:\0:)history[(R)$prefix*]})
|
||||||
|
|
||||||
# Echo the first item that matches
|
# Echo the first item that matches
|
||||||
echo ${history_matches[1]}
|
echo -E "$history_matches[1]"
|
||||||
|
}
|
||||||
|
|
||||||
|
_zsh_autosuggest_escape_command_prefix() {
|
||||||
|
setopt localoptions EXTENDED_GLOB
|
||||||
|
|
||||||
|
# Escape special chars in the string (requires EXTENDED_GLOB)
|
||||||
|
echo -E "${1//(#m)[\\()\[\]|*?]/\\$MATCH}"
|
||||||
}
|
}
|
||||||
|
|
||||||
#--------------------------------------------------------------------#
|
#--------------------------------------------------------------------#
|
||||||
|
|||||||
Reference in New Issue
Block a user