Skip to content

Latest commit

 

History

History
71 lines (61 loc) · 2.72 KB

README.md

File metadata and controls

71 lines (61 loc) · 2.72 KB

Brisk Blame Browser for Git ⚡

PyPI GitHub License Code style: black

git-bbb is a wraper around git blame, that lets you seamlessly warp between different revisions.

Git-bbb screenshot

Features ✨

  • Sensible TUI made with Prompt Toolkit
  • Syntax highlighting thanks to Pygments!)
  • Seamlessly switches between revisions in just one keypress
  • Shows you where the lines of a commit are in the file
  • Uses .git-ignore-revs file as an input to --ignore-revs-file by default
  • Vi style key bindings
  • Search functionality
  • Coming soon: customizability via git config
  • Coming soon: seamlessly browse through file history, even if it was moved multiple times
  • Coming soon: highlight contributions made by a given author

Installation

# Install git-bbb via pip
pip install git-bbb

Usage

# Installing git-bbb will add a "git bbb" command
git bbb file/in/the/repo

Key bindings

  • Use h & j or & to move to the next/previous blame line
  • Enter to switch (warp) to the highlighted revision, or P to go to its ancestor.
  • S runs git show for the commit indicated by the cursor.
  • u to go back to the previously viewed revision - a.k.a. undo.
  • ctrl+r to redo previous warp.
  • ctrl+J & ctrl+K move the whole document view up and down
  • Stepping between the lines of the currently highlighted revision: H - first, L - last, J - next, K - previous.
  • gg and G will make git bbb go to the first and last line, respectively
  • Ctrl+d and Ctrl+u will scroll half a page up and down, respectively
  • Page Up & Page Down do what they are supposed to do
  • / & ? to search through file contents. This works mostly in the same way as in Vi(m). Use n and N to cycle through results.
  • q to quit
  • ...many more to come