diff options
Diffstat (limited to 'src/git/tree.h')
-rw-r--r-- | src/git/tree.h | 84 |
1 files changed, 78 insertions, 6 deletions
diff --git a/src/git/tree.h b/src/git/tree.h index 32fd6527a..bec49f245 100644 --- a/src/git/tree.h +++ b/src/git/tree.h @@ -65,7 +65,7 @@ GIT_EXTERN(size_t) git_tree_entrycount(git_tree *tree); * @param filename the filename of the desired entry * @return the tree entry; NULL if not found */ -GIT_EXTERN(const git_tree_entry *) git_tree_entry_byname(git_tree *tree, const char *filename); +GIT_EXTERN(git_tree_entry *) git_tree_entry_byname(git_tree *tree, const char *filename); /** * Lookup a tree entry by its position in the tree @@ -73,35 +73,107 @@ GIT_EXTERN(const git_tree_entry *) git_tree_entry_byname(git_tree *tree, const c * @param idx the position in the entry list * @return the tree entry; NULL if not found */ -GIT_EXTERN(const git_tree_entry *) git_tree_entry_byindex(git_tree *tree, int idx); +GIT_EXTERN(git_tree_entry *) git_tree_entry_byindex(git_tree *tree, int idx); /** * Get the UNIX file attributes of a tree entry * @param entry a tree entry * @return attributes as an integer */ -GIT_EXTERN(unsigned int) git_tree_entry_attributes(const git_tree_entry *entry); +GIT_EXTERN(unsigned int) git_tree_entry_attributes(git_tree_entry *entry); /** * Get the filename of a tree entry * @param entry a tree entry * @return the name of the file */ -GIT_EXTERN(const char *) git_tree_entry_name(const git_tree_entry *entry); +GIT_EXTERN(const char *) git_tree_entry_name(git_tree_entry *entry); /** * Get the id of the object pointed by the entry * @param entry a tree entry * @return the oid of the object */ -GIT_EXTERN(const git_oid *) git_tree_entry_id(const git_tree_entry *entry); +GIT_EXTERN(const git_oid *) git_tree_entry_id(git_tree_entry *entry); /** * Convert a tree entry to the git_object it points too. * @param entry a tree entry * @return a reference to the pointed object in the repository */ -GIT_EXTERN(git_object *) git_tree_entry_2object(const git_tree_entry *entry); +GIT_EXTERN(git_object *) git_tree_entry_2object(git_tree_entry *entry); + +/** + * Add a new entry to a tree. + * + * This will mark the tree as modified; the new entry will + * be written back to disk on the next git_object_write() + * + * @param tree Tree object to store the entry + * @iparam id OID for the tree entry + * @param filename Filename for the tree entry + * @param attributes UNIX file attributes for the entry + */ +GIT_EXTERN(void) git_tree_add_entry(git_tree *tree, const git_oid *id, const char *filename, int attributes); + +/** + * Remove an entry by its index. + * + * Index must be >= 0 and < than git_tree_entrycount(). + * + * This will mark the tree as modified; the modified entry will + * be written back to disk on the next git_object_write() + * + * @param tree Tree where to remove the entry + * @param idx index of the entry + * @return 0 on successful removal; GIT_ENOTFOUND if the entry wasn't found + */ +GIT_EXTERN(int) git_tree_remove_entry_byindex(git_tree *tree, int idx); + +/** + * Remove an entry by its filename. + * + * This will mark the tree as modified; the modified entry will + * be written back to disk on the next git_object_write() + * + * @param tree Tree where to remove the entry + * @param filename File name of the entry + * @return 0 on successful removal; GIT_ENOTFOUND if the entry wasn't found + */ +GIT_EXTERN(int) git_tree_remove_entry_byname(git_tree *tree, const char *filename); + +/** + * Change the SHA1 id of a tree entry. + * + * This will mark the tree that contains the entry as modified; + * the modified entry will be written back to disk on the next git_object_write() + * + * @param entry Entry object which will be modified + * @param oid new SHA1 oid for the entry + */ +GIT_EXTERN(void) git_tree_entry_set_id(git_tree_entry *entry, const git_oid *oid); + +/** + * Change the filename of a tree entry. + * + * This will mark the tree that contains the entry as modified; + * the modified entry will be written back to disk on the next git_object_write() + * + * @param entry Entry object which will be modified + * @param oid new filename for the entry + */ +GIT_EXTERN(void) git_tree_entry_set_name(git_tree_entry *entry, const char *name); + +/** + * Change the attributes of a tree entry. + * + * This will mark the tree that contains the entry as modified; + * the modified entry will be written back to disk on the next git_object_write() + * + * @param entry Entry object which will be modified + * @param oid new attributes for the entry + */ +GIT_EXTERN(void) git_tree_entry_set_attributes(git_tree_entry *entry, int attr); /** @} */ GIT_END_DECL |