diff mbox series

[v2] refs: return conflict error when checking packed refs

Message ID pull.1716.v2.git.git.1714711829698.gitgitgadget@gmail.com (mailing list archive)
State Superseded
Headers show
Series [v2] refs: return conflict error when checking packed refs | expand

Commit Message

Ivan Tse May 3, 2024, 4:50 a.m. UTC
From: Ivan Tse <ivan.tse1@gmail.com>

The TRANSACTION_NAME_CONFLICT error code refers to a failure to create a
ref due to a name conflict with another ref. An example of this is a
directory/file conflict such as ref names A/B and A.

"git fetch" uses this error code to more accurately describe the error
by recommending to the user that they try running "git remote prune" to
remove any old refs that are deleted by the remote which would clear up
any directory/file conflicts.

This helpful error message is not displayed when the conflicted ref is
stored in packed refs. This change fixes this by ensuring error return
code consistency in `lock_raw_ref`.

Signed-off-by: Ivan Tse <ivan.tse1@gmail.com>
---
    refs: return conflict error when checking packed refs
    
    Changes against v1:
    
     * added test for the error message during git fetch
    
    Thanks for reviewing! I've gone ahead and attempted to add tests for
    this behavior. It tests that the error message is shown for both cases
    when the ref is stored as loose vs packed-refs. How does this test look?
    Also, should this test have a REFFILES prerequisite?

Published-As: https://github.com/gitgitgadget/git/releases/tag/pr-git-1716%2Fivantsepp%2Freturn_name_conflict_error_for_packed_refs-v2
Fetch-It-Via: git fetch https://github.com/gitgitgadget/git pr-git-1716/ivantsepp/return_name_conflict_error_for_packed_refs-v2
Pull-Request: https://github.com/git/git/pull/1716

Range-diff vs v1:

 1:  a87ba267e44 ! 1:  58b2cda5c18 refs: return conflict error when checking packed refs
     @@ refs/files-backend.c: static int lock_raw_ref(struct files_ref_store *refs,
       	}
       
       	ret = 0;
     +
     + ## t/t5510-fetch.sh ##
     +@@ t/t5510-fetch.sh: test_expect_success 'branchname D/F conflict resolved by --prune' '
     + 	test_cmp expect actual
     + '
     + 
     ++test_expect_success 'branchname D/F conflict rejected with targeted error message' '
     ++	git clone . df-conflict-error &&
     ++	git branch dir_conflict &&
     ++	(
     ++		cd df-conflict-error &&
     ++		git update-ref refs/remotes/origin/dir_conflict/file HEAD &&
     ++		test_must_fail git fetch 2>../err &&
     ++		git pack-refs --all &&
     ++		test_must_fail git fetch 2>../err-packed
     ++	) &&
     ++	test_grep "error: some local refs could not be updated; try running" err &&
     ++	test_grep " '\''git remote prune origin'\'' to remove any old, conflicting branches" err &&
     ++	test_grep "error: some local refs could not be updated; try running" err-packed &&
     ++	test_grep " '\''git remote prune origin'\'' to remove any old, conflicting branches" err-packed
     ++'
     ++
     + test_expect_success 'fetching a one-level ref works' '
     + 	test_commit extra &&
     + 	git reset --hard HEAD^ &&


 refs/files-backend.c |  4 +++-
 t/t5510-fetch.sh     | 16 ++++++++++++++++
 2 files changed, 19 insertions(+), 1 deletion(-)


base-commit: d4cc1ec35f3bcce816b69986ca41943f6ce21377

Comments

Patrick Steinhardt May 3, 2024, 6:38 a.m. UTC | #1
On Fri, May 03, 2024 at 04:50:29AM +0000, Ivan Tse via GitGitGadget wrote:
> From: Ivan Tse <ivan.tse1@gmail.com>
> 
> The TRANSACTION_NAME_CONFLICT error code refers to a failure to create a
> ref due to a name conflict with another ref. An example of this is a
> directory/file conflict such as ref names A/B and A.
> 
> "git fetch" uses this error code to more accurately describe the error
> by recommending to the user that they try running "git remote prune" to
> remove any old refs that are deleted by the remote which would clear up
> any directory/file conflicts.
> 
> This helpful error message is not displayed when the conflicted ref is
> stored in packed refs. This change fixes this by ensuring error return
> code consistency in `lock_raw_ref`.
> 
> Signed-off-by: Ivan Tse <ivan.tse1@gmail.com>
> ---
>     refs: return conflict error when checking packed refs
>     
>     Changes against v1:
>     
>      * added test for the error message during git fetch
>     
>     Thanks for reviewing! I've gone ahead and attempted to add tests for
>     this behavior. It tests that the error message is shown for both cases
>     when the ref is stored as loose vs packed-refs. How does this test look?
>     Also, should this test have a REFFILES prerequisite?

