git - libgit2 如何将短引用名称解析为完整引用名称或哈希

Question

在 libgit2 中，如何解析短引用名称以获得完整的引用名称或哈希值？需要调用什么 libgit2 函数？

Answer 1

libgit2 支持完整的 extended SHA-1 syntax 通过使用 git_revparse_single() 函数。为了检索哈希，只需将检索到的对象传递给 git_object_id() 函数即可。

利用 git_revparse_single() 将允许复制以下标准 git 命令行用法:

$ git show master
$ git show heads/master
$ git show e90810b
...

Libgit2代码:

git_repository* repo;
git_object *object;
int error;

... open existing repository ...

/* Short named references
 * Note: Might be considered ambiguous if tags/master
 * and heads/master both exist
 */
error = git_revparse_single(&obj, repo, "master"); 
git_object_free(obj);

/* Less ambiguous name */
error = git_revparse_single(&obj, repo, "heads/master");
git_object_free(obj);

/* Short hash as well */
error = git_revparse_single(&obj, repo, "e90810b"); 
git_object_free(obj);

/* Complex specs */
error = git_revparse_single(&obj, repo, "master@{0}~1^1"); 
git_object_free(obj);

/* Tree entries */
error = git_revparse_single(&obj, repo, "test/master@{1}:branch_file.txt"); 
git_object_free(obj);

有关用法的更多信息或示例，您可以查看 unit tests .

注意:目前没有内置公开的方法来从短引用名称中检索规范引用名称。

更新

惊人的 @CarlosMartinNieto 让它成为现实。

Libgit2 现在公开了 git_reference_dwim，它通过短名称检索引用(例如 master、heads/master，...)

• Header
• Libgit 2 commit introducing this change