Documentation: begin discussion of git-remote in user manual
[git/jrn.git] / builtin-branch.c
blobd3df5a57f127f44d7ff48a419d51ca108c7c9618
1 /*
2 * Builtin "git branch"
4 * Copyright (c) 2006 Kristian Høgsberg <krh@redhat.com>
5 * Based on git-branch.sh by Junio C Hamano.
6 */
8 #include "cache.h"
9 #include "color.h"
10 #include "refs.h"
11 #include "commit.h"
12 #include "builtin.h"
14 static const char builtin_branch_usage[] =
15 "git-branch [-r] (-d | -D) <branchname> | [-l] [-f] <branchname> [<start-point>] | (-m | -M) [<oldbranch>] <newbranch> | [--color | --no-color] [-r | -a] [-v [--abbrev=<length>]]";
17 #define REF_UNKNOWN_TYPE 0x00
18 #define REF_LOCAL_BRANCH 0x01
19 #define REF_REMOTE_BRANCH 0x02
20 #define REF_TAG 0x04
22 static const char *head;
23 static unsigned char head_sha1[20];
25 static int branch_use_color;
26 static char branch_colors[][COLOR_MAXLEN] = {
27 "\033[m", /* reset */
28 "", /* PLAIN (normal) */
29 "\033[31m", /* REMOTE (red) */
30 "", /* LOCAL (normal) */
31 "\033[32m", /* CURRENT (green) */
33 enum color_branch {
34 COLOR_BRANCH_RESET = 0,
35 COLOR_BRANCH_PLAIN = 1,
36 COLOR_BRANCH_REMOTE = 2,
37 COLOR_BRANCH_LOCAL = 3,
38 COLOR_BRANCH_CURRENT = 4,
41 static int parse_branch_color_slot(const char *var, int ofs)
43 if (!strcasecmp(var+ofs, "plain"))
44 return COLOR_BRANCH_PLAIN;
45 if (!strcasecmp(var+ofs, "reset"))
46 return COLOR_BRANCH_RESET;
47 if (!strcasecmp(var+ofs, "remote"))
48 return COLOR_BRANCH_REMOTE;
49 if (!strcasecmp(var+ofs, "local"))
50 return COLOR_BRANCH_LOCAL;
51 if (!strcasecmp(var+ofs, "current"))
52 return COLOR_BRANCH_CURRENT;
53 die("bad config variable '%s'", var);
56 int git_branch_config(const char *var, const char *value)
58 if (!strcmp(var, "color.branch")) {
59 branch_use_color = git_config_colorbool(var, value);
60 return 0;
62 if (!strncmp(var, "color.branch.", 13)) {
63 int slot = parse_branch_color_slot(var, 13);
64 color_parse(value, var, branch_colors[slot]);
65 return 0;
67 return git_default_config(var, value);
70 const char *branch_get_color(enum color_branch ix)
72 if (branch_use_color)
73 return branch_colors[ix];
74 return "";
77 static int delete_branches(int argc, const char **argv, int force, int kinds)
79 struct commit *rev, *head_rev = head_rev;
80 unsigned char sha1[20];
81 char *name = NULL;
82 const char *fmt, *remote;
83 int i;
84 int ret = 0;
86 switch (kinds) {
87 case REF_REMOTE_BRANCH:
88 fmt = "refs/remotes/%s";
89 remote = "remote ";
90 force = 1;
91 break;
92 case REF_LOCAL_BRANCH:
93 fmt = "refs/heads/%s";
94 remote = "";
95 break;
96 default:
97 die("cannot use -a with -d");
100 if (!force) {
101 head_rev = lookup_commit_reference(head_sha1);
102 if (!head_rev)
103 die("Couldn't look up commit object for HEAD");
105 for (i = 0; i < argc; i++) {
106 if (kinds == REF_LOCAL_BRANCH && !strcmp(head, argv[i])) {
107 error("Cannot delete the branch '%s' "
108 "which you are currently on.", argv[i]);
109 ret = 1;
110 continue;
113 if (name)
114 free(name);
116 name = xstrdup(mkpath(fmt, argv[i]));
117 if (!resolve_ref(name, sha1, 1, NULL)) {
118 error("%sbranch '%s' not found.",
119 remote, argv[i]);
120 ret = 1;
121 continue;
124 rev = lookup_commit_reference(sha1);
125 if (!rev) {
126 error("Couldn't look up commit object for '%s'", name);
127 ret = 1;
128 continue;
131 /* This checks whether the merge bases of branch and
132 * HEAD contains branch -- which means that the HEAD
133 * contains everything in both.
136 if (!force &&
137 !in_merge_bases(rev, head_rev)) {
138 error("The branch '%s' is not a strict subset of "
139 "your current HEAD.\n"
140 "If you are sure you want to delete it, "
141 "run 'git branch -D %s'.", argv[i], argv[i]);
142 ret = 1;
143 continue;
146 if (delete_ref(name, sha1)) {
147 error("Error deleting %sbranch '%s'", remote,
148 argv[i]);
149 ret = 1;
150 } else
151 printf("Deleted %sbranch %s.\n", remote, argv[i]);
155 if (name)
156 free(name);
158 return(ret);
161 struct ref_item {
162 char *name;
163 unsigned int kind;
164 unsigned char sha1[20];
167 struct ref_list {
168 int index, alloc, maxwidth;
169 struct ref_item *list;
170 int kinds;
173 static int append_ref(const char *refname, const unsigned char *sha1, int flags, void *cb_data)
175 struct ref_list *ref_list = (struct ref_list*)(cb_data);
176 struct ref_item *newitem;
177 int kind = REF_UNKNOWN_TYPE;
178 int len;
180 /* Detect kind */
181 if (!strncmp(refname, "refs/heads/", 11)) {
182 kind = REF_LOCAL_BRANCH;
183 refname += 11;
184 } else if (!strncmp(refname, "refs/remotes/", 13)) {
185 kind = REF_REMOTE_BRANCH;
186 refname += 13;
187 } else if (!strncmp(refname, "refs/tags/", 10)) {
188 kind = REF_TAG;
189 refname += 10;
192 /* Don't add types the caller doesn't want */
193 if ((kind & ref_list->kinds) == 0)
194 return 0;
196 /* Resize buffer */
197 if (ref_list->index >= ref_list->alloc) {
198 ref_list->alloc = alloc_nr(ref_list->alloc);
199 ref_list->list = xrealloc(ref_list->list,
200 ref_list->alloc * sizeof(struct ref_item));
203 /* Record the new item */
204 newitem = &(ref_list->list[ref_list->index++]);
205 newitem->name = xstrdup(refname);
206 newitem->kind = kind;
207 hashcpy(newitem->sha1, sha1);
208 len = strlen(newitem->name);
209 if (len > ref_list->maxwidth)
210 ref_list->maxwidth = len;
212 return 0;
215 static void free_ref_list(struct ref_list *ref_list)
217 int i;
219 for (i = 0; i < ref_list->index; i++)
220 free(ref_list->list[i].name);
221 free(ref_list->list);
224 static int ref_cmp(const void *r1, const void *r2)
226 struct ref_item *c1 = (struct ref_item *)(r1);
227 struct ref_item *c2 = (struct ref_item *)(r2);
229 if (c1->kind != c2->kind)
230 return c1->kind - c2->kind;
231 return strcmp(c1->name, c2->name);
234 static void print_ref_item(struct ref_item *item, int maxwidth, int verbose,
235 int abbrev, int current)
237 char c;
238 int color;
239 struct commit *commit;
240 char subject[256];
242 switch (item->kind) {
243 case REF_LOCAL_BRANCH:
244 color = COLOR_BRANCH_LOCAL;
245 break;
246 case REF_REMOTE_BRANCH:
247 color = COLOR_BRANCH_REMOTE;
248 break;
249 default:
250 color = COLOR_BRANCH_PLAIN;
251 break;
254 c = ' ';
255 if (current) {
256 c = '*';
257 color = COLOR_BRANCH_CURRENT;
260 if (verbose) {
261 commit = lookup_commit(item->sha1);
262 if (commit && !parse_commit(commit))
263 pretty_print_commit(CMIT_FMT_ONELINE, commit, ~0,
264 subject, sizeof(subject), 0,
265 NULL, NULL, 0);
266 else
267 strcpy(subject, " **** invalid ref ****");
268 printf("%c %s%-*s%s %s %s\n", c, branch_get_color(color),
269 maxwidth, item->name,
270 branch_get_color(COLOR_BRANCH_RESET),
271 find_unique_abbrev(item->sha1, abbrev), subject);
272 } else {
273 printf("%c %s%s%s\n", c, branch_get_color(color), item->name,
274 branch_get_color(COLOR_BRANCH_RESET));
278 static void print_ref_list(int kinds, int verbose, int abbrev)
280 int i;
281 struct ref_list ref_list;
283 memset(&ref_list, 0, sizeof(ref_list));
284 ref_list.kinds = kinds;
285 for_each_ref(append_ref, &ref_list);
287 qsort(ref_list.list, ref_list.index, sizeof(struct ref_item), ref_cmp);
289 for (i = 0; i < ref_list.index; i++) {
290 int current = (ref_list.list[i].kind == REF_LOCAL_BRANCH) &&
291 !strcmp(ref_list.list[i].name, head);
292 print_ref_item(&ref_list.list[i], ref_list.maxwidth, verbose,
293 abbrev, current);
296 free_ref_list(&ref_list);
299 static void create_branch(const char *name, const char *start,
300 int force, int reflog)
302 struct ref_lock *lock;
303 struct commit *commit;
304 unsigned char sha1[20];
305 char ref[PATH_MAX], msg[PATH_MAX + 20];
307 snprintf(ref, sizeof ref, "refs/heads/%s", name);
308 if (check_ref_format(ref))
309 die("'%s' is not a valid branch name.", name);
311 if (resolve_ref(ref, sha1, 1, NULL)) {
312 if (!force)
313 die("A branch named '%s' already exists.", name);
314 else if (!strcmp(head, name))
315 die("Cannot force update the current branch.");
318 if (get_sha1(start, sha1) ||
319 (commit = lookup_commit_reference(sha1)) == NULL)
320 die("Not a valid branch point: '%s'.", start);
321 hashcpy(sha1, commit->object.sha1);
323 lock = lock_any_ref_for_update(ref, NULL);
324 if (!lock)
325 die("Failed to lock ref for update: %s.", strerror(errno));
327 if (reflog) {
328 log_all_ref_updates = 1;
329 snprintf(msg, sizeof msg, "branch: Created from %s", start);
332 if (write_ref_sha1(lock, sha1, msg) < 0)
333 die("Failed to write ref: %s.", strerror(errno));
336 static void rename_branch(const char *oldname, const char *newname, int force)
338 char oldref[PATH_MAX], newref[PATH_MAX], logmsg[PATH_MAX*2 + 100];
339 unsigned char sha1[20];
341 if (snprintf(oldref, sizeof(oldref), "refs/heads/%s", oldname) > sizeof(oldref))
342 die("Old branchname too long");
344 if (check_ref_format(oldref))
345 die("Invalid branch name: %s", oldref);
347 if (snprintf(newref, sizeof(newref), "refs/heads/%s", newname) > sizeof(newref))
348 die("New branchname too long");
350 if (check_ref_format(newref))
351 die("Invalid branch name: %s", newref);
353 if (resolve_ref(newref, sha1, 1, NULL) && !force)
354 die("A branch named '%s' already exists.", newname);
356 snprintf(logmsg, sizeof(logmsg), "Branch: renamed %s to %s",
357 oldref, newref);
359 if (rename_ref(oldref, newref, logmsg))
360 die("Branch rename failed");
362 if (!strcmp(oldname, head) && create_symref("HEAD", newref))
363 die("Branch renamed to %s, but HEAD is not updated!", newname);
366 int cmd_branch(int argc, const char **argv, const char *prefix)
368 int delete = 0, force_delete = 0, force_create = 0;
369 int rename = 0, force_rename = 0;
370 int verbose = 0, abbrev = DEFAULT_ABBREV;
371 int reflog = 0;
372 int kinds = REF_LOCAL_BRANCH;
373 int i;
375 setup_ident();
376 git_config(git_branch_config);
378 for (i = 1; i < argc; i++) {
379 const char *arg = argv[i];
381 if (arg[0] != '-')
382 break;
383 if (!strcmp(arg, "--")) {
384 i++;
385 break;
387 if (!strcmp(arg, "-d")) {
388 delete = 1;
389 continue;
391 if (!strcmp(arg, "-D")) {
392 delete = 1;
393 force_delete = 1;
394 continue;
396 if (!strcmp(arg, "-f")) {
397 force_create = 1;
398 continue;
400 if (!strcmp(arg, "-m")) {
401 rename = 1;
402 continue;
404 if (!strcmp(arg, "-M")) {
405 rename = 1;
406 force_rename = 1;
407 continue;
409 if (!strcmp(arg, "-r")) {
410 kinds = REF_REMOTE_BRANCH;
411 continue;
413 if (!strcmp(arg, "-a")) {
414 kinds = REF_REMOTE_BRANCH | REF_LOCAL_BRANCH;
415 continue;
417 if (!strcmp(arg, "-l")) {
418 reflog = 1;
419 continue;
421 if (!strncmp(arg, "--abbrev=", 9)) {
422 abbrev = atoi(arg+9);
423 continue;
425 if (!strcmp(arg, "-v")) {
426 verbose = 1;
427 continue;
429 if (!strcmp(arg, "--color")) {
430 branch_use_color = 1;
431 continue;
433 if (!strcmp(arg, "--no-color")) {
434 branch_use_color = 0;
435 continue;
437 usage(builtin_branch_usage);
440 if ((delete && rename) || (delete && force_create) ||
441 (rename && force_create))
442 usage(builtin_branch_usage);
444 head = xstrdup(resolve_ref("HEAD", head_sha1, 0, NULL));
445 if (!head)
446 die("Failed to resolve HEAD as a valid ref.");
447 if (strncmp(head, "refs/heads/", 11))
448 die("HEAD not found below refs/heads!");
449 head += 11;
451 if (delete)
452 return delete_branches(argc - i, argv + i, force_delete, kinds);
453 else if (i == argc)
454 print_ref_list(kinds, verbose, abbrev);
455 else if (rename && (i == argc - 1))
456 rename_branch(head, argv[i], force_rename);
457 else if (rename && (i == argc - 2))
458 rename_branch(argv[i], argv[i + 1], force_rename);
459 else if (i == argc - 1)
460 create_branch(argv[i], head, force_create, reflog);
461 else if (i == argc - 2)
462 create_branch(argv[i], argv[i + 1], force_create, reflog);
463 else
464 usage(builtin_branch_usage);
466 return 0;