Percol Plugin

percol

Maintainer: @robturtle

It provides two functionalities that allows you search history and resume background jobs with interactively incremental searching utility powered by percol.

Usage

1. Use Ctrl-R to search the history.

   

2. User Ctrl-H to search aliases

   

3. Use Ctrl-T to switch to another git branch

4. Use Ctrl-Q to resume background jobs.

   

Installation

0. Install percol by running the following:

   pip install percol

1. Clone the repository into your custom folder. Assuming your custom folder is at ~/.oh-my-zsh/custom

  mkdir -p ~/.oh-my-zsh/custom/plugins
  git clone https://github.com/robturtle/percol.plugin.zsh.git ~/.oh-my-zsh/custom/plugins/percol

2. Enable the plugin by adding it to your plugins definition in ~/.zshrc.

  plugins=(percol)

3. Enable Emacs-like keyboard shortcuts

  mkdir -p ~/.percol.d
  touch ~/.percol.d/rc.py

And copy-paste the contents into ~/.percol.d/rc.py.

  # file: ~/.percol.d/rc.py
  # Emacs like
  percol.import_keymap({
      "C-h" : lambda percol: percol.command.delete_backward_char(),
      "C-d" : lambda percol: percol.command.delete_forward_char(),
      "C-k" : lambda percol: percol.command.kill_end_of_line(),
      "C-y" : lambda percol: percol.command.yank(),
      "C-t" : lambda percol: percol.command.transpose_chars(),
      "C-a" : lambda percol: percol.command.beginning_of_line(),
      "C-e" : lambda percol: percol.command.end_of_line(),
      "C-b" : lambda percol: percol.command.backward_char(),
      "C-f" : lambda percol: percol.command.forward_char(),
      "M-f" : lambda percol: percol.command.forward_word(),
      "M-b" : lambda percol: percol.command.backward_word(),
      "M-d" : lambda percol: percol.command.delete_forward_word(),
      "M-h" : lambda percol: percol.command.delete_backward_word(),
      "C-n" : lambda percol: percol.command.select_next(),
      "C-p" : lambda percol: percol.command.select_previous(),
      "C-v" : lambda percol: percol.command.select_next_page(),
      "M-v" : lambda percol: percol.command.select_previous_page(),
      "M-<" : lambda percol: percol.command.select_top(),
      "M->" : lambda percol: percol.command.select_bottom(),
      "C-m" : lambda percol: percol.finish(),
      "C-j" : lambda percol: percol.finish(),
      "C-g" : lambda percol: percol.cancel(),
  })

Upgrade

cd ~/.oh-my-zsh/custom/plugins/percol && git pull && cd -