worktree.c 12.9 KB
Newer Older
1 2 3 4 5 6 7
/*
 * Copyright (C) the libgit2 contributors. All rights reserved.
 *
 * This file is part of libgit2, distributed under the GNU GPL v2 with
 * a Linking Exception. For full terms see the included COPYING file.
 */

8
#include "worktree.h"
9 10 11

#include "git2/branch.h"
#include "git2/commit.h"
12 13 14 15
#include "git2/worktree.h"

#include "repository.h"

16
static bool is_worktree_dir(const char *dir)
17
{
18 19 20 21 22 23 24 25 26 27
	git_buf buf = GIT_BUF_INIT;
	int error;

	if (git_buf_sets(&buf, dir) < 0)
		return -1;

	error = git_path_contains_file(&buf, "commondir")
		&& git_path_contains_file(&buf, "gitdir")
		&& git_path_contains_file(&buf, "HEAD");

28
	git_buf_dispose(&buf);
29
	return error;
30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57
}

int git_worktree_list(git_strarray *wts, git_repository *repo)
{
	git_vector worktrees = GIT_VECTOR_INIT;
	git_buf path = GIT_BUF_INIT;
	char *worktree;
	unsigned i, len;
	int error;

	assert(wts && repo);

	wts->count = 0;
	wts->strings = NULL;

	if ((error = git_buf_printf(&path, "%s/worktrees/", repo->commondir)) < 0)
		goto exit;
	if (!git_path_exists(path.ptr) || git_path_is_empty_dir(path.ptr))
		goto exit;
	if ((error = git_path_dirload(&worktrees, path.ptr, path.size, 0x0)) < 0)
		goto exit;

	len = path.size;

	git_vector_foreach(&worktrees, i, worktree) {
		git_buf_truncate(&path, len);
		git_buf_puts(&path, worktree);

58
		if (!is_worktree_dir(path.ptr)) {
59 60 61 62 63 64 65 66
			git_vector_remove(&worktrees, i);
			git__free(worktree);
		}
	}

	wts->strings = (char **)git_vector_detach(&wts->count, NULL, &worktrees);

exit:
67
	git_buf_dispose(&path);
68 69 70

	return error;
}
71

72
char *git_worktree__read_link(const char *base, const char *file)
73 74 75 76 77 78 79 80 81
{
	git_buf path = GIT_BUF_INIT, buf = GIT_BUF_INIT;

	assert(base && file);

	if (git_buf_joinpath(&path, base, file) < 0)
		goto err;
	if (git_futils_readbuffer(&buf, path.ptr) < 0)
		goto err;
82
	git_buf_dispose(&path);
83 84 85 86 87 88 89 90 91 92

	git_buf_rtrim(&buf);

	if (!git_path_is_relative(buf.ptr))
		return git_buf_detach(&buf);

	if (git_buf_sets(&path, base) < 0)
		goto err;
	if (git_path_apply_relative(&path, buf.ptr) < 0)
		goto err;
93
	git_buf_dispose(&buf);
94 95 96 97

	return git_buf_detach(&path);

err:
98 99
	git_buf_dispose(&buf);
	git_buf_dispose(&path);
100 101 102 103

	return NULL;
}

104 105 106 107 108 109 110 111 112 113 114 115 116 117
static int write_wtfile(const char *base, const char *file, const git_buf *buf)
{
	git_buf path = GIT_BUF_INIT;
	int err;

	assert(base && file && buf);

	if ((err = git_buf_joinpath(&path, base, file)) < 0)
		goto out;

	if ((err = git_futils_writebuffer(buf, path.ptr, O_CREAT|O_EXCL|O_WRONLY, 0644)) < 0)
		goto out;

out:
118
	git_buf_dispose(&path);
119 120 121 122

	return err;
}

