7 static struct cmt_fmt_map
{
12 { "raw", 1, CMIT_FMT_RAW
},
13 { "medium", 1, CMIT_FMT_MEDIUM
},
14 { "short", 1, CMIT_FMT_SHORT
},
15 { "email", 1, CMIT_FMT_EMAIL
},
16 { "full", 5, CMIT_FMT_FULL
},
17 { "fuller", 5, CMIT_FMT_FULLER
},
18 { "oneline", 1, CMIT_FMT_ONELINE
},
19 { "format:", 7, CMIT_FMT_USERFORMAT
},
22 static char *user_format
;
24 enum cmit_fmt
get_commit_format(const char *arg
)
29 return CMIT_FMT_DEFAULT
;
32 if (!prefixcmp(arg
, "format:")) {
35 user_format
= xstrdup(arg
+ 7);
36 return CMIT_FMT_USERFORMAT
;
38 for (i
= 0; i
< ARRAY_SIZE(cmt_fmts
); i
++) {
39 if (!strncmp(arg
, cmt_fmts
[i
].n
, cmt_fmts
[i
].cmp_len
) &&
40 !strncmp(arg
, cmt_fmts
[i
].n
, strlen(arg
)))
44 die("invalid --pretty format: %s", arg
);
48 * Generic support for pretty-printing the header
50 static int get_one_line(const char *msg
)
65 /* High bit set, or ISO-2022-INT */
69 return ((ch
& 0x80) || (ch
== 0x1b));
72 static int is_rfc2047_special(char ch
)
74 return (non_ascii(ch
) || (ch
== '=') || (ch
== '?') || (ch
== '_'));
77 static void add_rfc2047(struct strbuf
*sb
, const char *line
, int len
,
82 for (i
= 0; i
< len
; i
++) {
86 if ((i
+ 1 < len
) && (ch
== '=' && line
[i
+1] == '?'))
89 strbuf_add(sb
, line
, len
);
93 strbuf_grow(sb
, len
* 3 + strlen(encoding
) + 100);
94 strbuf_addf(sb
, "=?%s?q?", encoding
);
95 for (i
= last
= 0; i
< len
; i
++) {
96 unsigned ch
= line
[i
] & 0xFF;
98 * We encode ' ' using '=20' even though rfc2047
99 * allows using '_' for readability. Unfortunately,
100 * many programs do not understand this and just
101 * leave the underscore in place.
103 if (is_rfc2047_special(ch
) || ch
== ' ') {
104 strbuf_add(sb
, line
+ last
, i
- last
);
105 strbuf_addf(sb
, "=%02X", ch
);
109 strbuf_add(sb
, line
+ last
, len
- last
);
110 strbuf_addstr(sb
, "?=");
113 static void add_user_info(const char *what
, enum cmit_fmt fmt
, struct strbuf
*sb
,
114 const char *line
, enum date_mode dmode
,
115 const char *encoding
)
121 const char *filler
= " ";
123 if (fmt
== CMIT_FMT_ONELINE
)
125 date
= strchr(line
, '>');
128 namelen
= ++date
- line
;
129 time
= strtoul(date
, &date
, 10);
130 tz
= strtol(date
, NULL
, 10);
132 if (fmt
== CMIT_FMT_EMAIL
) {
133 char *name_tail
= strchr(line
, '<');
134 int display_name_length
;
137 while (line
< name_tail
&& isspace(name_tail
[-1]))
139 display_name_length
= name_tail
- line
;
141 strbuf_addstr(sb
, "From: ");
142 add_rfc2047(sb
, line
, display_name_length
, encoding
);
143 strbuf_add(sb
, name_tail
, namelen
- display_name_length
);
144 strbuf_addch(sb
, '\n');
146 strbuf_addf(sb
, "%s: %.*s%.*s\n", what
,
147 (fmt
== CMIT_FMT_FULLER
) ? 4 : 0,
148 filler
, namelen
, line
);
151 case CMIT_FMT_MEDIUM
:
152 strbuf_addf(sb
, "Date: %s\n", show_date(time
, tz
, dmode
));
155 strbuf_addf(sb
, "Date: %s\n", show_date(time
, tz
, DATE_RFC2822
));
157 case CMIT_FMT_FULLER
:
158 strbuf_addf(sb
, "%sDate: %s\n", what
, show_date(time
, tz
, dmode
));
166 static int is_empty_line(const char *line
, int *len_p
)
169 while (len
&& isspace(line
[len
-1]))
175 static void add_merge_info(enum cmit_fmt fmt
, struct strbuf
*sb
,
176 const struct commit
*commit
, int abbrev
)
178 struct commit_list
*parent
= commit
->parents
;
180 if ((fmt
== CMIT_FMT_ONELINE
) || (fmt
== CMIT_FMT_EMAIL
) ||
181 !parent
|| !parent
->next
)
184 strbuf_addstr(sb
, "Merge:");
187 struct commit
*p
= parent
->item
;
188 const char *hex
= NULL
;
191 hex
= find_unique_abbrev(p
->object
.sha1
, abbrev
);
193 hex
= sha1_to_hex(p
->object
.sha1
);
194 dots
= (abbrev
&& strlen(hex
) != 40) ? "..." : "";
195 parent
= parent
->next
;
197 strbuf_addf(sb
, " %s%s", hex
, dots
);
199 strbuf_addch(sb
, '\n');
202 static char *get_header(const struct commit
*commit
, const char *key
)
204 int key_len
= strlen(key
);
205 const char *line
= commit
->buffer
;
208 const char *eol
= strchr(line
, '\n'), *next
;
213 eol
= line
+ strlen(line
);
217 if (eol
- line
> key_len
&&
218 !strncmp(line
, key
, key_len
) &&
219 line
[key_len
] == ' ') {
220 return xmemdupz(line
+ key_len
+ 1, eol
- line
- key_len
- 1);
226 static char *replace_encoding_header(char *buf
, const char *encoding
)
232 /* guess if there is an encoding header before a \n\n */
233 while (strncmp(cp
, "encoding ", strlen("encoding "))) {
234 cp
= strchr(cp
, '\n');
235 if (!cp
|| *++cp
== '\n')
239 cp
= strchr(cp
, '\n');
241 return buf
; /* should not happen but be defensive */
242 len
= cp
+ 1 - (buf
+ start
);
244 strbuf_init(&tmp
, 0);
245 strbuf_attach(&tmp
, buf
, strlen(buf
), strlen(buf
) + 1);
246 if (is_encoding_utf8(encoding
)) {
247 /* we have re-coded to UTF-8; drop the header */
248 strbuf_remove(&tmp
, start
, len
);
250 /* just replaces XXXX in 'encoding XXXX\n' */
251 strbuf_splice(&tmp
, start
+ strlen("encoding "),
252 len
- strlen("encoding \n"),
253 encoding
, strlen(encoding
));
255 return strbuf_detach(&tmp
, NULL
);
258 static char *logmsg_reencode(const struct commit
*commit
,
259 const char *output_encoding
)
261 static const char *utf8
= "utf-8";
262 const char *use_encoding
;
266 if (!*output_encoding
)
268 encoding
= get_header(commit
, "encoding");
269 use_encoding
= encoding
? encoding
: utf8
;
270 if (!strcmp(use_encoding
, output_encoding
))
271 if (encoding
) /* we'll strip encoding header later */
272 out
= xstrdup(commit
->buffer
);
274 return NULL
; /* nothing to do */
276 out
= reencode_string(commit
->buffer
,
277 output_encoding
, use_encoding
);
279 out
= replace_encoding_header(out
, output_encoding
);
285 static size_t format_person_part(struct strbuf
*sb
, char part
,
286 const char *msg
, int len
)
288 /* currently all placeholders have same length */
289 const int placeholder_len
= 2;
290 int start
, end
, tz
= 0;
291 unsigned long date
= 0;
294 /* advance 'end' to point to email start delimiter */
295 for (end
= 0; end
< len
&& msg
[end
] != '<'; end
++)
299 * When end points at the '<' that we found, it should have
300 * matching '>' later, which means 'end' must be strictly
306 if (part
== 'n') { /* name */
307 while (end
> 0 && isspace(msg
[end
- 1]))
309 strbuf_add(sb
, msg
, end
);
310 return placeholder_len
;
312 start
= ++end
; /* save email start position */
314 /* advance 'end' to point to email end delimiter */
315 for ( ; end
< len
&& msg
[end
] != '>'; end
++)
321 if (part
== 'e') { /* email */
322 strbuf_add(sb
, msg
+ start
, end
- start
);
323 return placeholder_len
;
326 /* advance 'start' to point to date start delimiter */
327 for (start
= end
+ 1; start
< len
&& isspace(msg
[start
]); start
++)
331 date
= strtoul(msg
+ start
, &ep
, 10);
332 if (msg
+ start
== ep
)
335 if (part
== 't') { /* date, UNIX timestamp */
336 strbuf_add(sb
, msg
+ start
, ep
- (msg
+ start
));
337 return placeholder_len
;
341 for (start
= ep
- msg
+ 1; start
< len
&& isspace(msg
[start
]); start
++)
343 if (start
+ 1 < len
) {
344 tz
= strtoul(msg
+ start
+ 1, NULL
, 10);
345 if (msg
[start
] == '-')
351 strbuf_addstr(sb
, show_date(date
, tz
, DATE_NORMAL
));
352 return placeholder_len
;
353 case 'D': /* date, RFC2822 style */
354 strbuf_addstr(sb
, show_date(date
, tz
, DATE_RFC2822
));
355 return placeholder_len
;
356 case 'r': /* date, relative */
357 strbuf_addstr(sb
, show_date(date
, tz
, DATE_RELATIVE
));
358 return placeholder_len
;
359 case 'i': /* date, ISO 8601 */
360 strbuf_addstr(sb
, show_date(date
, tz
, DATE_ISO8601
));
361 return placeholder_len
;
366 * bogus commit, 'sb' cannot be updated, but we still need to
367 * compute a valid return value.
369 if (part
== 'n' || part
== 'e' || part
== 't' || part
== 'd'
370 || part
== 'D' || part
== 'r' || part
== 'i')
371 return placeholder_len
;
373 return 0; /* unknown placeholder */
381 struct format_commit_context
{
382 const struct commit
*commit
;
384 /* These offsets are relative to the start of the commit message. */
385 int commit_header_parsed
;
386 struct chunk subject
;
388 struct chunk committer
;
389 struct chunk encoding
;
392 /* The following ones are relative to the result struct strbuf. */
393 struct chunk abbrev_commit_hash
;
394 struct chunk abbrev_tree_hash
;
395 struct chunk abbrev_parent_hashes
;
398 static int add_again(struct strbuf
*sb
, struct chunk
*chunk
)
401 strbuf_adddup(sb
, chunk
->off
, chunk
->len
);
406 * We haven't seen this chunk before. Our caller is surely
407 * going to add it the hard way now. Remember the most likely
408 * start of the to-be-added chunk: the current end of the
411 chunk
->off
= sb
->len
;
415 static void parse_commit_header(struct format_commit_context
*context
)
417 const char *msg
= context
->commit
->buffer
;
419 enum { HEADER
, SUBJECT
, BODY
} state
;
421 for (i
= 0, state
= HEADER
; msg
[i
] && state
< BODY
; i
++) {
423 for (eol
= i
; msg
[eol
] && msg
[eol
] != '\n'; eol
++)
426 if (state
== SUBJECT
) {
427 context
->subject
.off
= i
;
428 context
->subject
.len
= eol
- i
;
433 /* strip empty lines */
434 while (msg
[eol
] == '\n' && msg
[eol
+ 1] == '\n')
436 } else if (!prefixcmp(msg
+ i
, "author ")) {
437 context
->author
.off
= i
+ 7;
438 context
->author
.len
= eol
- i
- 7;
439 } else if (!prefixcmp(msg
+ i
, "committer ")) {
440 context
->committer
.off
= i
+ 10;
441 context
->committer
.len
= eol
- i
- 10;
442 } else if (!prefixcmp(msg
+ i
, "encoding ")) {
443 context
->encoding
.off
= i
+ 9;
444 context
->encoding
.len
= eol
- i
- 9;
450 context
->body_off
= i
;
451 context
->commit_header_parsed
= 1;
454 static size_t format_commit_item(struct strbuf
*sb
, const char *placeholder
,
457 struct format_commit_context
*c
= context
;
458 const struct commit
*commit
= c
->commit
;
459 const char *msg
= commit
->buffer
;
460 struct commit_list
*p
;
462 /* these are independent of the commit */
463 switch (placeholder
[0]) {
465 if (!prefixcmp(placeholder
+ 1, "red")) {
466 strbuf_addstr(sb
, "\033[31m");
468 } else if (!prefixcmp(placeholder
+ 1, "green")) {
469 strbuf_addstr(sb
, "\033[32m");
471 } else if (!prefixcmp(placeholder
+ 1, "blue")) {
472 strbuf_addstr(sb
, "\033[34m");
474 } else if (!prefixcmp(placeholder
+ 1, "reset")) {
475 strbuf_addstr(sb
, "\033[m");
479 case 'n': /* newline */
480 strbuf_addch(sb
, '\n');
484 /* these depend on the commit */
485 if (!commit
->object
.parsed
)
486 parse_object(commit
->object
.sha1
);
488 switch (placeholder
[0]) {
489 case 'H': /* commit hash */
490 strbuf_addstr(sb
, sha1_to_hex(commit
->object
.sha1
));
492 case 'h': /* abbreviated commit hash */
493 if (add_again(sb
, &c
->abbrev_commit_hash
))
495 strbuf_addstr(sb
, find_unique_abbrev(commit
->object
.sha1
,
497 c
->abbrev_commit_hash
.len
= sb
->len
- c
->abbrev_commit_hash
.off
;
499 case 'T': /* tree hash */
500 strbuf_addstr(sb
, sha1_to_hex(commit
->tree
->object
.sha1
));
502 case 't': /* abbreviated tree hash */
503 if (add_again(sb
, &c
->abbrev_tree_hash
))
505 strbuf_addstr(sb
, find_unique_abbrev(commit
->tree
->object
.sha1
,
507 c
->abbrev_tree_hash
.len
= sb
->len
- c
->abbrev_tree_hash
.off
;
509 case 'P': /* parent hashes */
510 for (p
= commit
->parents
; p
; p
= p
->next
) {
511 if (p
!= commit
->parents
)
512 strbuf_addch(sb
, ' ');
513 strbuf_addstr(sb
, sha1_to_hex(p
->item
->object
.sha1
));
516 case 'p': /* abbreviated parent hashes */
517 if (add_again(sb
, &c
->abbrev_parent_hashes
))
519 for (p
= commit
->parents
; p
; p
= p
->next
) {
520 if (p
!= commit
->parents
)
521 strbuf_addch(sb
, ' ');
522 strbuf_addstr(sb
, find_unique_abbrev(
523 p
->item
->object
.sha1
, DEFAULT_ABBREV
));
525 c
->abbrev_parent_hashes
.len
= sb
->len
-
526 c
->abbrev_parent_hashes
.off
;
528 case 'm': /* left/right/bottom */
529 strbuf_addch(sb
, (commit
->object
.flags
& BOUNDARY
)
531 : (commit
->object
.flags
& SYMMETRIC_LEFT
)
537 /* For the rest we have to parse the commit header. */
538 if (!c
->commit_header_parsed
)
539 parse_commit_header(c
);
541 switch (placeholder
[0]) {
542 case 's': /* subject */
543 strbuf_add(sb
, msg
+ c
->subject
.off
, c
->subject
.len
);
545 case 'a': /* author ... */
546 return format_person_part(sb
, placeholder
[1],
547 msg
+ c
->author
.off
, c
->author
.len
);
548 case 'c': /* committer ... */
549 return format_person_part(sb
, placeholder
[1],
550 msg
+ c
->committer
.off
, c
->committer
.len
);
551 case 'e': /* encoding */
552 strbuf_add(sb
, msg
+ c
->encoding
.off
, c
->encoding
.len
);
555 strbuf_addstr(sb
, msg
+ c
->body_off
);
558 return 0; /* unknown placeholder */
561 void format_commit_message(const struct commit
*commit
,
562 const void *format
, struct strbuf
*sb
)
564 struct format_commit_context context
;
566 memset(&context
, 0, sizeof(context
));
567 context
.commit
= commit
;
568 strbuf_expand(sb
, format
, format_commit_item
, &context
);
571 static void pp_header(enum cmit_fmt fmt
,
573 enum date_mode dmode
,
574 const char *encoding
,
575 const struct commit
*commit
,
579 int parents_shown
= 0;
582 const char *line
= *msg_p
;
583 int linelen
= get_one_line(*msg_p
);
593 if (fmt
== CMIT_FMT_RAW
) {
594 strbuf_add(sb
, line
, linelen
);
598 if (!memcmp(line
, "parent ", 7)) {
600 die("bad parent line in commit");
604 if (!parents_shown
) {
605 struct commit_list
*parent
;
607 for (parent
= commit
->parents
, num
= 0;
609 parent
= parent
->next
, num
++)
611 /* with enough slop */
612 strbuf_grow(sb
, num
* 50 + 20);
613 add_merge_info(fmt
, sb
, commit
, abbrev
);
618 * MEDIUM == DEFAULT shows only author with dates.
619 * FULL shows both authors but not dates.
620 * FULLER shows both authors and dates.
622 if (!memcmp(line
, "author ", 7)) {
623 strbuf_grow(sb
, linelen
+ 80);
624 add_user_info("Author", fmt
, sb
, line
+ 7, dmode
, encoding
);
626 if (!memcmp(line
, "committer ", 10) &&
627 (fmt
== CMIT_FMT_FULL
|| fmt
== CMIT_FMT_FULLER
)) {
628 strbuf_grow(sb
, linelen
+ 80);
629 add_user_info("Commit", fmt
, sb
, line
+ 10, dmode
, encoding
);
634 static void pp_title_line(enum cmit_fmt fmt
,
638 const char *after_subject
,
639 const char *encoding
,
644 strbuf_init(&title
, 80);
647 const char *line
= *msg_p
;
648 int linelen
= get_one_line(line
);
651 if (!linelen
|| is_empty_line(line
, &linelen
))
654 strbuf_grow(&title
, linelen
+ 2);
656 if (fmt
== CMIT_FMT_EMAIL
) {
657 strbuf_addch(&title
, '\n');
659 strbuf_addch(&title
, ' ');
661 strbuf_add(&title
, line
, linelen
);
664 strbuf_grow(sb
, title
.len
+ 1024);
666 strbuf_addstr(sb
, subject
);
667 add_rfc2047(sb
, title
.buf
, title
.len
, encoding
);
669 strbuf_addbuf(sb
, &title
);
671 strbuf_addch(sb
, '\n');
673 if (plain_non_ascii
) {
674 const char *header_fmt
=
675 "MIME-Version: 1.0\n"
676 "Content-Type: text/plain; charset=%s\n"
677 "Content-Transfer-Encoding: 8bit\n";
678 strbuf_addf(sb
, header_fmt
, encoding
);
681 strbuf_addstr(sb
, after_subject
);
683 if (fmt
== CMIT_FMT_EMAIL
) {
684 strbuf_addch(sb
, '\n');
686 strbuf_release(&title
);
689 static void pp_remainder(enum cmit_fmt fmt
,
696 const char *line
= *msg_p
;
697 int linelen
= get_one_line(line
);
703 if (is_empty_line(line
, &linelen
)) {
706 if (fmt
== CMIT_FMT_SHORT
)
711 strbuf_grow(sb
, linelen
+ indent
+ 20);
713 memset(sb
->buf
+ sb
->len
, ' ', indent
);
714 strbuf_setlen(sb
, sb
->len
+ indent
);
716 strbuf_add(sb
, line
, linelen
);
717 strbuf_addch(sb
, '\n');
721 void pretty_print_commit(enum cmit_fmt fmt
, const struct commit
*commit
,
722 struct strbuf
*sb
, int abbrev
,
723 const char *subject
, const char *after_subject
,
724 enum date_mode dmode
, int plain_non_ascii
)
726 unsigned long beginning_of_body
;
728 const char *msg
= commit
->buffer
;
730 const char *encoding
;
732 if (fmt
== CMIT_FMT_USERFORMAT
) {
733 format_commit_message(commit
, user_format
, sb
);
737 encoding
= (git_log_output_encoding
738 ? git_log_output_encoding
739 : git_commit_encoding
);
742 reencoded
= logmsg_reencode(commit
, encoding
);
747 if (fmt
== CMIT_FMT_ONELINE
|| fmt
== CMIT_FMT_EMAIL
)
750 /* After-subject is used to pass in Content-Type: multipart
751 * MIME header; in that case we do not have to do the
752 * plaintext content type even if the commit message has
753 * non 7-bit ASCII character. Otherwise, check if we need
754 * to say this is not a 7-bit ASCII.
756 if (fmt
== CMIT_FMT_EMAIL
&& !after_subject
) {
759 for (in_body
= i
= 0; (ch
= msg
[i
]); i
++) {
761 /* author could be non 7-bit ASCII but
762 * the log may be so; skip over the
765 if (ch
== '\n' && msg
[i
+1] == '\n')
768 else if (non_ascii(ch
)) {
775 pp_header(fmt
, abbrev
, dmode
, encoding
, commit
, &msg
, sb
);
776 if (fmt
!= CMIT_FMT_ONELINE
&& !subject
) {
777 strbuf_addch(sb
, '\n');
780 /* Skip excess blank lines at the beginning of body, if any... */
782 int linelen
= get_one_line(msg
);
786 if (!is_empty_line(msg
, &ll
))
791 /* These formats treat the title line specially. */
792 if (fmt
== CMIT_FMT_ONELINE
|| fmt
== CMIT_FMT_EMAIL
)
793 pp_title_line(fmt
, &msg
, sb
, subject
,
794 after_subject
, encoding
, plain_non_ascii
);
796 beginning_of_body
= sb
->len
;
797 if (fmt
!= CMIT_FMT_ONELINE
)
798 pp_remainder(fmt
, &msg
, sb
, indent
);
801 /* Make sure there is an EOLN for the non-oneline case */
802 if (fmt
!= CMIT_FMT_ONELINE
)
803 strbuf_addch(sb
, '\n');
806 * The caller may append additional body text in e-mail
807 * format. Make sure we did not strip the blank line
808 * between the header and the body.
810 if (fmt
== CMIT_FMT_EMAIL
&& sb
->len
<= beginning_of_body
)
811 strbuf_addch(sb
, '\n');