Mirrors/history-search-multi-word
2
0
Fork 0
mirror of https://github.com/zdharma-continuum/history-search-multi-word synced 2024-11-24 20:33:04 +00:00
Code Issues Projects Releases Packages Wiki Activity
No description
172 commits 1 branch 0 tags 316 KiB
Shell 100%
Find a file
Sebastian Gniazdowski 5febb0340f *highlight: Optimization: *-type to not guard cache with ifs; compress 
parse.zsh -oo, after changes:

Running time: 1.6934050000
num  calls                time                       self            name
-----------------------------------------------------------------------------------
 1)  350        1685,89     4,82   99,99%   1225,79     3,50   72,70%  -hsmw-highlight-process
 2) 2800         336,76     0,12   19,97%    336,76     0,12   19,97%  -hsmw-highlight-string
 3) 2450          80,37     0,03    4,77%     80,37     0,03    4,77%  -hsmw-highlight-check-path
 4) 1400          25,65     0,02    1,52%     25,65     0,02    1,52%  -hsmw-highlight-main-type
 5)  350           9,80     0,03    0,58%      9,80     0,03    0,58%  -hsmw-highlight-stack-pop
 6)  350           7,52     0,02    0,45%      7,52     0,02    0,45%  -hsmw-highlight-path-separators
 7)    1           0,09     0,09    0,01%      0,09     0,09    0,01%  -hsmw-highlight-fill-option-variables
 8)    1           0,01     0,01    0,00%      0,01     0,01    0,00%  -hsmw-highlight-init
2016-10-25 18:49:53 +02:00
test *highlight: Optimization – save options outside main highlighting fun 2016-10-25 16:17:39 +02:00
history-search-multi-word *highlight: Optimization – save options outside main highlighting fun 2016-10-25 16:17:39 +02:00
history-search-multi-word.plugin.zsh Immediate commit after obtaining first working highlighting 2016-10-09 09:24:03 +02:00
hsmw-highlight *highlight: Optimization: *-type to not guard cache with ifs; compress 2016-10-25 18:49:53 +02:00
LICENSE New license 2016-08-31 17:09:24 +02:00
README.md Updated README.md 2016-10-24 10:08:55 +02:00

README.md

Introduction

Binds Ctrl-R to a widget that searches for multiple keywords in AND fashion. In other words, you can enter multiple words, and history entries that match all of them will be found. The entries are syntax highlighted.

Video – view on asciinema. You can resize the video by pressing Ctrl-+ or Cmd-+.

asciicast

HSMW is FAST – highlighting 20 concurrent complex history entries does not cause real slow down:

asciicast

News

  • 24-10-2016

    • Workaround for Zsh versions like 5.0.2 has been added – Ctrl-V and ESC cancel search. On such Zsh versions Ctrl-C might not work. Fully problem-free Zsh version will be the upcoming 5.3, where I have together with Zsh Hackers fully fixed the Ctrl-C issue.

  • 22-10-2016

    • Search process has been optimized by 20%! History sizes like 100000 are now supported.
    • Active history entry can be underline, standout (i.e. inverse video), bold, bg=blue, etc. with the new Zstyle :plugin:history-search-multi-word / active (see Zstyles section) – video.

  • 16-10-2016

    • More optimizations of syntax highlighting (40% in total for the two days) – new video above.

  • 15-10-2016

    • The compact, already optimized (by me) zsh-syntax-highlighting part has been further optimized by 21%! Also, more tokens are highlighted – variable expressions like "${(@)var[1,3]}" (when quoted).

  • 11-10-2016

    • Syntax highlighting of history – adapted, fine crafted, small part of zsh-syntax-highlighting to color what hsmw shows:

      syntax highlighting

  • 20-09-2016

    • Keys Page Up and Page Down work and page-wise move along history. Also, Ctrl-P, Ctrl-N move to previous and next entries.

  • 19-09-2016

  • 25-05-2016

    • Cooperation with zsh-autosuggestions plugin

    • Configuration option to set page size, example use:

      zstyle ":history-search-multi-word" page-size "5"

Installation

The plugin is "standalone", which means that only sourcing it is needed. So to install, unpack history-search-multi-word somewhere and add

source {where-hsmw-is}/history-search-multi-word.plugin.zsh

to zshrc.

If using a plugin manager, then Zplugin is recommended, but you can use any other too, and also install with Oh My Zsh (by copying directory to ~/.oh-my-zsh/custom/plugins).

Zplugin

Add zplugin load psprint/history-search-multi-word to your .zshrc file. Zplugin will handle cloning the plugin for you automatically the next time you start zsh.

Antigen

Add antigen bundle psprint/history-search-multi-word to your .zshrc file. Antigen will handle cloning the plugin for you automatically the next time you start zsh. You can also add the plugin to a running zsh with antigen bundle psprint/history-search-multi-word for testing before adding it to your .zshrc.

Oh-My-Zsh

  1. cd ~/.oh-my-zsh/custom/plugins
  2. git clone git@github.com:psprint/history-search-multi-word.git
  3. Add history-search-multi-word to your plugin list

Zgen

Add zgen load psprint/history-search-multi-word to your .zshrc file in the same place you're doing your other zgen load calls in.

Customizing

Zstyles

zstyle ":history-search-multi-word" page-size "8"                      # Number of entries to show, default is LINES/3
zstyle ":history-search-multi-word" highlight-color "fg=yellow,bold"   # Color in which to highlight matched, searched text
zstyle ":plugin:history-search-multi-word" synhl "yes"                 # Whether to perform syntax highlighting
zstyle ":plugin:history-search-multi-word" active "underline"          # Effect on active history entry. Try: standout, bold, bg=blue

Syntax highlighting

Syntax highlighting is customized via HSMW_HIGHLIGHT_STYLES associative array. It has keys like reserved-word, alias, command, path, which are assigned with strings like fg=blue,bold, to configure how given elements are to be colored. If you assign this array before loading hsmw you will change the defaults. Complete list of available keys is at the beginning of hsmw-highlight file. Example ~/.zshrc addition that sets path key – paths that exist will be highlighted with background magenta, foreground white, bold:

typeset -gA HSMW_HIGHLIGHT_STYLES
HSMW_HIGHLIGHT_STYLES[path]="bg=magenta,fg=white,bold"

Following code will enable coloring of options of form "-o" and "--option", with cyan:

typeset -gA HSMW_HIGHLIGHT_STYLES
HSMW_HIGHLIGHT_STYLES[single-hyphen-option]="fg=cyan"
HSMW_HIGHLIGHT_STYLES[double-hyphen-option]="fg=cyan"

Following code will use 256 colors to highlight command separators (like ";" or "&&"):

HSMW_HIGHLIGHT_STYLES[commandseparator]="fg=241,bg=17"

IRC Channel

Channel #zplugin@freenode is a support place for all author's projects. Connect to: chat.freenode.net:6697 (SSL) or chat.freenode.net:6667 and join #zplugin.

Following is a quick access via Webchat IRC