# [PATCH] for-each-ref: introduce color format

4 messages from 2013-05-17 to 2013-05-19. Participants: Ramkumar Ramachandra, Junio C Hamano, Duy Nguyen.
Thread: https://gitlist.dev/t/33851

## Ramkumar Ramachandra, 2013-05-17 14:55

Subject: [PATCH] for-each-ref: introduce color format
Message-ID: <1368802552-16024-1-git-send-email-artagnon@gmail.com>
URL: https://gitlist.dev/e/1368802552-16024-1-git-send-email-artagnon%40gmail.com

```
You can now do something like

$ git for-each-ref --format='%C(red)%(refname:short)%C(reset)
%C(blue)%(upstream:diff)%C(reset)' --count 5 --sort='-committerdate'
refs/heads

To get output that's much more customizable 'git branch' output.  Future
patches will attempt unify the semantics of 'git branch' and 'git
for-each-ref'.

Signed-off-by: Ramkumar Ramachandra <artagnon@gmail.com>
---
 So my evil plan is to keep extending this format until it's on par
 with pretty-formats.  Then, we can move towards unifying 'git branch'
 and 'git for-each-ref'.  This will involve deprecating badly
 thought-out options like '-v', and replacing it with the more
 powerful '--format'.

 I just have one major doubt: in the above output, how do I align all
 the upstream branches to the same column?  How can I achieve it with
 pretty-formats?  Something like %*d?  But * is already taken to mean
 deref in for-each-ref's --format.

 By the way, the main motivation for all this comes from the fact that
 git for-each-ref is very nicely written :) Look at how it breaks
 everything up into atoms and lazily gets the information it needs to
 display.

 builtin/for-each-ref.c | 26 ++++++++++++++++++++++----
 1 file changed, 22 insertions(+), 4 deletions(-)

diff --git a/builtin/for-each-ref.c b/builtin/for-each-ref.c
index 7f059c3..1563b25 100644
--- a/builtin/for-each-ref.c
+++ b/builtin/for-each-ref.c
@@ -9,6 +9,7 @@
 #include "quote.h"
 #include "parse-options.h"
 #include "remote.h"
+#include "color.h"
 
 /* Quoting styles */
 #define QUOTE_NONE 0
@@ -155,10 +156,13 @@ static const char *find_next(const char *cp)
 	while (*cp) {
 		if (*cp == '%') {
 			/*
+			 * %C( is the start of a color;
 			 * %( is the start of an atom;
 			 * %% is a quoted per-cent.
 			 */
-			if (cp[1] == '(')
+			if (cp[1] == 'C' && cp[2] == '(')
+				return cp;
+			else if (cp[1] == '(')
 				return cp;
 			else if (cp[1] == '%')
 				cp++; /* skip over two % */
@@ -180,8 +184,12 @@ static int verify_format(const char *format)
 		const char *ep = strchr(sp, ')');
 		if (!ep)
 			return error("malformed format string %s", sp);
-		/* sp points at "%(" and ep points at the closing ")" */
-		parse_atom(sp + 2, ep);
+		/*
+		 * Ignore color specifications: %C(
+		 * sp points at "%(" and ep points at the closing ")"
+		 */
+		if (prefixcmp(sp, "%C("))
+			parse_atom(sp + 2, ep);
 		cp = ep + 1;
 	}
 	return 0;
@@ -928,12 +936,22 @@ static void emit(const char *cp, const char *ep)
 static void show_ref(struct refinfo *info, const char *format, int quote_style)
 {
 	const char *cp, *sp, *ep;
+	char color[COLOR_MAXLEN];
 
 	for (cp = format; *cp && (sp = find_next(cp)); cp = ep + 1) {
 		ep = strchr(sp, ')');
 		if (cp < sp)
 			emit(cp, sp);
-		print_value(info, parse_atom(sp + 2, ep), quote_style);
+
+		/* Do we have a color specification? */
+		if (!prefixcmp(sp, "%C("))
+			color_parse_mem(sp + 3,
+					ep - sp - 3,
+					"--format ", color);
+		else {
+			printf("%s", color);
+			print_value(info, parse_atom(sp + 2, ep), quote_style);
+		}
 	}
 	if (*cp) {
 		sp = cp + strlen(cp);
-- 
1.8.3.rc2.13.g629b60a.dirty

```

