Color in git-log
As of git 1.8.3 (May 24, 2013), you can use %C(auto)
to decorate %d
in the format string of git log
.
From the release notes:
* "git log --format" specifier learned %C(auto) token that tells Git
to use color when interpolating %d (decoration), %h (short commit
object name), etc. for terminal output.)
The git log --decorate
will put by default:
- the HEAD in cyan
- the remote branches in red
- the tag in green
and can be changed through color.decorate
config.
But the git log --format
don't offer a way to display specifically the HEAD
or remotes or branch: all three are displayed through %d
, with one color possible.
Update May 2013, as mentioned below by Elad Shahar (upvoted), git 1.8.3 offers one more option:
git log –format
now sports a%C(auto)
token that tells Git to use color when resolving%d
(decoration),%h
(short commit object name), etc. for terminal output.
This Atlassian blog post comments that this feature is part of several others focused on format (git rebase
, git count-objects
) and colors (git branch -vv
)
This comes in addition of the previous auto,reset
of 1.8.2, which automatically disables colors when the output is not used for a terminal1
%C(auto,blue)Hello%C(auto,reset)
Note: git 2.4+ (Q2 2015) will do a better job of resetting color around branch names.
See commit 5ee8758 by Junio C Hamano (gitster
):
log --decorate
: do not leak "commit" color into the next itemIn "
git log --decorate
", you would see the commit header like this:
commit ... (HEAD, jc/decorate-leaky-separator-color)
where "
commit ... (
" is painted incolor.diff.commit
, "HEAD
" incolor.decorate.head
, ",
" incolor.diff.commit
, the branch name incolor.decorate.branch
and then closing ")
" incolor.diff.commit
.If you wanted to paint the HEAD and local branch name in the same color as the body text (perhaps because cyan and green are too faint on a black-on-white terminal to be readable), you would not want to have to say
[color "decorate"]
head = black
branch = black
because that you would not be able to reuse same configuration on a white-on-black terminal. You would naively expect
[color "decorate"]
head = normal
branch = normal
to work, but unfortunately it does not.
It paints the string "HEAD
" and the branch name in the same color as the opening parenthesis or comma between the decoration elements.
This is because the code forgets to reset the color after printing the "prefix" in its own color.
Note that git 2.5 (Q2 2015) fixes a bug:
See commit 429ad20 by Junio C Hamano (gitster
), 13 May 2015.
(Merged by Junio C Hamano -- gitster
-- in commit fd70780, 22 May 2015)
log
: do not shorten decoration names too earlyThe "
log --decorate
" enhancement in Git 2.4 that shows the commit at the tip of the current branch e.g. "HEAD -> master
", did not work with --decorate=full.
Git 2.9.x+ (Q3 2016) will fix another bug and honor color=auto
for %C(auto)
Git 2.10.2 (Oct. 2016) fixes other bugs with commit 82b83da (29 Sep 2016), and commit c99ad27 (17 Sep 2016) by René Scharfe (``).
(Merged by Junio C Hamano -- gitster
-- in commit 76796d4, 28 Oct 2016)
pretty
: avoid adding reset for%C(auto)
if output is emptyWe emit an escape sequence for resetting color and attribute for
%C(auto)
to make sure automatic coloring is displayed as intended.
Stop doing that if the output strbuf is empty, i.e. when%C(auto)
appears at the start of the format string, because then there is no need for a reset and we save a few bytes in the output.
pretty
: let%C(auto)
reset all attributesReset colors and attributes upon
%C(auto)
to enable full automatic control over them; otherwise attributes like bold or reverse could still be in effect from previous%C
placeholders.
Parenthesize them:
%C(...): color specification, as described in color.branch.* config option
So %C(yellow reverse)
would work.