There is no need for the REFFILES prerequisite as you never access refs
on disk directly, but instead use our plumbing commands. Furthermore, we
do want to verify that both backends behave the same here. If the test
failed with the "reftable" backend I'd consider that to be a bug in the
backend.

[snip]
> diff --git a/t/t5510-fetch.sh b/t/t5510-fetch.sh
> index 33d34d5ae9e..ae0828e26a1 100755
> --- a/t/t5510-fetch.sh
> +++ b/t/t5510-fetch.sh
> @@ -1091,6 +1091,22 @@ test_expect_success 'branchname D/F conflict resolved by --prune' '
>  	test_cmp expect actual
>  '
>  
> +test_expect_success 'branchname D/F conflict rejected with targeted error message' '
> +	git clone . df-conflict-error &&
> +	git branch dir_conflict &&
> +	(
> +		cd df-conflict-error &&
> +		git update-ref refs/remotes/origin/dir_conflict/file HEAD &&
> +		test_must_fail git fetch 2>../err &&
> +		git pack-refs --all &&
> +		test_must_fail git fetch 2>../err-packed
> +	) &&
> +	test_grep "error: some local refs could not be updated; try running" err &&
> +	test_grep " '\''git remote prune origin'\'' to remove any old, conflicting branches" err &&
> +	test_grep "error: some local refs could not be updated; try running" err-packed &&
> +	test_grep " '\''git remote prune origin'\'' to remove any old, conflicting branches" err-packed

I would personally add those calls to `test_grep` right after the
respective fetches to make the test a bit easier to follow.

Also, instead of using '\''`, you can use the "${SQ}" variable to insert
single quotes. So, something like this:

    test_grep " ${SQ}git remote prune origin${SQ} to remove any old, conflicting branches" err &&

Other than that this patch looks good to me, thanks!

Patrick

> +'
> +
>  test_expect_success 'fetching a one-level ref works' '
>  	test_commit extra &&
>  	git reset --hard HEAD^ &&
> 
> base-commit: d4cc1ec35f3bcce816b69986ca41943f6ce21377
> -- 
> gitgitgadget
>
diff mbox series

Patch

diff --git a/refs/files-backend.c b/refs/files-backend.c
index a098d14ea00..97473f377d1 100644
--- a/refs/files-backend.c
+++ b/refs/files-backend.c
@@ -794,8 +794,10 @@  static int lock_raw_ref(struct files_ref_store *refs,
 		 */
 		if (refs_verify_refname_available(
 				    refs->packed_ref_store, refname,
-				    extras, NULL, err))
+				    extras, NULL, err)) {
+			ret = TRANSACTION_NAME_CONFLICT;
 			goto error_return;
+		}
 	}
 
 	ret = 0;
diff --git a/t/t5510-fetch.sh b/t/t5510-fetch.sh
index 33d34d5ae9e..ae0828e26a1 100755
--- a/t/t5510-fetch.sh
+++ b/t/t5510-fetch.sh
@@ -1091,6 +1091,22 @@  test_expect_success 'branchname D/F conflict resolved by --prune' '
 	test_cmp expect actual
 '
 
+test_expect_success 'branchname D/F conflict rejected with targeted error message' '
+	git clone . df-conflict-error &&
+	git branch dir_conflict &&
+	(
+		cd df-conflict-error &&
+		git update-ref refs/remotes/origin/dir_conflict/file HEAD &&
+		test_must_fail git fetch 2>../err &&
+		git pack-refs --all &&
+		test_must_fail git fetch 2>../err-packed
+	) &&
+	test_grep "error: some local refs could not be updated; try running" err &&
+	test_grep " '\''git remote prune origin'\'' to remove any old, conflicting branches" err &&
+	test_grep "error: some local refs could not be updated; try running" err-packed &&
+	test_grep " '\''git remote prune origin'\'' to remove any old, conflicting branches" err-packed
+'
+
 test_expect_success 'fetching a one-level ref works' '
 	test_commit extra &&
 	git reset --hard HEAD^ &&