## Junio C Hamano, 2013-05-17 17:20

Subject: Re: [PATCH] for-each-ref: introduce color format
Message-ID: <7vsj1lzfo8.fsf@alter.siamese.dyndns.org>
URL: https://gitlist.dev/e/7vsj1lzfo8.fsf%40alter.siamese.dyndns.org
In-Reply-To: <1368802552-16024-1-git-send-email-artagnon@gmail.com>

```
Ramkumar Ramachandra <artagnon@gmail.com> writes:

>  I just have one major doubt: in the above output, how do I align all
>  the upstream branches to the same column?  How can I achieve it with
>  pretty-formats?  Something like %*d?  But * is already taken to mean
>  deref in for-each-ref's --format.

Doesn't Duy's more recent work on the pretty-format front introduce
alignment operators?

```

## Ramkumar Ramachandra, 2013-05-17 17:23

Subject: Re: [PATCH] for-each-ref: introduce color format
Message-ID: <CALkWK0=8nwU5d17=ci0yAYYzMiihQbHBqscfD2nUGgwPPirLkw@mail.gmail.com>
URL: https://gitlist.dev/e/CALkWK0%3D8nwU5d17%3Dci0yAYYzMiihQbHBqscfD2nUGgwPPirLkw%40mail.gmail.com
In-Reply-To: <7vsj1lzfo8.fsf@alter.siamese.dyndns.org>

```
Junio C Hamano wrote:
> Doesn't Duy's more recent work on the pretty-format front introduce
> alignment operators?

Oh, awesome.  I know where to steal that from now ;)

```

## Duy Nguyen, 2013-05-19 12:05

Subject: Re: [PATCH] for-each-ref: introduce color format
Message-ID: <CACsJy8CthvpJh6QM+umxY_Gq7nc-rGZ+Tcp7zAkadez-g+FFjQ@mail.gmail.com>
URL: https://gitlist.dev/e/CACsJy8CthvpJh6QM%2BumxY_Gq7nc-rGZ%2BTcp7zAkadez-g%2BFFjQ%40mail.gmail.com
In-Reply-To: <1368802552-16024-1-git-send-email-artagnon@gmail.com>

```
On Fri, May 17, 2013 at 9:55 PM, Ramkumar Ramachandra
<artagnon@gmail.com> wrote:
> You can now do something like
>
> $ git for-each-ref --format='%C(red)%(refname:short)%C(reset)
> %C(blue)%(upstream:diff)%C(reset)' --count 5 --sort='-committerdate'
> refs/heads
>
> To get output that's much more customizable 'git branch' output.  Future
> patches will attempt unify the semantics of 'git branch' and 'git
> for-each-ref'.
>
> Signed-off-by: Ramkumar Ramachandra <artagnon@gmail.com>
> ---
>  So my evil plan is to keep extending this format until it's on par
>  with pretty-formats.  Then, we can move towards unifying 'git branch'
>  and 'git for-each-ref'.  This will involve deprecating badly
>  thought-out options like '-v', and replacing it with the more
>  powerful '--format'.
>
>  I just have one major doubt: in the above output, how do I align all
>  the upstream branches to the same column?  How can I achieve it with
>  pretty-formats?  Something like %*d?  But * is already taken to mean
>  deref in for-each-ref's --format.
>
>  By the way, the main motivation for all this comes from the fact that
>  git for-each-ref is very nicely written :) Look at how it breaks
>  everything up into atoms and lazily gets the information it needs to
>  display.

If you can put energy into this, I suggest you improve pretty.c a bit,
adding new format_ref_message(), similar to format_commit_message(),
except that it takes a ref. You can extend "struct
format_commit_context" to contain what "struct refinfo" does. I think
pretty.c only lacks a few specifiers that for-each-ref has. I think I
mentioned it in my for-each-ref series already, but we need to think
how to specify "align to the left with the best width" and how
format_ref_message() can figure the width out. A callback function
might do.
--
Duy

```
