frou / st3-gitblame

Show Git blame information while viewing a file in Sublime Text

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

GitHub release GitHub contributors GitHub issues

Git blame - Package for Sublime Text

This package enables you to query Git "blame" information for files while you are viewing/editing them in Sublime Text.

Blame information tells you who last edited a line, when they did it, and which commit they did it in. You can then choose to show that commit in full including its commit message and diff.

For this package to work, you must already have the git command-line tool installed, and be viewing/editing a file that is part of a Git repository on your hard drive.

View on the Package Control website

This package was originally created by @psykzz and is now maintained by @frou

How to use

Place the text cursor on the line you are interested in, then press CtrlAltB (Mac/Windows) or CtrlShiftQ (Linux).

(Instead of pressing the keyboard shortcut, you can alternatively right click and select Git Blame from the context menu)

The blame information will appear:

Screenshot

If you want, you can then click [Show] to show the commit in full:

Screenshot

...or click [Copy] to copy the Commit ID (aka SHA) to your clipboard.

If the latest blame information was not as illuminating as you hoped for, click the [Prev] to step back through multiple previous commits that affected the line.

To close the blame information, click the × icon, or press the keyboard shortcut again while the text cursor is still on the same line.

Advanced use

In combination with Sublime Text's Multiple Selection feature, you can query blame information for more than one line simultaneously by first placing a text cursor on each line you are interested in, and then running as described above.

You can also query blame information for every line in the entire file simultaneously by pressing CtrlAltShiftB (Mac/Windows) or CtrlShiftC (Linux). Doing this shows blame information in a different style (it's located to the left of the content, and more compact, but with fewer features):

Screenshot

To close all of them, click the × icon on any one of them, or press the keyboard shortcut again.

As well as via keyboard shortcuts, this package's commands are also made available in the Command Palette. Type "Git Blame" into it to find them:

Screenshot

About

Show Git blame information while viewing a file in Sublime Text

License:MIT License


Languages

Language:Python 100.0%