2 * Copyright (C) the libgit2 contributors. All rights reserved.
4 * This file is part of libgit2, distributed under the GNU GPL v2 with
5 * a Linking Exception. For full terms see the included COPYING file.
7 #ifndef INCLUDE_diff_h__
8 #define INCLUDE_diff_h__
10 #include "git2/diff.h"
11 #include "git2/sys/diff.h"
18 #include "repository.h"
22 #define DIFF_OLD_PREFIX_DEFAULT "a/"
23 #define DIFF_NEW_PREFIX_DEFAULT "b/"
26 GIT_DIFFCAPS_HAS_SYMLINKS
= (1 << 0), /* symlinks on platform? */
27 GIT_DIFFCAPS_IGNORE_STAT
= (1 << 1), /* use stat? */
28 GIT_DIFFCAPS_TRUST_MODE_BITS
= (1 << 2), /* use st_mode? */
29 GIT_DIFFCAPS_TRUST_CTIME
= (1 << 3), /* use st_ctime? */
30 GIT_DIFFCAPS_USE_DEV
= (1 << 4), /* use st_dev? */
33 #define DIFF_FLAGS_KNOWN_BINARY (GIT_DIFF_FLAG_BINARY|GIT_DIFF_FLAG_NOT_BINARY)
34 #define DIFF_FLAGS_NOT_BINARY (GIT_DIFF_FLAG_NOT_BINARY|GIT_DIFF_FLAG__NO_DATA)
37 GIT_DIFF_FLAG__FREE_PATH
= (1 << 7), /* `path` is allocated memory */
38 GIT_DIFF_FLAG__FREE_DATA
= (1 << 8), /* internal file data is allocated */
39 GIT_DIFF_FLAG__UNMAP_DATA
= (1 << 9), /* internal file data is mmap'ed */
40 GIT_DIFF_FLAG__NO_DATA
= (1 << 10), /* file data should not be loaded */
41 GIT_DIFF_FLAG__FREE_BLOB
= (1 << 11), /* release the blob when done */
42 GIT_DIFF_FLAG__LOADED
= (1 << 12), /* file data has been loaded */
44 GIT_DIFF_FLAG__TO_DELETE
= (1 << 16), /* delete entry during rename det. */
45 GIT_DIFF_FLAG__TO_SPLIT
= (1 << 17), /* split entry during rename det. */
46 GIT_DIFF_FLAG__IS_RENAME_TARGET
= (1 << 18),
47 GIT_DIFF_FLAG__IS_RENAME_SOURCE
= (1 << 19),
48 GIT_DIFF_FLAG__HAS_SELF_SIMILARITY
= (1 << 20),
51 #define GIT_DIFF_FLAG__CLEAR_INTERNAL(F) (F) = ((F) & 0x00FFFF)
53 #define GIT_DIFF__VERBOSE (1 << 30)
58 git_diff_options opts
;
60 git_vector deltas
; /* vector of git_diff_delta */
62 git_iterator_type_t old_src
;
63 git_iterator_type_t new_src
;
65 git_diff_perfdata perf
;
68 int (*strcomp
)(const char *, const char *);
69 int (*strncomp
)(const char *, const char *, size_t);
70 int (*pfxcomp
)(const char *str
, const char *pfx
);
71 int (*entrycomp
)(const void *a
, const void *b
);
74 extern void git_diff__cleanup_modes(
75 uint32_t diffcaps
, uint32_t *omode
, uint32_t *nmode
);
77 extern void git_diff_addref(git_diff
*diff
);
79 extern int git_diff_delta__cmp(const void *a
, const void *b
);
80 extern int git_diff_delta__casecmp(const void *a
, const void *b
);
82 extern const char *git_diff_delta__path(const git_diff_delta
*delta
);
84 extern bool git_diff_delta__should_skip(
85 const git_diff_options
*opts
, const git_diff_delta
*delta
);
87 extern int git_diff_delta__format_file_header(
89 const git_diff_delta
*delta
,
94 extern int git_diff__oid_for_file(
95 git_oid
*out
, git_diff
*, const char *, uint16_t, git_off_t
);
96 extern int git_diff__oid_for_entry(
97 git_oid
*out
, git_diff
*, const git_index_entry
*, uint16_t, const git_oid
*update
);
99 extern int git_diff__from_iterators(
101 git_repository
*repo
,
102 git_iterator
*old_iter
,
103 git_iterator
*new_iter
,
104 const git_diff_options
*opts
);
106 extern int git_diff__paired_foreach(
109 int (*cb
)(git_diff_delta
*i2h
, git_diff_delta
*w2i
, void *payload
),
112 extern int git_diff_find_similar__hashsig_for_file(
113 void **out
, const git_diff_file
*f
, const char *path
, void *p
);
115 extern int git_diff_find_similar__hashsig_for_buf(
116 void **out
, const git_diff_file
*f
, const char *buf
, size_t len
, void *p
);
118 extern void git_diff_find_similar__hashsig_free(void *sig
, void *payload
);
120 extern int git_diff_find_similar__calc_similarity(
121 int *score
, void *siga
, void *sigb
, void *payload
);
123 extern int git_diff__commit(
124 git_diff
**diff
, git_repository
*repo
, const git_commit
*commit
, const git_diff_options
*opts
);
126 /* Merge two `git_diff`s according to the callback given by `cb`. */
128 typedef git_diff_delta
*(*git_diff__merge_cb
)(
129 const git_diff_delta
*left
,
130 const git_diff_delta
*right
,
133 extern int git_diff__merge(
134 git_diff
*onto
, const git_diff
*from
, git_diff__merge_cb cb
);
136 extern git_diff_delta
*git_diff__merge_like_cgit(
137 const git_diff_delta
*a
,
138 const git_diff_delta
*b
,
141 /* Duplicate a `git_diff_delta` out of the `git_pool` */
142 extern git_diff_delta
*git_diff__delta_dup(
143 const git_diff_delta
*d
, git_pool
*pool
);
146 * Sometimes a git_diff_file will have a zero size; this attempts to
147 * fill in the size without loading the blob if possible. If that is
148 * not possible, then it will return the git_odb_object that had to be
149 * loaded and the caller can use it or dispose of it as needed.
151 GIT_INLINE(int) git_diff_file__resolve_zero_size(
152 git_diff_file
*file
, git_odb_object
**odb_obj
, git_repository
*repo
)
159 if ((error
= git_repository_odb(&odb
, repo
)) < 0)
162 error
= git_odb__read_header_or_object(
163 odb_obj
, &len
, &type
, odb
, &file
->id
);
168 file
->size
= (git_off_t
)len
;