From: "Rubén Justo" <rjusto@gmail.com>
To: Patrick Steinhardt <ps@pks.im>, git@vger.kernel.org
Cc: moti sd <motisd8@gmail.com>
Subject: Re: [PATCH] builtin/stash: report failure to write to index
Date: Mon, 5 Feb 2024 23:22:01 +0100 [thread overview]
Message-ID: <f07d33e4-5595-43e3-838e-fd89c5621485@gmail.com> (raw)
In-Reply-To: <2cd44b01dc29b099a07658499481a6847c46562d.1707116449.git.ps@pks.im>
On 05-feb-2024 08:01:04, Patrick Steinhardt wrote:
> The git-stash(1) command needs to write to the index for many of its
> operations. When the index is locked by a concurrent writer it will thus
> fail to operate, which is expected. What is not expected though is that
> we do not print any error message at all in this case. The user can thus
> easily miss the fact that the command didn't do what they expected it to
> do and would be left wondering why that is.
>
> Fix this bug and report failures to write to the index. Add tests for
> the subcommands which hit the respective code paths.
>
> Note that the chosen error message ("Cannot write to the index") does
> not match our guidelines as it starts with a capitalized letter. This is
> intentional though and matches the style of all the other messages used
> in git-stash(1).
Your message made me curious, so I ran:
$ git grep -E '(die|error)\(' builtin/stash.c
builtin/stash.c:168: die(_("'%s' is not a stash-like commit"), revision);
builtin/stash.c:214: return error(_("%s is not a valid reference"), revision);
builtin/stash.c:261: return error(_("git stash clear with arguments is "
builtin/stash.c:303: return error(_("unable to write new index file"));
builtin/stash.c:487: die("Failed to move %s to %s\n",
builtin/stash.c:523: die(_("Unable to write index."));
builtin/stash.c:544: return error(_("cannot apply a stash in the middle of a merge"));
builtin/stash.c:555: return error(_("could not generate diff %s^!."),
builtin/stash.c:562: return error(_("conflicts in index. "
builtin/stash.c:569: return error(_("could not save index tree"));
builtin/stash.c:610: ret = error(_("could not write index"));
builtin/stash.c:630: ret = error(_("could not restore untracked files from stash"));
builtin/stash.c:702: return error(_("%s: Could not drop stash entry"),
builtin/stash.c:721: return error(_("'%s' is not a stash reference"), info->revision.buf);
builtin/stash.c:872: die(_("failed to parse tree"));
builtin/stash.c:883: die(_("failed to unpack trees"));
builtin/stash.c:1547: if (report_path_error(ps_matched, ps)) {
builtin/stash.c:1763: die("subcommand wasn't specified; 'push' can't be assumed due to unexpected token '%s'",
builtin/stash.c:1773: die(_("options '%s' and '%s' cannot be used together"), "--pathspec-from-file", "--patch");
builtin/stash.c:1776: die(_("options '%s' and '%s' cannot be used together"), "--pathspec-from-file", "--staged");
builtin/stash.c:1779: die(_("'%s' and pathspec arguments cannot be used together"), "--pathspec-from-file");
builtin/stash.c:1785: die(_("the option '%s' requires '%s'"), "--pathspec-file-nul", "--pathspec-from-file");
Certainly, there are some error messages in builtin/stash.c that do not
follow the notes in Documentation/CodingGuideLines, but it does not seem
to be "the style of all other messages" in git-stash.
However, your message is clear ... What error messages are you
considering?
>
> Reported-by: moti sd <motisd8@gmail.com>
> Signed-off-by: Patrick Steinhardt <ps@pks.im>
> ---
> builtin/stash.c | 6 +++---
> t/t3903-stash.sh | 52 ++++++++++++++++++++++++++++++++++++++++++++++++
> 2 files changed, 55 insertions(+), 3 deletions(-)
>
> diff --git a/builtin/stash.c b/builtin/stash.c
> index b2813c614c..9df072b459 100644
> --- a/builtin/stash.c
> +++ b/builtin/stash.c
> @@ -537,7 +537,7 @@ static int do_apply_stash(const char *prefix, struct stash_info *info,
> repo_read_index_preload(the_repository, NULL, 0);
> if (repo_refresh_and_write_index(the_repository, REFRESH_QUIET, 0, 0,
> NULL, NULL, NULL))
> - return -1;
> + return error(_("Cannot write to the index"));
>
> if (write_index_as_tree(&c_tree, &the_index, get_index_file(), 0,
> NULL))
> @@ -1364,7 +1364,7 @@ static int do_create_stash(const struct pathspec *ps, struct strbuf *stash_msg_b
> repo_read_index_preload(the_repository, NULL, 0);
> if (repo_refresh_and_write_index(the_repository, REFRESH_QUIET, 0, 0,
> NULL, NULL, NULL) < 0) {
> - ret = -1;
> + ret = error(_("Cannot write to the index"));
> goto done;
> }
>
> @@ -1555,7 +1555,7 @@ static int do_push_stash(const struct pathspec *ps, const char *stash_msg, int q
>
> if (repo_refresh_and_write_index(the_repository, REFRESH_QUIET, 0, 0,
> NULL, NULL, NULL)) {
> - ret = -1;
> + ret = error(_("Cannot write to the index"));
> goto done;
> }
>
> diff --git a/t/t3903-stash.sh b/t/t3903-stash.sh
> index 3319240515..770881e537 100755
> --- a/t/t3903-stash.sh
> +++ b/t/t3903-stash.sh
> @@ -1516,4 +1516,56 @@ test_expect_success 'restore untracked files even when we hit conflicts' '
> )
> '
>
> +test_expect_success 'stash create reports a locked index' '
> + test_when_finished "rm -rf repo" &&
> + git init repo &&
> + (
> + cd repo &&
> + test_commit A A.file &&
> + echo change >A.file &&
> + touch .git/index.lock &&
> +
> + cat >expect <<-EOF &&
> + error: Cannot write to the index
> + EOF
> + test_must_fail git stash create 2>err &&
> + test_cmp expect err
> + )
> +'
> +
> +test_expect_success 'stash push reports a locked index' '
> + test_when_finished "rm -rf repo" &&
> + git init repo &&
> + (
> + cd repo &&
> + test_commit A A.file &&
> + echo change >A.file &&
> + touch .git/index.lock &&
> +
> + cat >expect <<-EOF &&
> + error: Cannot write to the index
> + EOF
> + test_must_fail git stash push 2>err &&
> + test_cmp expect err
> + )
> +'
> +
> +test_expect_success 'stash apply reports a locked index' '
> + test_when_finished "rm -rf repo" &&
> + git init repo &&
> + (
> + cd repo &&
> + test_commit A A.file &&
> + echo change >A.file &&
> + git stash push &&
> + touch .git/index.lock &&
> +
> + cat >expect <<-EOF &&
> + error: Cannot write to the index
> + EOF
> + test_must_fail git stash apply 2>err &&
> + test_cmp expect err
> + )
> +'
> +
> test_done
> --
> 2.43.GIT
>
next prev parent reply other threads:[~2024-02-05 22:23 UTC|newest]
Thread overview: 8+ messages / expand[flat|nested] mbox.gz Atom feed top
2024-02-04 23:42 git bug moti sd
2024-02-05 6:47 ` Patrick Steinhardt
2024-02-05 7:01 ` [PATCH] builtin/stash: report failure to write to index Patrick Steinhardt
2024-02-05 22:22 ` Rubén Justo [this message]
2024-02-06 5:06 ` Patrick Steinhardt
2024-02-06 3:24 ` Junio C Hamano
2024-02-06 5:20 ` Patrick Steinhardt
2024-02-06 5:34 ` [PATCH v2] " Patrick Steinhardt
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
List information: http://vger.kernel.org/majordomo-info.html
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=f07d33e4-5595-43e3-838e-fd89c5621485@gmail.com \
--to=rjusto@gmail.com \
--cc=git@vger.kernel.org \
--cc=motisd8@gmail.com \
--cc=ps@pks.im \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
Code repositories for project(s) associated with this public inbox
https://80x24.org/mirrors/git.git
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).