src/diff.h

   1 /*
   2  * Copyright (C) the libgit2 contributors. All rights reserved.
   3  *
   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.
   6  */
   7 #ifndef INCLUDE_diff_h__
   8 #define INCLUDE_diff_h__
   9
  10 #include "git2/diff.h"
  11 #include "git2/oid.h"
  12
  13 #include <stdio.h>
  14 #include "vector.h"
  15 #include "buffer.h"
  16 #include "iterator.h"
  17 #include "repository.h"
  18 #include "pool.h"
  19 #include "odb.h"
  20
  21 #define DIFF_OLD_PREFIX_DEFAULT "a/"
  22 #define DIFF_NEW_PREFIX_DEFAULT "b/"
  23
  24 enum {
  25         GIT_DIFFCAPS_HAS_SYMLINKS     = (1 << 0), /* symlinks on platform? */
  26         GIT_DIFFCAPS_IGNORE_STAT      = (1 << 1), /* use stat? */
  27         GIT_DIFFCAPS_TRUST_MODE_BITS  = (1 << 2), /* use st_mode? */
  28         GIT_DIFFCAPS_TRUST_CTIME      = (1 << 3), /* use st_ctime? */
  29         GIT_DIFFCAPS_USE_DEV          = (1 << 4), /* use st_dev? */
  30         GIT_DIFFCAPS_TRUST_NANOSECS   = (1 << 5), /* use stat time nanoseconds */
  31 };
  32
  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)
  35
  36 enum {
  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 */
  43
  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),
  49 };
  50
  51 #define GIT_DIFF_FLAG__CLEAR_INTERNAL(F) (F) = ((F) & 0x00FFFF)
  52
  53 #define GIT_DIFF__VERBOSE  (1 << 30)
  54
  55 struct git_diff {
  56         git_refcount     rc;
  57         git_repository   *repo;
  58         git_diff_options opts;
  59         git_vector       pathspec;
  60         git_vector       deltas;    /* vector of git_diff_delta */
  61         git_pool pool;
  62         git_iterator_type_t old_src;
  63         git_iterator_type_t new_src;
  64         uint32_t diffcaps;
  65
  66         int (*strcomp)(const char *, const char *);
  67         int (*strncomp)(const char *, const char *, size_t);
  68         int (*pfxcomp)(const char *str, const char *pfx);
  69         int (*entrycomp)(const void *a, const void *b);
  70 };
  71
  72 extern void git_diff__cleanup_modes(
  73         uint32_t diffcaps, uint32_t *omode, uint32_t *nmode);
  74
  75 extern void git_diff_addref(git_diff *diff);
  76
  77 extern int git_diff_delta__cmp(const void *a, const void *b);
  78 extern int git_diff_delta__casecmp(const void *a, const void *b);
  79
  80 extern const char *git_diff_delta__path(const git_diff_delta *delta);
  81
  82 extern bool git_diff_delta__should_skip(
  83         const git_diff_options *opts, const git_diff_delta *delta);
  84
  85 extern int git_diff_delta__format_file_header(
  86         git_buf *out,
  87         const git_diff_delta *delta,
  88         const char *oldpfx,
  89         const char *newpfx,
  90         int oid_strlen);
  91
  92 extern int git_diff__oid_for_file(
  93         git_repository *, const char *, uint16_t, git_off_t, git_oid *);
  94
  95 extern int git_diff__from_iterators(
  96         git_diff **diff_ptr,
  97         git_repository *repo,
  98         git_iterator *old_iter,
  99         git_iterator *new_iter,
 100         const git_diff_options *opts);
 101
 102 extern int git_diff__paired_foreach(
 103         git_diff *idx2head,
 104         git_diff *wd2idx,
 105         int (*cb)(git_diff_delta *i2h, git_diff_delta *w2i, void *payload),
 106         void *payload);
 107
 108 extern int git_diff_find_similar__hashsig_for_file(
 109         void **out, const git_diff_file *f, const char *path, void *p);
 110
 111 extern int git_diff_find_similar__hashsig_for_buf(
 112         void **out, const git_diff_file *f, const char *buf, size_t len, void *p);
 113
 114 extern void git_diff_find_similar__hashsig_free(void *sig, void *payload);
 115
 116 extern int git_diff_find_similar__calc_similarity(
 117         int *score, void *siga, void *sigb, void *payload);
 118
 119 /*
 120  * Sometimes a git_diff_file will have a zero size; this attempts to
 121  * fill in the size without loading the blob if possible.  If that is
 122  * not possible, then it will return the git_odb_object that had to be
 123  * loaded and the caller can use it or dispose of it as needed.
 124  */
 125 GIT_INLINE(int) git_diff_file__resolve_zero_size(
 126         git_diff_file *file, git_odb_object **odb_obj, git_repository *repo)
 127 {
 128         int error;
 129         git_odb *odb;
 130         size_t len;
 131         git_otype type;
 132
 133         if ((error = git_repository_odb(&odb, repo)) < 0)
 134                 return error;
 135
 136         error = git_odb__read_header_or_object(
 137                 odb_obj, &len, &type, odb, &file->id);
 138
 139         git_odb_free(odb);
 140
 141         if (!error)
 142                 file->size = (git_off_t)len;
 143
 144         return error;
 145 }
 146
 147 #endif
 148