vgrep: A pager for grep

[ bsd3, library, program, web ] [ Propose Tags ] [ Report a vulnerability ]

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]

Downloads

Note: This package has metadata revisions in the cabal description newer than included in the tarball. To unpack the package including the revisions, use 'cabal get'.

Maintainer's Corner

Package maintainers

For package maintainers and hackage trustees

Candidates

  • No Candidates
Versions [RSS] 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.10 || >=0.11 && <1.6 || >=2 && <2.1), 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 && <5.34), yaml (>=0.8.12) [details]
License BSD-3-Clause
Copyright 2016 Franz Thoma
Author Franz Thoma
Maintainer franz.thoma@tngtech.com
Revised Revision 2 made by sjakobi at 2022-03-07T03:49:09Z
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
Executables vgrep
Downloads 4834 total (9 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]

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