123
static int open_worktree_dir(git_worktree **out, const char *parent, const char *dir, const char *name)
124
{
125
	git_buf gitdir = GIT_BUF_INIT;
126
	git_worktree *wt = NULL;
127
	int error = 0;
128

129
	if (!is_worktree_dir(dir)) {
130 131 132 133
		error = -1;
		goto out;
	}

134
	if ((wt = git__calloc(1, sizeof(*wt))) == NULL) {
135 136 137 138 139
		error = -1;
		goto out;
	}

	if ((wt->name = git__strdup(name)) == NULL
140 141
	    || (wt->commondir_path = git_worktree__read_link(dir, "commondir")) == NULL
	    || (wt->gitlink_path = git_worktree__read_link(dir, "gitdir")) == NULL
142
	    || (parent && (wt->parent_path = git__strdup(parent)) == NULL)
143
	    || (wt->worktree_path = git_path_dirname(wt->gitlink_path)) == NULL) {
144 145 146
		error = -1;
		goto out;
	}
147 148 149 150 151

	if ((error = git_path_prettify_dir(&gitdir, dir, NULL)) < 0)
		goto out;
	wt->gitdir_path = git_buf_detach(&gitdir);

152
	wt->locked = !!git_worktree_is_locked(NULL, wt);
153

154 155 156 157 158
	*out = wt;

out:
	if (error)
		git_worktree_free(wt);
159
	git_buf_dispose(&gitdir);
160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176

	return error;
}

int git_worktree_lookup(git_worktree **out, git_repository *repo, const char *name)
{
	git_buf path = GIT_BUF_INIT;
	git_worktree *wt = NULL;
	int error;

	assert(repo && name);

	*out = NULL;

	if ((error = git_buf_printf(&path, "%s/worktrees/%s", repo->commondir, name)) < 0)
		goto out;

177
	if ((error = (open_worktree_dir(out, git_repository_workdir(repo), path.ptr, name))) < 0)
178
		goto out;
179 180

out:
181
	git_buf_dispose(&path);
182 183 184 185 186 187 188

	if (error)
		git_worktree_free(wt);

	return error;
}

189 190 191 192 193 194 195 196
int git_worktree_open_from_repository(git_worktree **out, git_repository *repo)
{
	git_buf parent = GIT_BUF_INIT;
	const char *gitdir, *commondir;
	char *name = NULL;
	int error = 0;

	if (!git_repository_is_worktree(repo)) {
197
		git_error_set(GIT_ERROR_WORKTREE, "cannot open worktree of a non-worktree repo");
198 199 200 201 202 203 204
		error = -1;
		goto out;
	}

	gitdir = git_repository_path(repo);
	commondir = git_repository_commondir(repo);

205
	if ((error = git_path_prettify_dir(&parent, "..", commondir)) < 0)
206 207 208 209 210 211 212 213 214
		goto out;

	/* The name is defined by the last component in '.git/worktree/%s' */
	name = git_path_basename(gitdir);

	if ((error = open_worktree_dir(out, parent.ptr, gitdir, name)) < 0)
		goto out;

out:
215
	git__free(name);
216
	git_buf_dispose(&parent);
217 218 219 220

	return error;
}

221 222 223 224 225 226
void git_worktree_free(git_worktree *wt)
{
	if (!wt)
		return;

	git__free(wt->commondir_path);
227
	git__free(wt->worktree_path);
228 229 230 231 232 233
	git__free(wt->gitlink_path);
	git__free(wt->gitdir_path);
	git__free(wt->parent_path);
	git__free(wt->name);
	git__free(wt);
}
234 235 236 237 238

int git_worktree_validate(const git_worktree *wt)
{
	assert(wt);

239
	if (!is_worktree_dir(wt->gitdir_path)) {
240
		git_error_set(GIT_ERROR_WORKTREE,
241 242
			"Worktree gitdir ('%s') is not valid",
			wt->gitlink_path);
243
		return GIT_ERROR;
244 245
	}

246
	if (wt->parent_path && !git_path_exists(wt->parent_path)) {
247
		git_error_set(GIT_ERROR_WORKTREE,
248 249
			"Worktree parent directory ('%s') does not exist ",
			wt->parent_path);
250
		return GIT_ERROR;
251 252 253
	}

	if (!git_path_exists(wt->commondir_path)) {
254
		git_error_set(GIT_ERROR_WORKTREE,
255 256
			"Worktree common directory ('%s') does not exist ",
			wt->commondir_path);
257
		return GIT_ERROR;
258 259
	}

260
	return 0;
261
}
262

