git-bbb 0.0.9

⚡ Brisk Blame Browser for Git

Brisk Blame Browser for Git ⚡

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

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