repo: add head_commit helper

ethomson · ethomson · commit 048421a404d3 · 2024-01-15T00:15:10.000Z
Provide a helper method to provide the HEAD's commit, much like our
existing `head_tree` helper.
diff --git a/src/libgit2/repository.c b/src/libgit2/repository.c
@@ -3314,6 +3314,25 @@ int git_repository_set_bare(git_repository *repo)
 	return 0;
 }
 
+int git_repository_head_commit(git_commit **commit, git_repository *repo)
+{
+	git_reference *head;
+	git_object *obj;
+	int error;
+
+	if ((error = git_repository_head(&head, repo)) < 0)
+		return error;
+
+	if ((error = git_reference_peel(&obj, head, GIT_OBJECT_COMMIT)) < 0)
+		goto cleanup;
+
+	*commit = (git_commit *)obj;
+
+cleanup:
+	git_reference_free(head);
+	return error;
+}
+
 int git_repository_head_tree(git_tree **tree, git_repository *repo)
 {
 	git_reference *head;
diff --git a/src/libgit2/repository.h b/src/libgit2/repository.h
@@ -173,6 +173,7 @@ GIT_INLINE(git_attr_cache *) git_repository_attr_cache(git_repository *repo)
 	return repo->attrcache;
 }
 
+int git_repository_head_commit(git_commit **commit, git_repository *repo);
 int git_repository_head_tree(git_tree **tree, git_repository *repo);
 int git_repository_create_head(const char *git_dir, const char *ref_name);
 

Original file line number	Diff line number	Diff line change
`@@ -173,6 +173,7 @@ GIT_INLINE(git_attr_cache ) git_repository_attr_cache(git_repository repo)`
`173`	`173`	`return repo->attrcache;`
`174`	`174`	`}`
`175`	`175`
	`176`	`+int git_repository_head_commit(git_commit *commit, git_repository repo);`
`176`	`177`	`int git_repository_head_tree(git_tree *tree, git_repository repo);`
`177`	`178`	`int git_repository_create_head(const char git_dir, const char ref_name);`
`178`	`179`