263 264 265 266 267 268 269 270 271 272 273
int git_worktree_add_init_options(git_worktree_add_options *opts,
	unsigned int version)
{
	GIT_INIT_STRUCTURE_FROM_TEMPLATE(opts, version,
		git_worktree_add_options, GIT_WORKTREE_ADD_OPTIONS_INIT);
	return 0;
}

int git_worktree_add(git_worktree **out, git_repository *repo,
	const char *name, const char *worktree,
	const git_worktree_add_options *opts)
274
{
275
	git_buf gitdir = GIT_BUF_INIT, wddir = GIT_BUF_INIT, buf = GIT_BUF_INIT;
276 277 278 279
	git_reference *ref = NULL, *head = NULL;
	git_commit *commit = NULL;
	git_repository *wt = NULL;
	git_checkout_options coopts = GIT_CHECKOUT_OPTIONS_INIT;
280
	git_worktree_add_options wtopts = GIT_WORKTREE_ADD_OPTIONS_INIT;
281 282
	int err;

283
	GIT_ERROR_CHECK_VERSION(
284 285 286 287 288
		opts, GIT_WORKTREE_ADD_OPTIONS_VERSION, "git_worktree_add_options");

	if (opts)
		memcpy(&wtopts, opts, sizeof(wtopts));

289 290 291 292
	assert(out && repo && name && worktree);

	*out = NULL;

293 294
	/* Create gitdir directory ".git/worktrees/<name>" */
	if ((err = git_buf_joinpath(&gitdir, repo->commondir, "worktrees")) < 0)
295
		goto out;
296 297
	if (!git_path_exists(gitdir.ptr))
		if ((err = git_futils_mkdir(gitdir.ptr, 0755, GIT_MKDIR_EXCL)) < 0)
298
			goto out;
299
	if ((err = git_buf_joinpath(&gitdir, gitdir.ptr, name)) < 0)
300
		goto out;
301
	if ((err = git_futils_mkdir(gitdir.ptr, 0755, GIT_MKDIR_EXCL)) < 0)
302
		goto out;
303 304
	if ((err = git_path_prettify_dir(&gitdir, gitdir.ptr, NULL)) < 0)
		goto out;
305 306 307 308

	/* Create worktree work dir */
	if ((err = git_futils_mkdir(worktree, 0755, GIT_MKDIR_EXCL)) < 0)
		goto out;
309 310
	if ((err = git_path_prettify_dir(&wddir, worktree, NULL)) < 0)
		goto out;
311

312 313 314 315 316 317 318 319 320 321 322 323 324 325 326
	if (wtopts.lock) {
		int fd;

		if ((err = git_buf_joinpath(&buf, gitdir.ptr, "locked")) < 0)
			goto out;

		if ((fd = p_creat(buf.ptr, 0644)) < 0) {
			err = fd;
			goto out;
		}

		p_close(fd);
		git_buf_clear(&buf);
	}

327
	/* Create worktree .git file */
328
	if ((err = git_buf_printf(&buf, "gitdir: %s\n", gitdir.ptr)) < 0)
329
		goto out;
330
	if ((err = write_wtfile(wddir.ptr, ".git", &buf)) < 0)
331 332
		goto out;

333
	/* Create gitdir files */
334
	if ((err = git_path_prettify_dir(&buf, repo->commondir, NULL) < 0)
335
	    || (err = git_buf_putc(&buf, '\n')) < 0
336
	    || (err = write_wtfile(gitdir.ptr, "commondir", &buf)) < 0)
337
		goto out;
338
	if ((err = git_buf_joinpath(&buf, wddir.ptr, ".git")) < 0
339
	    || (err = git_buf_putc(&buf, '\n')) < 0
340
	    || (err = write_wtfile(gitdir.ptr, "gitdir", &buf)) < 0)
341 342
		goto out;

343 344 345
	/* Set up worktree reference */
	if (wtopts.ref) {
		if (!git_reference_is_branch(wtopts.ref)) {
346
			git_error_set(GIT_ERROR_WORKTREE, "reference is not a branch");
347 348 349 350 351
			err = -1;
			goto out;
		}

		if (git_branch_is_checked_out(wtopts.ref)) {
352
			git_error_set(GIT_ERROR_WORKTREE, "reference is already checked out");
353 354 355 356 357 358 359 360 361 362 363 364 365 366
			err = -1;
			goto out;
		}

		if ((err = git_reference_dup(&ref, wtopts.ref)) < 0)
			goto out;
	} else {
		if ((err = git_repository_head(&head, repo)) < 0)
			goto out;
		if ((err = git_commit_lookup(&commit, repo, &head->target.oid)) < 0)
			goto out;
		if ((err = git_branch_create(&ref, repo, name, commit, false)) < 0)
			goto out;
	}
367 368

	/* Set worktree's HEAD */
369
	if ((err = git_repository_create_head(gitdir.ptr, git_reference_name(ref))) < 0)
370
		goto out;
371
	if ((err = git_repository_open(&wt, wddir.ptr)) < 0)
372 373 374 375 376 377 378 379 380 381 382 383
		goto out;

	/* Checkout worktree's HEAD */
	coopts.checkout_strategy = GIT_CHECKOUT_FORCE;
	if ((err = git_checkout_head(wt, &coopts)) < 0)
		goto out;

	/* Load result */
	if ((err = git_worktree_lookup(out, repo, name)) < 0)
		goto out;

out:
384 385 386
	git_buf_dispose(&gitdir);
	git_buf_dispose(&wddir);
	git_buf_dispose(&buf);
387 388 389 390 391 392 393
	git_reference_free(ref);
	git_reference_free(head);
	git_commit_free(commit);
	git_repository_free(wt);

	return err;
}
394

