vgrep: A pager for grep

[ bsd3, library, program, web ] [ Propose Tags ]

vgrep is a pager for navigating through grep output.

Usage:

grep -rn foo | vgrep
vgrep foo /some/path
vgrep foo /some/path | vgrep bar

Use hjkl or arrow keys to navigate, Enter to view file, q to quit.

[Skip to Readme]

Versions [faq]	0.1.3.0, 0.1.4.0, 0.1.4.1, 0.2.0.0, 0.2.1.0, 0.2.2.0, 0.2.3.0
Change log	CHANGELOG.md
Dependencies	aeson (==0.9.* \|\| >=0.11 && <1.6), async (>=2.0.2), attoparsec (>=0.12.1.6), base (>=4.11 && <5), containers (>=0.5.6.2), directory (>=1.2.2), fingertree (>=0.1.1), generic-deriving (>=1.5.0), lifted-base (>=0.2.3.6), microlens-mtl, microlens-platform, mmorph (>=1.0.4), mtl (>=2.2.1), pipes (>=4.1.6), pipes-concurrency (>=2.0.3), process (>=1.2.3), stm (>=2.4.4), template-haskell (>=2.10), text (>=1.2.1.3), transformers, unix (>=2.7.1), vgrep, vty (>=5.4.0), yaml (>=0.8.12) [details]
License	BSD-3-Clause
Copyright	2016 Franz Thoma
Author	Franz Thoma
Maintainer	franz.thoma@tngtech.com
Category	Web
Home page	http://github.com/fmthoma/vgrep#readme
Source repo	head: git clone https://github.com/fmthoma/vgrep
Uploaded	by fmthoma at 2021-01-26T18:32:44Z
Distributions	NixOS:0.2.3.0
Executables	vgrep
Downloads	3652 total (5 in the last 30 days)
Rating	(no votes yet) [estimated by Bayesian average]
Your Rating	λ λ λ
Status	Docs available [build log] Last success reported on 2021-01-26 [all 1 reports]

Downloads

vgrep-0.2.3.0.tar.gz [browse] (Cabal source package)
Package description (as included in the package)

Maintainer's Corner

For package maintainers and hackage trustees

edit package information

Readme for vgrep-0.2.3.0

[back to package description]

`vgrep` -- A pager for `grep`

Screenshot

Usage

As a pager:

grep -rn data /some/path | vgrep  # -n for line numbers

As a drop-in replacement for grep:

vgrep data /some/path                  # recursive by default
vgrep data /some/path | vgrep default  # works with pipes, too

With a git alias defined in your ~/.gitconfig:

git config --global alias.vgrep '!__git_vgrep () { git grep --color=always "$@" | vgrep; }; __git_vgrep'
git vgrep data

Using ack/ag instead of grep? No problem:

ack data | vgrep           # Output of `ack` is compatible
ack --color data | vgrep   # Even coloring works
ag --color data | vgrep    # Same for `ag`

Keybindings:

Use hjkl or the arrow keys to navigate
Enter opens a pager with the selected file
e opens the selected file in $EDITOR
Tab switches between results list and pager
q closes the pager and then the entire application.

Installation

Via `nix` from nixpkgs

nix-env -iA nixpkgs.haskellPackages.vgrep

From Hackage

Installation from Hackage via stack is recommended:

stack update
stack install vgrep

This will install vgrep to your ~/.local/bin directory.

From source

git clone https://github.com/fmthoma/vgrep.git
cd vgrep
stack setup
stack install