Add documentation on how to get it working with git show

[dylan-chong]

My main use case for this program is to add syntax highlighting to git show somebranch:somefile. Would be possible to add some documentation on how to use bat as the default git show viewer.

One thing to may be consider is a possible conflict with https://github.com/so-fancy/diff-so-fancy

[dylan-chong]

This is a really awesome looking tool by the way !

[sharkdp]

Thank you for the feedback.

You can configure git show to use bat as a pager like this:

> git config --global pager.show bat

However, git will only pipe its output into bat, so there is no way of determining the syntax of the file (if #205 would be implemented, we could determine the syntax for a few files).

Unfortunately, I don't know if there is any way to get more information from git, since - in principle - we also have the filename.

Note that you can always just use a pipe yourself. This way, you can explicitly set the syntax:

> git show HEAD~3:src/main.rs | bat -lrs

I guess it would also be easy to write a simple git-show bash function that would take something like somebranch:somefile.ext as an argument and then call git show somebranch:somefile.ext | bat -l ext.

[sharkdp]

Small update: #205 is now implemented, so just configuring bat as a pager works for cases where the syntax of the file can be determined from the first line (typically via shebangs in Python, Bash, etc).

[sharkdp]

@dylan-chong Any update on this?

[dylan-chong]

I haven't tried because the issue that closes this only works be checking she shebang line at the start of the file, which doesn't really allow the syntax highlight to work most of the time

…

On 12/10/2018, at 6:41 AM, David Peter ***@***.***> wrote: @dylan-chong Any update on this? — You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub, or mute the thread.

[sharkdp]

git show doesn't provide any information about the filename to the pager, so I guess an external tool or shell function will be the only option.

This works for me (bash or zsh):

function git-show() {
    local ref="$1"
    local extension="${ref##*.}"

    git show "$ref" | bat --language "$extension"
}

[dylan-chong]

That might be a little inconvenient because bash auto complete won't work on branch names. Oh well it's not a hugely important feature anyway

…

On 12/10/2018, at 6:56 AM, David Peter ***@***.***> wrote: git show doesn't provide any information about the filename to the pager, so I guess an external tool or shell function will be the only option. This works for me (bash or zsh): function git-show() { local ref="$1" local extension="${ref##*.}" git show "$ref" | bat --language "$extension" } — You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub, or mute the thread.

[sharkdp]

Yeah, sorry. I really don't think there is a better way unless someone wants to propose a change in Git such that it publishes the filename via some environment variable, for example 😄