395
int git_worktree_lock(git_worktree *wt, const char *reason)
396 397 398 399 400 401 402 403 404 405 406 407
{
	git_buf buf = GIT_BUF_INIT, path = GIT_BUF_INIT;
	int err;

	assert(wt);

	if ((err = git_worktree_is_locked(NULL, wt)) < 0)
		goto out;

	if ((err = git_buf_joinpath(&path, wt->gitdir_path, "locked")) < 0)
		goto out;

408 409
	if (reason)
		git_buf_attach_notowned(&buf, reason, strlen(reason));
410 411 412 413 414 415 416

	if ((err = git_futils_writebuffer(&buf, path.ptr, O_CREAT|O_EXCL|O_WRONLY, 0644)) < 0)
		goto out;

	wt->locked = 1;

out:
417
	git_buf_dispose(&path);
418 419 420 421 422 423 424 425 426 427 428

	return err;
}

int git_worktree_unlock(git_worktree *wt)
{
	git_buf path = GIT_BUF_INIT;

	assert(wt);

	if (!git_worktree_is_locked(NULL, wt))
429
		return 1;
430 431 432 433 434

	if (git_buf_joinpath(&path, wt->gitdir_path, "locked") < 0)
		return -1;

	if (p_unlink(path.ptr) != 0) {
435
		git_buf_dispose(&path);
436 437 438 439 440
		return -1;
	}

	wt->locked = 0;

441
	git_buf_dispose(&path);
442 443 444 445 446 447 448 449 450 451 452 453 454 455 456 457 458 459 460 461

	return 0;
}

int git_worktree_is_locked(git_buf *reason, const git_worktree *wt)
{
	git_buf path = GIT_BUF_INIT;
	int ret;

	assert(wt);

	if (reason)
		git_buf_clear(reason);

	if ((ret = git_buf_joinpath(&path, wt->gitdir_path, "locked")) < 0)
		goto out;
	if ((ret = git_path_exists(path.ptr)) && reason)
		git_futils_readbuffer(reason, path.ptr);

out:
462
	git_buf_dispose(&path);
463 464 465

	return ret;
}
466

467 468 469 470 471 472 473 474 475 476 477 478
const char *git_worktree_name(const git_worktree *wt)
{
	assert(wt);
	return wt->name;
}

const char *git_worktree_path(const git_worktree *wt)
{
	assert(wt);
	return wt->worktree_path;
}

