Documentation: finishing touches to the new tutorial.
[git/dscho.git] / commit.c
blobb8bf35e86081a638137c49e9eabb18c466dec1e5
1 #include "cache.h"
2 #include "tag.h"
3 #include "commit.h"
5 int save_commit_buffer = 1;
7 struct sort_node
9 /*
10 * the number of children of the associated commit
11 * that also occur in the list being sorted.
13 unsigned int indegree;
16 * reference to original list item that we will re-use
17 * on output.
19 struct commit_list * list_item;
23 const char *commit_type = "commit";
25 enum cmit_fmt get_commit_format(const char *arg)
27 if (!*arg)
28 return CMIT_FMT_DEFAULT;
29 if (!strcmp(arg, "=raw"))
30 return CMIT_FMT_RAW;
31 if (!strcmp(arg, "=medium"))
32 return CMIT_FMT_MEDIUM;
33 if (!strcmp(arg, "=short"))
34 return CMIT_FMT_SHORT;
35 if (!strcmp(arg, "=full"))
36 return CMIT_FMT_FULL;
37 if (!strcmp(arg, "=fuller"))
38 return CMIT_FMT_FULLER;
39 if (!strcmp(arg, "=oneline"))
40 return CMIT_FMT_ONELINE;
41 die("invalid --pretty format");
44 static struct commit *check_commit(struct object *obj,
45 const unsigned char *sha1,
46 int quiet)
48 if (obj->type != commit_type) {
49 if (!quiet)
50 error("Object %s is a %s, not a commit",
51 sha1_to_hex(sha1), obj->type);
52 return NULL;
54 return (struct commit *) obj;
57 struct commit *lookup_commit_reference_gently(const unsigned char *sha1,
58 int quiet)
60 struct object *obj = deref_tag(parse_object(sha1), NULL, 0);
62 if (!obj)
63 return NULL;
64 return check_commit(obj, sha1, quiet);
67 struct commit *lookup_commit_reference(const unsigned char *sha1)
69 return lookup_commit_reference_gently(sha1, 0);
72 struct commit *lookup_commit(const unsigned char *sha1)
74 struct object *obj = lookup_object(sha1);
75 if (!obj) {
76 struct commit *ret = xmalloc(sizeof(struct commit));
77 memset(ret, 0, sizeof(struct commit));
78 created_object(sha1, &ret->object);
79 ret->object.type = commit_type;
80 return ret;
82 if (!obj->type)
83 obj->type = commit_type;
84 return check_commit(obj, sha1, 0);
87 static unsigned long parse_commit_date(const char *buf)
89 unsigned long date;
91 if (memcmp(buf, "author", 6))
92 return 0;
93 while (*buf++ != '\n')
94 /* nada */;
95 if (memcmp(buf, "committer", 9))
96 return 0;
97 while (*buf++ != '>')
98 /* nada */;
99 date = strtoul(buf, NULL, 10);
100 if (date == ULONG_MAX)
101 date = 0;
102 return date;
105 static struct commit_graft {
106 unsigned char sha1[20];
107 int nr_parent;
108 unsigned char parent[0][20]; /* more */
109 } **commit_graft;
110 static int commit_graft_alloc, commit_graft_nr;
112 static int commit_graft_pos(const unsigned char *sha1)
114 int lo, hi;
115 lo = 0;
116 hi = commit_graft_nr;
117 while (lo < hi) {
118 int mi = (lo + hi) / 2;
119 struct commit_graft *graft = commit_graft[mi];
120 int cmp = memcmp(sha1, graft->sha1, 20);
121 if (!cmp)
122 return mi;
123 if (cmp < 0)
124 hi = mi;
125 else
126 lo = mi + 1;
128 return -lo - 1;
131 static void prepare_commit_graft(void)
133 char *graft_file = get_graft_file();
134 FILE *fp = fopen(graft_file, "r");
135 char buf[1024];
136 if (!fp) {
137 commit_graft = (struct commit_graft **) "hack";
138 return;
140 while (fgets(buf, sizeof(buf), fp)) {
141 /* The format is just "Commit Parent1 Parent2 ...\n" */
142 int len = strlen(buf);
143 int i;
144 struct commit_graft *graft = NULL;
146 if (buf[len-1] == '\n')
147 buf[--len] = 0;
148 if (buf[0] == '#')
149 continue;
150 if ((len + 1) % 41) {
151 bad_graft_data:
152 error("bad graft data: %s", buf);
153 free(graft);
154 continue;
156 i = (len + 1) / 41 - 1;
157 graft = xmalloc(sizeof(*graft) + 20 * i);
158 graft->nr_parent = i;
159 if (get_sha1_hex(buf, graft->sha1))
160 goto bad_graft_data;
161 for (i = 40; i < len; i += 41) {
162 if (buf[i] != ' ')
163 goto bad_graft_data;
164 if (get_sha1_hex(buf + i + 1, graft->parent[i/41]))
165 goto bad_graft_data;
167 i = commit_graft_pos(graft->sha1);
168 if (0 <= i) {
169 error("duplicate graft data: %s", buf);
170 free(graft);
171 continue;
173 i = -i - 1;
174 if (commit_graft_alloc <= ++commit_graft_nr) {
175 commit_graft_alloc = alloc_nr(commit_graft_alloc);
176 commit_graft = xrealloc(commit_graft,
177 sizeof(*commit_graft) *
178 commit_graft_alloc);
180 if (i < commit_graft_nr)
181 memmove(commit_graft + i + 1,
182 commit_graft + i,
183 (commit_graft_nr - i - 1) *
184 sizeof(*commit_graft));
185 commit_graft[i] = graft;
187 fclose(fp);
190 static struct commit_graft *lookup_commit_graft(const unsigned char *sha1)
192 int pos;
193 if (!commit_graft)
194 prepare_commit_graft();
195 pos = commit_graft_pos(sha1);
196 if (pos < 0)
197 return NULL;
198 return commit_graft[pos];
201 int parse_commit_buffer(struct commit *item, void *buffer, unsigned long size)
203 char *bufptr = buffer;
204 unsigned char parent[20];
205 struct commit_list **pptr;
206 struct commit_graft *graft;
207 unsigned n_refs = 0;
209 if (item->object.parsed)
210 return 0;
211 item->object.parsed = 1;
212 if (memcmp(bufptr, "tree ", 5))
213 return error("bogus commit object %s", sha1_to_hex(item->object.sha1));
214 if (get_sha1_hex(bufptr + 5, parent) < 0)
215 return error("bad tree pointer in commit %s\n", sha1_to_hex(item->object.sha1));
216 item->tree = lookup_tree(parent);
217 if (item->tree)
218 n_refs++;
219 bufptr += 46; /* "tree " + "hex sha1" + "\n" */
220 pptr = &item->parents;
222 graft = lookup_commit_graft(item->object.sha1);
223 while (!memcmp(bufptr, "parent ", 7)) {
224 struct commit *new_parent;
226 if (get_sha1_hex(bufptr + 7, parent) || bufptr[47] != '\n')
227 return error("bad parents in commit %s", sha1_to_hex(item->object.sha1));
228 bufptr += 48;
229 if (graft)
230 continue;
231 new_parent = lookup_commit(parent);
232 if (new_parent) {
233 pptr = &commit_list_insert(new_parent, pptr)->next;
234 n_refs++;
237 if (graft) {
238 int i;
239 struct commit *new_parent;
240 for (i = 0; i < graft->nr_parent; i++) {
241 new_parent = lookup_commit(graft->parent[i]);
242 if (!new_parent)
243 continue;
244 pptr = &commit_list_insert(new_parent, pptr)->next;
245 n_refs++;
248 item->date = parse_commit_date(bufptr);
250 if (track_object_refs) {
251 unsigned i = 0;
252 struct commit_list *p;
253 struct object_refs *refs = alloc_object_refs(n_refs);
254 if (item->tree)
255 refs->ref[i++] = &item->tree->object;
256 for (p = item->parents; p; p = p->next)
257 refs->ref[i++] = &p->item->object;
258 set_object_refs(&item->object, refs);
261 return 0;
264 int parse_commit(struct commit *item)
266 char type[20];
267 void *buffer;
268 unsigned long size;
269 int ret;
271 if (item->object.parsed)
272 return 0;
273 buffer = read_sha1_file(item->object.sha1, type, &size);
274 if (!buffer)
275 return error("Could not read %s",
276 sha1_to_hex(item->object.sha1));
277 if (strcmp(type, commit_type)) {
278 free(buffer);
279 return error("Object %s not a commit",
280 sha1_to_hex(item->object.sha1));
282 ret = parse_commit_buffer(item, buffer, size);
283 if (save_commit_buffer && !ret) {
284 item->buffer = buffer;
285 return 0;
287 free(buffer);
288 return ret;
291 struct commit_list *commit_list_insert(struct commit *item, struct commit_list **list_p)
293 struct commit_list *new_list = xmalloc(sizeof(struct commit_list));
294 new_list->item = item;
295 new_list->next = *list_p;
296 *list_p = new_list;
297 return new_list;
300 void free_commit_list(struct commit_list *list)
302 while (list) {
303 struct commit_list *temp = list;
304 list = temp->next;
305 free(temp);
309 struct commit_list * insert_by_date(struct commit *item, struct commit_list **list)
311 struct commit_list **pp = list;
312 struct commit_list *p;
313 while ((p = *pp) != NULL) {
314 if (p->item->date < item->date) {
315 break;
317 pp = &p->next;
319 return commit_list_insert(item, pp);
323 void sort_by_date(struct commit_list **list)
325 struct commit_list *ret = NULL;
326 while (*list) {
327 insert_by_date((*list)->item, &ret);
328 *list = (*list)->next;
330 *list = ret;
333 struct commit *pop_most_recent_commit(struct commit_list **list,
334 unsigned int mark)
336 struct commit *ret = (*list)->item;
337 struct commit_list *parents = ret->parents;
338 struct commit_list *old = *list;
340 *list = (*list)->next;
341 free(old);
343 while (parents) {
344 struct commit *commit = parents->item;
345 parse_commit(commit);
346 if (!(commit->object.flags & mark)) {
347 commit->object.flags |= mark;
348 insert_by_date(commit, list);
350 parents = parents->next;
352 return ret;
355 void clear_commit_marks(struct commit *commit, unsigned int mark)
357 struct commit_list *parents;
359 parents = commit->parents;
360 commit->object.flags &= ~mark;
361 while (parents) {
362 struct commit *parent = parents->item;
363 if (parent && parent->object.parsed &&
364 (parent->object.flags & mark))
365 clear_commit_marks(parent, mark);
366 parents = parents->next;
371 * Generic support for pretty-printing the header
373 static int get_one_line(const char *msg, unsigned long len)
375 int ret = 0;
377 while (len--) {
378 char c = *msg++;
379 ret++;
380 if (c == '\n')
381 break;
382 if (!c)
383 return 0;
385 return ret;
388 static int add_user_info(const char *what, enum cmit_fmt fmt, char *buf, const char *line)
390 char *date;
391 int namelen;
392 unsigned long time;
393 int tz, ret;
394 const char *filler = " ";
396 if (fmt == CMIT_FMT_ONELINE)
397 return 0;
398 date = strchr(line, '>');
399 if (!date)
400 return 0;
401 namelen = ++date - line;
402 time = strtoul(date, &date, 10);
403 tz = strtol(date, NULL, 10);
405 ret = sprintf(buf, "%s: %.*s%.*s\n", what,
406 (fmt == CMIT_FMT_FULLER) ? 4 : 0,
407 filler, namelen, line);
408 switch (fmt) {
409 case CMIT_FMT_MEDIUM:
410 ret += sprintf(buf + ret, "Date: %s\n", show_date(time, tz));
411 break;
412 case CMIT_FMT_FULLER:
413 ret += sprintf(buf + ret, "%sDate: %s\n", what, show_date(time, tz));
414 break;
415 default:
416 /* notin' */
417 break;
419 return ret;
422 static int is_empty_line(const char *line, int len)
424 while (len && isspace(line[len-1]))
425 len--;
426 return !len;
429 static int add_parent_info(enum cmit_fmt fmt, char *buf, const char *line, int parents)
431 int offset = 0;
433 if (fmt == CMIT_FMT_ONELINE)
434 return offset;
435 switch (parents) {
436 case 1:
437 break;
438 case 2:
439 /* Go back to the previous line: 40 characters of previous parent, and one '\n' */
440 offset = sprintf(buf, "Merge: %.40s\n", line-41);
441 /* Fallthrough */
442 default:
443 /* Replace the previous '\n' with a space */
444 buf[offset-1] = ' ';
445 offset += sprintf(buf + offset, "%.40s\n", line+7);
447 return offset;
450 unsigned long pretty_print_commit(enum cmit_fmt fmt, const char *msg, unsigned long len, char *buf, unsigned long space)
452 int hdr = 1, body = 0;
453 unsigned long offset = 0;
454 int parents = 0;
455 int indent = (fmt == CMIT_FMT_ONELINE) ? 0 : 4;
457 for (;;) {
458 const char *line = msg;
459 int linelen = get_one_line(msg, len);
461 if (!linelen)
462 break;
465 * We want some slop for indentation and a possible
466 * final "...". Thus the "+ 20".
468 if (offset + linelen + 20 > space) {
469 memcpy(buf + offset, " ...\n", 8);
470 offset += 8;
471 break;
474 msg += linelen;
475 len -= linelen;
476 if (hdr) {
477 if (linelen == 1) {
478 hdr = 0;
479 if (fmt != CMIT_FMT_ONELINE)
480 buf[offset++] = '\n';
481 continue;
483 if (fmt == CMIT_FMT_RAW) {
484 memcpy(buf + offset, line, linelen);
485 offset += linelen;
486 continue;
488 if (!memcmp(line, "parent ", 7)) {
489 if (linelen != 48)
490 die("bad parent line in commit");
491 offset += add_parent_info(fmt, buf + offset, line, ++parents);
495 * MEDIUM == DEFAULT shows only author with dates.
496 * FULL shows both authors but not dates.
497 * FULLER shows both authors and dates.
499 if (!memcmp(line, "author ", 7))
500 offset += add_user_info("Author", fmt,
501 buf + offset,
502 line + 7);
503 if (!memcmp(line, "committer ", 10) &&
504 (fmt == CMIT_FMT_FULL || fmt == CMIT_FMT_FULLER))
505 offset += add_user_info("Commit", fmt,
506 buf + offset,
507 line + 10);
508 continue;
511 if (is_empty_line(line, linelen)) {
512 if (!body)
513 continue;
514 if (fmt == CMIT_FMT_SHORT)
515 break;
516 } else {
517 body = 1;
520 memset(buf + offset, ' ', indent);
521 memcpy(buf + offset + indent, line, linelen);
522 offset += linelen + indent;
523 if (fmt == CMIT_FMT_ONELINE)
524 break;
526 if (fmt == CMIT_FMT_ONELINE) {
527 /* We do not want the terminating newline */
528 if (buf[offset - 1] == '\n')
529 offset--;
531 else {
532 /* Make sure there is an EOLN */
533 if (buf[offset - 1] != '\n')
534 buf[offset++] = '\n';
536 buf[offset] = '\0';
537 return offset;
540 struct commit *pop_commit(struct commit_list **stack)
542 struct commit_list *top = *stack;
543 struct commit *item = top ? top->item : NULL;
545 if (top) {
546 *stack = top->next;
547 free(top);
549 return item;
552 int count_parents(struct commit * commit)
554 int count = 0;
555 struct commit_list * parents = commit->parents;
556 for (count=0;parents; parents=parents->next,count++)
558 return count;
562 * Performs an in-place topological sort on the list supplied.
564 void sort_in_topological_order(struct commit_list ** list)
566 struct commit_list * next = *list;
567 struct commit_list * work = NULL, **insert;
568 struct commit_list ** pptr = list;
569 struct sort_node * nodes;
570 struct sort_node * next_nodes;
571 int count = 0;
573 /* determine the size of the list */
574 while (next) {
575 next = next->next;
576 count++;
579 if (!count)
580 return;
581 /* allocate an array to help sort the list */
582 nodes = xcalloc(count, sizeof(*nodes));
583 /* link the list to the array */
584 next_nodes = nodes;
585 next=*list;
586 while (next) {
587 next_nodes->list_item = next;
588 next->item->object.util = next_nodes;
589 next_nodes++;
590 next = next->next;
592 /* update the indegree */
593 next=*list;
594 while (next) {
595 struct commit_list * parents = next->item->parents;
596 while (parents) {
597 struct commit * parent=parents->item;
598 struct sort_node * pn = (struct sort_node *)parent->object.util;
600 if (pn)
601 pn->indegree++;
602 parents=parents->next;
604 next=next->next;
607 * find the tips
609 * tips are nodes not reachable from any other node in the list
611 * the tips serve as a starting set for the work queue.
613 next=*list;
614 insert = &work;
615 while (next) {
616 struct sort_node * node = (struct sort_node *)next->item->object.util;
618 if (node->indegree == 0) {
619 insert = &commit_list_insert(next->item, insert)->next;
621 next=next->next;
623 /* process the list in topological order */
624 while (work) {
625 struct commit * work_item = pop_commit(&work);
626 struct sort_node * work_node = (struct sort_node *)work_item->object.util;
627 struct commit_list * parents = work_item->parents;
629 while (parents) {
630 struct commit * parent=parents->item;
631 struct sort_node * pn = (struct sort_node *)parent->object.util;
633 if (pn) {
635 * parents are only enqueued for emission
636 * when all their children have been emitted thereby
637 * guaranteeing topological order.
639 pn->indegree--;
640 if (!pn->indegree)
641 commit_list_insert(parent, &work);
643 parents=parents->next;
646 * work_item is a commit all of whose children
647 * have already been emitted. we can emit it now.
649 *pptr = work_node->list_item;
650 pptr = &(*pptr)->next;
651 *pptr = NULL;
652 work_item->object.util = NULL;
654 free(nodes);