获取与特定分支上文件的上次更改相关的标记名称

Question

• 我有哪些信息： 上的文件名（myfile.txt） 主分公司。该文件最后一次使用commit＆＃34; 3＆＃34; 导致版本2.

• 我想要检索的内容： 标记名称＆＃34; 0.0.2＆＃34;其中包括 承诺＆＃34; 3＆＃34;和＆＃34; 4＆＃34;自上一个标签＆＃34; 0.0.1＆＃34;。

• 我所知道的：

（A） 如何在2个标签之间获取更改的文件（请参阅here）：

git diff --name-only 0.0.1 0.0.2

这会打印＆＃39; myfile.txt＆＃39;等等。

（B） 通常这应该完全符合我的需要（参见here）：

git describe --always `git log --pretty=format:%H -n 1 myfile.txt`

但是我没有得到标签名称＆＃39; 0.0.2＆＃39;或与此标记相关的提交。相反，我得到提交3的提交SHA-1，其中包括最新的提交 myfile.txt的更改。

（C） 如果以下命令打印相应的标记名称，则会对标记进行注释：

git for-each-ref --format='%(refname) %(objecttype)' refs/tags

打印：

refs/tags/0.0.1 tag
refs/tags/0.0.2 tag
refs/tags/0.0.3 tag
refs/tags/0.0.4 tag

问题

所以我的问题是：（B）对我的目的是正确的方式吗？如果是，我如何更改它确实获得所需的标签名称？还是有另一种方式而不是（B）得到我需要的东西？

Answer 1

TL;博士

git describe --contains `git log --pretty=format:%H -n 1 myfile.txt` | sed 's/\(.*\)[~^].*/\1/'

文档

git-describe documentation的相关标志说明：

--always
Show uniquely abbreviated commit object as fallback.

这不是你想要的。这允许打印提交哈希而不是标记。

--tags
Instead of using only the annotated tags, use any tag found in refs/tags
namespace. This option enables matching a lightweight (non-annotated) tag.

这更接近，因为它允许使用所有标签，注释与否。但是，它仍然受到在上次提交之前找到标记的默认行为的影响。

--contains
Instead of finding the tag that predates the commit, find the tag that comes
after the commit, and thus contains it. Automatically implies --tags.

宾果

使用示例

给定具有以下提交历史记录的存储库：

$ git log --decorate=short -p | grep -v Author
commit d79ae00046a3ce456316fb431af5c4473a9868c8 (HEAD -> master, tag: v0.0.3)
Date:   Mon May 28 22:54:33 2018 -0700

    Commit #5

diff --git a/foo.txt b/foo.txt
index 257cc56..3bd1f0e 100644
--- a/foo.txt
+++ b/foo.txt
@@ -1 +1,2 @@
 foo
+bar

commit 7921bbcd4bb0712e4b819231829bed5a857f99a5
Date:   Mon May 28 22:54:11 2018 -0700

    Commit #4

diff --git a/test.txt b/test.txt
index 7698346..fadbf1d 100644
--- a/test.txt
+++ b/test.txt
@@ -1,3 +1,4 @@
 test1
 test2
 test3
+test4

commit fbe5a73bc2b5edcd3cb7afa26b80f8ecb12f982d (tag: v0.0.2)
Date:   Mon May 28 22:53:28 2018 -0700

    Commit #3

diff --git a/test.txt b/test.txt
index bae42c5..7698346 100644
--- a/test.txt
+++ b/test.txt
@@ -1,2 +1,3 @@
 test1
 test2
+test3

commit 794519596d9e2de93ec71686a1708e5f81fbba21
Date:   Mon May 28 22:52:51 2018 -0700

    Commit #2

diff --git a/test.txt b/test.txt
index a5bce3f..bae42c5 100644
--- a/test.txt
+++ b/test.txt
@@ -1 +1,2 @@
 test1
+test2

commit 10f854c9c09ac6c4de10311ffb5809f09a1edd1a (tag: v0.0.1)
Date:   Mon May 28 22:52:00 2018 -0700

    Commit #1

diff --git a/foo.txt b/foo.txt
new file mode 100644
index 0000000..257cc56
--- /dev/null
+++ b/foo.txt
@@ -0,0 +1 @@
+foo
diff --git a/test.txt b/test.txt
new file mode 100644
index 0000000..a5bce3f
--- /dev/null
+++ b/test.txt
@@ -0,0 +1 @@
+test1

请注意，文件test.txt在提交＃1-4中编辑，但不在＃5中编辑。提交＃5标记为v0.0.3，这是我们想要的输出。

仅运行git命令会产生此输出：

$ git describe --contains `git log --pretty=format:%H -n 1 test.txt`
v0.0.3~1

~1表示对文件的最后一次更改是提供的标记后面的1次提交。为了完整起见，管道到sed会自动获取标记。

$ git describe --contains `git log --pretty=format:%H -n 1 test.txt` | sed 's/\(.*\)[~^].*/\1/'
v0.0.3