fix 'git show -s' to not add extra terminator after merge commit
v2 cover fix 'git show -s' to not add extra terminator after merge commit
Since v1:
* add Signed-off-by
* remove notion about '--format=%s' - found it in the documentation
Since RFC:
* fix the CC issues
* add fixes for existing tests
Max Kirillov (2):
git-show: fix 'git show -s' to not add extra terminator after merge commit
t: git-show: adapt tests to fixed 'git show'
combine-diff.c | 3 ++- t/t1507-rev-parse-upstream.sh | 2 +- t/t7007-show.sh | 8 ++++++-- t/t7600-merge.sh | 11 +++++------ 4 files changed, 14 insertions(+), 10 deletions(-)
Signature · 1 line
1.8.5.2.421.g4cdf8d0
PATCH v2 1/2 git-show: fix 'git show -s' to not add extra terminator after merge commit
When git show -s is called for merge commit it prints extra newline after any merge commit and the next one. This looks especially ugly for --oneline and other single-line formats. Looks very much like a bug.
The code in question exists since commit 3969cf7db1. Probably the correct condition should be in fact
"opt->output_format & DIFF_FORMAT_DIFFSTAT".
Test t7007-show.sh is also modified to cover this case.
--- combine-diff.c | 3 ++- t/t7007-show.sh | 8 ++++++-- 2 files changed, 8 insertions(+), 3 deletions(-)
combine-diff.c +2 -1
@@ -1331,7 +1331,8 @@ void diff_tree_combined(const unsigned char *sha1,if (show_log_first && i ==0 ) {show_log (rev); -if (rev->verbose_header && opt->output_format) +if (rev->verbose_header && opt->output_format && + opt->output_format !=DIFF_FORMAT_NO_OUTPUT )printf ("%s%c" ,diff_line_prefix (opt), opt->line_termination); }
t/t7007-show.sh +6 -2
@@ -25,6 +25,7 @@ test_expect_success 'set up a bit of history' ' git checkout -b side HEAD^^ && test_commit side2 && test_commit side3 + test_merge merge main3 ' test_expect_success 'showing two commits' '
@@ -109,8 +110,11 @@ test_expect_success 'showing range' ' ' test_expect_success '-s suppresses diff' ' - echo main3 >expect && - git show -s --format=%s main3 >actual && + cat >expect <<-\EOF && + merge + main3 + EOF + git show -s --format=%s merge main3 >actual && test_cmp expect actual '
Signature · 1 line
1.8.5.2.421.g4cdf8d0
Re: [PATCH v2 1/2] git-show: fix 'git show -s' to not add extra terminator after merge commit
Am 5/13/2014 1:10, schrieb Max Kirillov:
t/t7007-show.sh test_expect_success 'set up a bit of history' ' · line 29
Quoted 8 lines
t/t7007-show.sh +1
-0@@ -25,6 +25,7 @@ test_expect_success 'set up a bit of history' ' git checkout -b side HEAD^^ && test_commit side2 && test_commit side3 + test_merge merge main3 '
Broken &&-chain.
-- Hannes
PATCH v2 2/2 t: git-show: adapt tests to fixed 'git show'
In reply to Max Kirillov'git show' used to print extra newline after merge commit, and it was recorded so into the test reference data. Now when the behavior is fixed, the tests should be updated.
--- t/t1507-rev-parse-upstream.sh | 2 +- t/t7600-merge.sh | 11 +++++------ 2 files changed, 6 insertions(+), 7 deletions(-)
t/t1507-rev-parse-upstream.sh +1 -1
@@ -100,7 +100,7 @@ test_expect_success 'merge my-side@{u} records the correct name' ' git branch -D new ;# can fail but is ok git branch -t new my-side@{u} && git merge -s ours new@{u} && - git show -s --pretty=format:%s >actual && + git show -s --pretty=tformat:%s >actual && echo "Merge remote-tracking branch ${sq}origin/side${sq}" >expect && test_cmp expect actual )
t/t7600-merge.sh +5 -6
@@ -57,11 +57,10 @@ create_merge_msgs () { git log --no-merges ^HEAD c2 c3 } >squash.1-5-9 && : >msg.nologff && - echo >msg.nolognoff && + : >msg.nolognoff && { echo "* tag 'c3':" && - echo " commit 3" && - echo + echo " commit 3" } >msg.log }
@@ -71,7 +70,7 @@ verify_merge () { git diff --exit-code && if test -n "$3" then - git show -s --pretty=format:%s HEAD >msg.act && + git show -s --pretty=tformat:%s HEAD >msg.act && test_cmp "$3" msg.act fi }
@@ -620,10 +619,10 @@ test_expect_success 'merge early part of c2' ' git tag c6 && git branch -f c5-branch c5 && git merge c5-branch~1 && - git show -s --pretty=format:%s HEAD >actual.branch && + git show -s --pretty=tformat:%s HEAD >actual.branch && git reset --keep HEAD^ && git merge c5~1 && - git show -s --pretty=format:%s HEAD >actual.tag && + git show -s --pretty=tformat:%s HEAD >actual.tag && test_cmp expected.branch actual.branch && test_cmp expected.tag actual.tag '
Signature · 1 line
1.8.5.2.421.g4cdf8d0
Re: [PATCH v2 1/2] git-show: fix 'git show -s' to not add extra terminator after merge commit
In reply to Johannes SixtQuoted 11 lines · Johannes Sixt
Am 5/13/2014 1:10, schrieb Max Kirillov:
t/t7007-show.sh test_expect_success 'set up a bit of history' ' · line 29
Quoted 8 lines
t/t7007-show.sh +1
-0@@ -25,6 +25,7 @@ test_expect_success 'set up a bit of history' ' git checkout -b side HEAD^^ && test_commit side2 && test_commit side3 + test_merge merge main3 'Broken &&-chain.
Thank you, will fix it.
Signature · 1 line
Max
Re: [PATCH v2 2/2] t: git-show: adapt tests to fixed 'git show'
In reply to Max KirillovQuoted 6 lines · Max Kirillov
'git show' used to print extra newline after merge commit, and it was recorded so into the test reference data. Now when the behavior is fixed, the tests should be updated.
Signed-off-by Max Kirillov <[email protected]>---
Hmph. Having these as two separate commits would mean that 1/2 alone will break the test, hurting bisectability a little bit. The necessary adjustments in this patch is small enough that we may be better off squashing them into one.
Quoted 9 lines
t/t1507-rev-parse-upstream.sh | 2 +- t/t7600-merge.sh | 11 +++++------ 2 files changed, 6 insertions(+), 7 deletions(-)t/t1507-rev-parse-upstream.sh +0
-0
t/t1507-rev-parse-upstream.sh test_expect_success 'merge my-side@{u} records the correct name' ' · line 106
Quoted 8 lines
t/t1507-rev-parse-upstream.sh +1
-1@@ -100,7 +100,7 @@ test_expect_success 'merge my-side@{u} records the correct name' ' git branch -D new ;# can fail but is ok git branch -t new my-side@{u} && git merge -s ours new@{u} && - git show -s --pretty=format:%s >actual && + git show -s --pretty=tformat:%s >actual && echo "Merge remote-tracking branch ${sq}origin/side${sq}" >expect && test_cmp expect actual )
This seems to me that it is updating how the output is produced, not updating the expected outputs from commands with arguments we have been testing. I have been expecting to see changes to the pieces of the code that prepare the expected output, so that we can compare old expectations, which would have been expecting something strange, with new expectations from the updated code, which would show that the new behaviour is a welcome change because it would produce more sensible output.
Having said all that, for this particular test piece, I agree with the patch that using --pretty=tformat:%s is a lot more sensible and using --pretty=format:%s and expecting its output to be terminated with the newline was an unrealistic test. After all, "tformat" is the version with "line terminator" semantics, as opposed to "item separator" semantics offered by "--pretty=format:", and the test merely was depending on the bug to expect a complete line output (i.e. "echo" without "-n"), which you fixed. The new test makes a lot more sense and is relevant to the real world use, and I would have preferred to see it explained as such in the log message.
Quoted 7 lines
t/t7600-merge.sh +0
-0@@ -57,11 +57,10 @@ create_merge_msgs () { git log --no-merges ^HEAD c2 c3 } >squash.1-5-9 &&
t/t7600-merge.sh create_merge_msgs () { · line 65
Quoted 10 lines
t/t7600-merge.sh +2
-3: >msg.nologff && - echo >msg.nolognoff && + : >msg.nolognoff && { echo "* tag 'c3':" && - echo " commit 3" && - echo + echo " commit 3" } >msg.log }
These are updating the expectation. We used to expect an unnecessary trailing blank line, and now we do not, which clearly shows that the previous fix is a welcome change.
t/t7600-merge.sh verify_merge () { · line 76
Quoted 9 lines
t/t7600-merge.sh +1
-1@@ -71,7 +70,7 @@ verify_merge () { git diff --exit-code && if test -n "$3" then - git show -s --pretty=format:%s HEAD >msg.act && + git show -s --pretty=tformat:%s HEAD >msg.act && test_cmp "$3" msg.act fi }
It is hard to judge what is fed as "$3" here without context, but this is in line with the "--pretty=tformat aka --format is the normal thing to use" we saw in 1507. The same for the other hunk.
t/t7600-merge.sh test_expect_success 'merge early part of c2' ' · line 628
Quoted 13 lines
t/t7600-merge.sh +2
-2@@ -620,10 +619,10 @@ test_expect_success 'merge early part of c2' ' git tag c6 && git branch -f c5-branch c5 && git merge c5-branch~1 && - git show -s --pretty=format:%s HEAD >actual.branch && + git show -s --pretty=tformat:%s HEAD >actual.branch && git reset --keep HEAD^ && git merge c5~1 && - git show -s --pretty=format:%s HEAD >actual.tag && + git show -s --pretty=tformat:%s HEAD >actual.tag && test_cmp expected.branch actual.branch && test_cmp expected.tag actual.tag '
How about squashing these two into a single patch, and at the end of the log message for 1/2, add this to explain the changes to the test:
Also existing tests are updated to demonstrate the new behaviour. Earlier, the tests that used "git show -s --pretty=format:%s", even though "--pretty=format:%s" calls for item separator semantics and does not ask for the terminating newline after the last item, expected the output to end with such a newline. They were relying on the buggy behaviour. Use of "--format=%s", which is equivalent to "--pretty=tformat:%s" that asks for a terminating newline after each item, is a more realistic way to use the command.
The update to verify_merge in t7600 adjusts the the merge message that used to expect an extra blank line in the output, which has been eliminated with this fix.
or something like that?
Re: [PATCH v2 2/2] t: git-show: adapt tests to fixed 'git show'
Quoted 4 lines · Junio C Hamano
Hmph. Having these as two separate commits would mean that 1/2 alone will break the test, hurting bisectability a little bit. The necessary adjustments in this patch is small enough that we may be better off squashing them into one.
Ok, will squash them.
Quoted 27 lines
Quoted 9 lines
t/t1507-rev-parse-upstream.sh | 2 +- t/t7600-merge.sh | 11 +++++------ 2 files changed, 6 insertions(+), 7 deletions(-)t/t1507-rev-parse-upstream.sh +0
-0t/t1507-rev-parse-upstream.sh test_expect_success 'merge my-side@{u} records the correct name' ' · line 106
Quoted 8 lines
t/t1507-rev-parse-upstream.sh +1
-1@@ -100,7 +100,7 @@ test_expect_success 'merge my-side@{u} records the correct name' ' git branch -D new ;# can fail but is ok git branch -t new my-side@{u} && git merge -s ours new@{u} && - git show -s --pretty=format:%s >actual && + git show -s --pretty=tformat:%s >actual && echo "Merge remote-tracking branch ${sq}origin/side${sq}" >expect && test_cmp expect actual )This seems to me that it is updating how the output is produced, not updating the expected outputs from commands with arguments we have been testing. I have been expecting to see changes to the pieces of the code that prepare the expected output, so that we can compare old expectations, which would have been expecting something strange, with new expectations from the updated code, which would show that the new behaviour is a welcome change because it would produce more sensible output.
Quoted 10 lines
Having said all that, for this particular test piece, I agree with the patch that using --pretty=tformat:%s is a lot more sensible and using --pretty=format:%s and expecting its output to be terminated with the newline was an unrealistic test. After all, "tformat" is the version with "line terminator" semantics, as opposed to "item separator" semantics offered by "--pretty=format:", and the test merely was depending on the bug to expect a complete line output (i.e. "echo" without "-n"), which you fixed. The new test makes a lot more sense and is relevant to the real world use, and I would have preferred to see it explained as such in the log message.
In analogous cases with non-merge commits I have found the form "--format=...", in t3505-cherry-pick-empty.sh for example, so I have decided that merges should also use it. The form "--pretty=tformat:..." seems more explicit to me, so I have chosen this one.
Will add the message as you have suggested.
Quoted 71 lines
Quoted 7 lines
t/t7600-merge.sh +0
-0@@ -57,11 +57,10 @@ create_merge_msgs () { git log --no-merges ^HEAD c2 c3 } >squash.1-5-9 &&t/t7600-merge.sh create_merge_msgs () { · line 65
Quoted 10 lines
t/t7600-merge.sh +2
-3: >msg.nologff && - echo >msg.nolognoff && + : >msg.nolognoff && { echo "* tag 'c3':" && - echo " commit 3" && - echo + echo " commit 3" } >msg.log }These are updating the expectation. We used to expect an unnecessary trailing blank line, and now we do not, which clearly shows that the previous fix is a welcome change.
t/t7600-merge.sh verify_merge () { · line 76
Quoted 9 lines
t/t7600-merge.sh +1
-1@@ -71,7 +70,7 @@ verify_merge () { git diff --exit-code && if test -n "$3" then - git show -s --pretty=format:%s HEAD >msg.act && + git show -s --pretty=tformat:%s HEAD >msg.act && test_cmp "$3" msg.act fi }It is hard to judge what is fed as "$3" here without context, but this is in line with the "--pretty=tformat aka --format is the normal thing to use" we saw in 1507. The same for the other hunk.
t/t7600-merge.sh test_expect_success 'merge early part of c2' ' · line 628
Quoted 13 lines
t/t7600-merge.sh +2
-2@@ -620,10 +619,10 @@ test_expect_success 'merge early part of c2' ' git tag c6 && git branch -f c5-branch c5 && git merge c5-branch~1 && - git show -s --pretty=format:%s HEAD >actual.branch && + git show -s --pretty=tformat:%s HEAD >actual.branch && git reset --keep HEAD^ && git merge c5~1 && - git show -s --pretty=format:%s HEAD >actual.tag && + git show -s --pretty=tformat:%s HEAD >actual.tag && test_cmp expected.branch actual.branch && test_cmp expected.tag actual.tag 'How about squashing these two into a single patch, and at the end of the log message for 1/2, add this to explain the changes to the test:
Also existing tests are updated to demonstrate the new behaviour. Earlier, the tests that used "git show -s --pretty=format:%s", even though "--pretty=format:%s" calls for item separator semantics and does not ask for the terminating newline after the last item, expected the output to end with such a newline. They were relying on the buggy behaviour. Use of "--format=%s", which is equivalent to "--pretty=tformat:%s" that asks for a terminating newline after each item, is a more realistic way to use the command.
The update to
verify_mergein t7600 adjusts the the merge message that used to expect an extra blank line in the output, which has been eliminated with this fix.or something like that?