mirror of
https://git.proxmox.com/git/libgit2
synced 2025-05-10 00:07:50 +00:00
74fa4bfae3
This is a major reorganization of the diff code. This changes the diff functions to use the iterators for traversing the content. This allowed a lot of code to be simplified. Also, this moved the functions relating to outputting a diff into a new file (diff_output.c). This includes a number of other changes - adding utility functions, extending iterators, etc. plus more tests for the diff code. This also takes the example diff.c program much further in terms of emulating git-diff command line options.
106 lines
2.9 KiB
C
106 lines
2.9 KiB
C
/*
|
|
* Copyright (C) 2009-2012 the libgit2 contributors
|
|
*
|
|
* 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_iterator_h__
|
|
#define INCLUDE_iterator_h__
|
|
|
|
#include "common.h"
|
|
#include "git2/index.h"
|
|
|
|
typedef struct git_iterator git_iterator;
|
|
|
|
typedef enum {
|
|
GIT_ITERATOR_TREE = 1,
|
|
GIT_ITERATOR_INDEX = 2,
|
|
GIT_ITERATOR_WORKDIR = 3
|
|
} git_iterator_type_t;
|
|
|
|
struct git_iterator {
|
|
git_iterator_type_t type;
|
|
int (*current)(git_iterator *, const git_index_entry **);
|
|
int (*at_end)(git_iterator *);
|
|
int (*advance)(git_iterator *, const git_index_entry **);
|
|
int (*reset)(git_iterator *);
|
|
void (*free)(git_iterator *);
|
|
};
|
|
|
|
int git_iterator_for_tree(
|
|
git_repository *repo, git_tree *tree, git_iterator **iter);
|
|
|
|
int git_iterator_for_index(
|
|
git_repository *repo, git_iterator **iter);
|
|
|
|
int git_iterator_for_workdir(
|
|
git_repository *repo, git_iterator **iter);
|
|
|
|
/* Entry is not guaranteed to be fully populated. For a tree iterator,
|
|
* we will only populate the mode, oid and path, for example. For a workdir
|
|
* iterator, we will not populate the oid.
|
|
*
|
|
* You do not need to free the entry. It is still "owned" by the iterator.
|
|
* Once you call `git_iterator_advance`, then content of the old entry is
|
|
* no longer guaranteed to be valid.
|
|
*/
|
|
GIT_INLINE(int) git_iterator_current(
|
|
git_iterator *iter, const git_index_entry **entry)
|
|
{
|
|
return iter->current(iter, entry);
|
|
}
|
|
|
|
GIT_INLINE(int) git_iterator_at_end(git_iterator *iter)
|
|
{
|
|
return iter->at_end(iter);
|
|
}
|
|
|
|
GIT_INLINE(int) git_iterator_advance(
|
|
git_iterator *iter, const git_index_entry **entry)
|
|
{
|
|
return iter->advance(iter, entry);
|
|
}
|
|
|
|
GIT_INLINE(int) git_iterator_reset(git_iterator *iter)
|
|
{
|
|
return iter->reset(iter);
|
|
}
|
|
|
|
GIT_INLINE(void) git_iterator_free(git_iterator *iter)
|
|
{
|
|
iter->free(iter);
|
|
git__free(iter);
|
|
}
|
|
|
|
GIT_INLINE(git_iterator_type_t) git_iterator_type(git_iterator *iter)
|
|
{
|
|
return iter->type;
|
|
}
|
|
|
|
extern int git_iterator_current_tree_entry(
|
|
git_iterator *iter, const git_tree_entry **tree_entry);
|
|
|
|
extern int git_iterator_current_is_ignored(git_iterator *iter);
|
|
|
|
/**
|
|
* Iterate into a workdir directory.
|
|
*
|
|
* Workdir iterators do not automatically descend into directories (so that
|
|
* when comparing two iterator entries you can detect a newly created
|
|
* directory in the workdir). As a result, you may get S_ISDIR items from
|
|
* a workdir iterator. If you wish to iterate over the contents of the
|
|
* directories you encounter, then call this function when you encounter
|
|
* a directory.
|
|
*
|
|
* If there are no files in the directory, this will end up acting like a
|
|
* regular advance and will skip past the directory, so you should be
|
|
* prepared for that case.
|
|
*
|
|
* On non-workdir iterators or if not pointing at a directory, this is a
|
|
* no-op and will not advance the iterator.
|
|
*/
|
|
extern int git_iterator_advance_into_directory(
|
|
git_iterator *iter, const git_index_entry **entry);
|
|
|
|
#endif
|