merge.h 4.26 KB
Newer Older
Edward Thomson committed
1
/*
Edward Thomson committed
2
 * Copyright (C) the libgit2 contributors. All rights reserved.
Edward Thomson committed
3 4 5 6 7 8 9
 *
 * This file is part of libgit2, distributed under the GNU GPL v2 with
 * a Linking Exception. For full terms see the included COPYING file.
 */
#ifndef INCLUDE_merge_h__
#define INCLUDE_merge_h__

10
#include "vector.h"
Edward Thomson committed
11 12 13 14 15
#include "commit_list.h"
#include "pool.h"

#include "git2/merge.h"
#include "git2/types.h"
Edward Thomson committed
16 17 18 19

#define GIT_MERGE_MSG_FILE		"MERGE_MSG"
#define GIT_MERGE_MODE_FILE		"MERGE_MODE"

Edward Thomson committed
20 21 22 23 24 25 26
#define GIT_MERGE_TREE_RENAME_THRESHOLD	50
#define GIT_MERGE_TREE_TARGET_LIMIT		1000

/** Types of changes when files are merged from branch to branch. */
typedef enum {
	/* No conflict - a change only occurs in one branch. */
	GIT_MERGE_DIFF_NONE = 0,
nulltoken committed
27

Edward Thomson committed
28 29
	/* Occurs when a file is modified in both branches. */
	GIT_MERGE_DIFF_BOTH_MODIFIED = (1 << 0),
nulltoken committed
30

Edward Thomson committed
31 32
	/* Occurs when a file is added in both branches. */
	GIT_MERGE_DIFF_BOTH_ADDED = (1 << 1),
nulltoken committed
33

Edward Thomson committed
34 35
	/* Occurs when a file is deleted in both branches. */
	GIT_MERGE_DIFF_BOTH_DELETED = (1 << 2),
nulltoken committed
36

Edward Thomson committed
37 38
	/* Occurs when a file is modified in one branch and deleted in the other. */
	GIT_MERGE_DIFF_MODIFIED_DELETED = (1 << 3),
nulltoken committed
39

Edward Thomson committed
40 41
	/* Occurs when a file is renamed in one branch and modified in the other. */
	GIT_MERGE_DIFF_RENAMED_MODIFIED = (1 << 4),
nulltoken committed
42

Edward Thomson committed
43 44
	/* Occurs when a file is renamed in one branch and deleted in the other. */
	GIT_MERGE_DIFF_RENAMED_DELETED = (1 << 5),
nulltoken committed
45

Edward Thomson committed
46 47 48 49
	/* Occurs when a file is renamed in one branch and a file with the same
	 * name is added in the other.  Eg, A->B and new file B.  Core git calls
	 * this a "rename/delete". */
	GIT_MERGE_DIFF_RENAMED_ADDED = (1 << 6),
nulltoken committed
50

Edward Thomson committed
51 52 53
	/* Occurs when both a file is renamed to the same name in the ours and
	 * theirs branches.  Eg, A->B and A->B in both.  Automergeable. */
	GIT_MERGE_DIFF_BOTH_RENAMED = (1 << 7),
nulltoken committed
54

Edward Thomson committed
55 56 57
	/* Occurs when a file is renamed to different names in the ours and theirs
	 * branches.  Eg, A->B and A->C. */
	GIT_MERGE_DIFF_BOTH_RENAMED_1_TO_2 = (1 << 8),
nulltoken committed
58

Edward Thomson committed
59 60 61
	/* Occurs when two files are renamed to the same name in the ours and
	 * theirs branches.  Eg, A->C and B->C. */
	GIT_MERGE_DIFF_BOTH_RENAMED_2_TO_1 = (1 << 9),
nulltoken committed
62

Edward Thomson committed
63 64 65
	/* Occurs when an item at a path in one branch is a directory, and an
	 * item at the same path in a different branch is a file. */
	GIT_MERGE_DIFF_DIRECTORY_FILE = (1 << 10),
nulltoken committed
66

Edward Thomson committed
67 68 69 70 71 72
	/* The child of a folder that is in a directory/file conflict. */
	GIT_MERGE_DIFF_DF_CHILD = (1 << 11),
} git_merge_diff_type_t;


typedef struct {
Linquize committed
73 74
	git_repository *repo;
	git_pool pool;
nulltoken committed
75

Linquize committed
76
	/* Vector of git_index_entry that represent the merged items that
Edward Thomson committed
77 78 79 80
	 * have been staged, either because only one side changed, or because
	 * the two changes were non-conflicting and mergeable.  These items
	 * will be written as staged entries in the main index.
	 */
Linquize committed
81
	git_vector staged;
nulltoken committed
82

Linquize committed
83
	/* Vector of git_merge_diff entries that represent the conflicts that
Edward Thomson committed
84 85 86
	 * have not been automerged.  These items will be written to high-stage
	 * entries in the main index.
	 */
Linquize committed
87
	git_vector conflicts;
nulltoken committed
88

Linquize committed
89
	/* Vector of git_merge_diff that have been automerged.  These items
Edward Thomson committed
90 91
	 * will be written to the REUC when the index is produced.
	 */
Linquize committed
92
	git_vector resolved;
Edward Thomson committed
93 94 95 96 97 98
} git_merge_diff_list;

/**
 * Description of changes to one file across three trees.
 */
typedef struct {
Linquize committed
99
	git_merge_diff_type_t type;
nulltoken committed
100

Linquize committed
101
	git_index_entry ancestor_entry;
nulltoken committed
102

Linquize committed
103 104
	git_index_entry our_entry;
	git_delta_t our_status;
nulltoken committed
105

Linquize committed
106 107
	git_index_entry their_entry;
	git_delta_t their_status;
Edward Thomson committed
108 109
} git_merge_diff;

Edward Thomson committed
110 111 112 113 114 115 116 117 118
/** Internal structure for merge inputs */
struct git_merge_head {
	char *ref_name;
	char *remote_url;

	git_oid oid;
	git_commit *commit;
};

Edward Thomson committed
119 120 121 122 123 124
int git_merge__bases_many(
	git_commit_list **out,
	git_revwalk *walk,
	git_commit_list_node *one,
	git_vector *twos);

Edward Thomson committed
125 126 127 128
/*
 * Three-way tree differencing
 */

Edward Thomson committed
129 130 131 132 133 134 135 136
git_merge_diff_list *git_merge_diff_list__alloc(git_repository *repo);

int git_merge_diff_list__find_differences(git_merge_diff_list *merge_diff_list,
	const git_tree *ancestor_tree,
	const git_tree *ours_tree,
	const git_tree *theirs_tree);

int git_merge_diff_list__find_renames(git_repository *repo, git_merge_diff_list *merge_diff_list, const git_merge_tree_opts *opts);
Edward Thomson committed
137

Edward Thomson committed
138
void git_merge_diff_list__free(git_merge_diff_list *diff_list);
Edward Thomson committed
139

Edward Thomson committed
140 141 142 143 144 145 146 147 148
/* Merge metadata setup */

int git_merge__setup(
	git_repository *repo,
	const git_merge_head *our_head,
	const git_merge_head *their_heads[],
	size_t their_heads_len,
	unsigned int flags);

Edward Thomson committed
149
#endif