479 480 481 482 483 484 485 486 487 488 489
int git_worktree_prune_init_options(
	git_worktree_prune_options *opts,
	unsigned int version)
{
	GIT_INIT_STRUCTURE_FROM_TEMPLATE(opts, version,
		git_worktree_prune_options, GIT_WORKTREE_PRUNE_OPTIONS_INIT);
	return 0;
}

int git_worktree_is_prunable(git_worktree *wt,
	git_worktree_prune_options *opts)
490
{
491
	git_buf reason = GIT_BUF_INIT;
492 493
	git_worktree_prune_options popts = GIT_WORKTREE_PRUNE_OPTIONS_INIT;

494
	GIT_ERROR_CHECK_VERSION(
495 496 497 498 499
		opts, GIT_WORKTREE_PRUNE_OPTIONS_VERSION,
		"git_worktree_prune_options");

	if (opts)
		memcpy(&popts, opts, sizeof(popts));
500

501
	if ((popts.flags & GIT_WORKTREE_PRUNE_LOCKED) == 0 &&
502 503 504 505
		git_worktree_is_locked(&reason, wt))
	{
		if (!reason.size)
			git_buf_attach_notowned(&reason, "no reason given", 15);
506
		git_error_set(GIT_ERROR_WORKTREE, "Not pruning locked working tree: '%s'", reason.ptr);
507
		git_buf_dispose(&reason);
508

509
		return 0;
510 511
	}

512
	if ((popts.flags & GIT_WORKTREE_PRUNE_VALID) == 0 &&
513 514
		git_worktree_validate(wt) == 0)
	{
515
		git_error_set(GIT_ERROR_WORKTREE, "Not pruning valid working tree");
516 517 518 519 520 521
		return 0;
	}

	return 1;
}

522 523
int git_worktree_prune(git_worktree *wt,
	git_worktree_prune_options *opts)
524
{
525
	git_worktree_prune_options popts = GIT_WORKTREE_PRUNE_OPTIONS_INIT;
526 527 528 529
	git_buf path = GIT_BUF_INIT;
	char *wtpath;
	int err;

530
	GIT_ERROR_CHECK_VERSION(
531 532 533 534 535 536 537
		opts, GIT_WORKTREE_PRUNE_OPTIONS_VERSION,
		"git_worktree_prune_options");

	if (opts)
		memcpy(&popts, opts, sizeof(popts));

	if (!git_worktree_is_prunable(wt, &popts)) {
538 539 540 541 542
		err = -1;
		goto out;
	}

	/* Delete gitdir in parent repository */
543
	if ((err = git_buf_printf(&path, "%s/worktrees/%s", wt->commondir_path, wt->name)) < 0)
544 545 546
		goto out;
	if (!git_path_exists(path.ptr))
	{
547
		git_error_set(GIT_ERROR_WORKTREE, "Worktree gitdir '%s' does not exist", path.ptr);
548 549 550 551 552 553 554 555
		err = -1;
		goto out;
	}
	if ((err = git_futils_rmdir_r(path.ptr, NULL, GIT_RMDIR_REMOVE_FILES)) < 0)
		goto out;

	/* Skip deletion of the actual working tree if it does
	 * not exist or deletion was not requested */
556
	if ((popts.flags & GIT_WORKTREE_PRUNE_WORKING_TREE) == 0 ||
557 558 559 560 561 562 563 564 565 566
		!git_path_exists(wt->gitlink_path))
	{
		goto out;
	}

	if ((wtpath = git_path_dirname(wt->gitlink_path)) == NULL)
		goto out;
	git_buf_attach(&path, wtpath, 0);
	if (!git_path_exists(path.ptr))
	{
567
		git_error_set(GIT_ERROR_WORKTREE, "Working tree '%s' does not exist", path.ptr);
568 569 570 571 572 573 574
		err = -1;
		goto out;
	}
	if ((err = git_futils_rmdir_r(path.ptr, NULL, GIT_RMDIR_REMOVE_FILES)) < 0)
		goto out;

out:
575
	git_buf_dispose(&path);
576 577 578

	return err;
}