Tools to make searching and viewing easy.
Switch branches/tags
Nothing to show
Clone or download

README.rst

Tools to make searching and viewing easy.

For a Chinese introduction, see my blog article.

阅读中文版介绍,请看我的博客文章(有点旧了)。

Overview

  • agg/rgg/agv: ag / ripgrep wrappers to make it easy to open files as matching places
  • vv: A gVim wrapper to open files in existing gVim instances and then move the cursor to specified location

Dependencies

  • agg: Bash, ag, and several other common command-line tools.
  • rgg: Bash, ripgrep, and several other common command-line tools.
  • agv: Python 3, setproctitle library for changing the process name (optional).
  • vv: Python 3, Vim or gVim with +clientserver feature.

Arch Linux users can install search-and-view-git from AUR (thanks to @acgtyrant).

Configuration

Use the AGV_EDITOR environmental variable to spefify your preferred editor for agv. It's taken as a shell command template string and the following is recognized:

  • $file: The file path.
  • $line: The line number.
  • $col: The column number.

For example:

# uses 'vv'
export AGV_EDITOR='vv $file:$line:$col'
# uses 'vim'
export AGV_EDITOR='vim +$line $file'

Usage

agg / rgg and agv

Just use agg as ag to search text (Searching in filenames -g won't work). Use rgg if you want to use the ripgrep tool.

Use agv N to open the result numbered N. You can use agv without arguments to view the list again. The list is per terminal (tty).

vv

you can give a line number and a column number after a colon, like this:

vv file:33
vv file:12:902

Or paste the line from a Python traceback:

vv 'File "/usr/lib/python3.4/sre_parse.py", line 358, in _parse_sub'

You don't need the full line. Just enough info will do:

vv '/usr/lib/python3.4/sre_parse.py", line 358'

If you are on Linux and use zsh, I suggest the following alias:

alias -g XS='"$(xsel)"'

Then you can just select the line and do:

vv XS

You can pass the --wait flag to wait for Vim to finish editing the file (useful for programs that waits for editing to finish).

Use the --vim NAME option to spefify a Vim instance (default is the first one found).

License

GPLv3+.