git/list[1] front-page[2] threads[3] people[4] search[5] about
 

Re: [PATCH v3 04/12] bisect--helper: reimplement `bisect_autostart` shell function in C

From
Johannes Schindelin <johannes.schindelin@gmx.de>
Date
May 22, 2020, 19:27 UTC
Message-ID
<nycvar.QRO.7.76.6.2005222058380.56@tvgsbejvaqbjf.bet>
In-Reply-To
<20200423070704.39872-5-mirucam@gmail.com>
Hi Miriam,
On Thu, 23 Apr 2020, Miriam Rubio wrote:
Show 7 quoted lines
> From: Pranit Bauva <pranit.bauva@gmail.com>
>
> Reimplement the `bisect_autostart()` shell function in C and add the
> C implementation from `bisect_next()` which was previously left
> uncovered. Also add a subcommand `--bisect-autostart` to
> `git bisect--helper` be called from `bisect_state()` from
> git-bisect.sh .

I know you did not author this, but maybe I can still ask you to address a couple of concerns I have? I kind of stumble when I read "Also add a subcommand ... be called from ... from ...".

Also, why the funny space before the full stop?
> Using `--bisect-autostart` subcommand is a temporary measure to port
> shell function to C so as to use the existing test suite. As more

Likewise, "... to port shell function..." might benefit from inserting "the" in the middle?

Show 32 quoted lines
> functions are ported, this subcommand will be retired and
> bisect_autostart() will be called directly by `bisect_state()`.
>
> Mentored-by: Lars Schneider <larsxschneider@gmail.com>
> Mentored-by: Christian Couder <chriscool@tuxfamily.org>
> Mentored-by: Johannes Schindelin <johannes.schindelin@gmx.de>
> Signed-off-by: Pranit Bauva <pranit.bauva@gmail.com>
> Signed-off-by: Tanushree Tumane <tanushreetumane@gmail.com>
> Signed-off-by: Miriam Rubio <mirucam@gmail.com>
> ---
>  builtin/bisect--helper.c | 40 +++++++++++++++++++++++++++++++++++++++-
>  git-bisect.sh            | 25 ++-----------------------
>  2 files changed, 41 insertions(+), 24 deletions(-)
>
> diff --git a/builtin/bisect--helper.c b/builtin/bisect--helper.c
> index d3b2b33df0..9df69800e3 100644
> --- a/builtin/bisect--helper.c
> +++ b/builtin/bisect--helper.c
> @@ -29,6 +29,7 @@ static const char * const git_bisect_helper_usage[] = {
>  	N_("git bisect--helper --bisect-terms [--term-good | --term-old | --term-bad | --term-new]"),
>  	N_("git bisect--helper --bisect-start [--term-{old,good}=<term> --term-{new,bad}=<term>]"
>  					     "[--no-checkout] [<bad> [<good>...]] [--] [<paths>...]"),
> +	N_("git bisect--helper --bisect-autostart"),
>  	NULL
>  };
>
> @@ -55,6 +56,8 @@ static void set_terms(struct bisect_terms *terms, const char *bad,
>  static const char vocab_bad[] = "bad|new";
>  static const char vocab_good[] = "good|old";
>
> +static int bisect_autostart(struct bisect_terms *terms);
> +

Why forward-declare it? There is no reference before it is defined below, so I think this forward-declaration can be removed without any problem.

Show 13 quoted lines
>  /*
>   * Check whether the string `term` belongs to the set of strings
>   * included in the variable arguments.
> @@ -630,6 +633,32 @@ static int bisect_start(struct bisect_terms *terms, int no_checkout,
>  	return res;
>  }
>
> +static int bisect_autostart(struct bisect_terms *terms)
> +{
> +	const char *yesno;
> +
> +	if (!is_empty_or_missing_file(git_path_bisect_start()))
> +		return 0;
This is a bit more convoluted to read than the shell script:
	bisect_autostart() {
		test -s "$GIT_DIR/BISECT_START" || {
			gettextln "You need to start by \"git bisect start\"" >&2
			[...]
		}
	}

The `test -s <file>` command succeeds if the file exists and is non-empty. Which makes sense: either the file exists and is non-empty, or we need to do something.

When I read the C version, it takes me a bit more time to figure out what is going on here. Maybe we could introduce a helper function like this and use it here?

	static inline int file_is_not_empty(const char *path)
	{
		return !is_empty_or_missing_file(path);
	}
> +
> +	fprintf(stderr, _("You need to start by \"git bisect "
> +			  "start\"\n"));

If you use `fprintf_ln()` here, you can keep the string identical to the shell script version, i.e. without the trailing newline. That will allow the translations to be re-used, lessening the burden of the i18n team.

> +
> +	if (!isatty(STDIN_FILENO))
> +		return 1;

I would prefer it if only `cmd_*()` functions return positive values for the error case.

Show 8 quoted lines
> +
> +	/*
> +	 * TRANSLATORS: Make sure to include [Y] and [n] in your
> +	 * translation. The program will only accept English input
> +	 * at this point.
> +	 */
> +	yesno = git_prompt(_("Do you want me to do it for you "
> +			     "[Y/n]? "), PROMPT_ECHO);

Technically, `PROMPT_ECHO` is not required here as `git_prompt()` adds that flag implicitly unless you pass in `PASS_ASKPASS`, but I guess it does not hurt here.

However, I cannot fail to note that this constitutes a change of behavior, as `git_prompt()` does _not_ read from `stdin`.

Maybe we should call `git_read_line_interactively()` instead, after writing the prompt to `stderr` explicitly?

> +	if (starts_with(yesno, _("n")) || starts_with(yesno, _("N")))

This is wrong: "n" and "N" should not be translated, as they are not translated in the shell script version, either:

			case "$yesno" in
			[Nn]*)
				exit ;;
			esac
In light of this, a much, much shorter version would be:
	if (tolower(*yesno) == 'n')
		return -1;
(I use `-1` here because this is not within a `cmd_*()` function.)

However, I still think that we need to call `free(yesno);` or we leak memory. My preferred way would be:

		int ret;
		[...]
		ret = tolower(*yesno) == 'n' ?
			-1 : bisect_start(terms, 0, NULL, 0);
		free(yesno);
		return ret;
Show 24 quoted lines
> +		return 1;
> +
> +	return bisect_start(terms, 0, NULL, 0);
> +}
> +
>  int cmd_bisect__helper(int argc, const char **argv, const char *prefix)
>  {
>  	enum {
> @@ -642,7 +671,8 @@ int cmd_bisect__helper(int argc, const char **argv, const char *prefix)
>  		CHECK_AND_SET_TERMS,
>  		BISECT_NEXT_CHECK,
>  		BISECT_TERMS,
> -		BISECT_START
> +		BISECT_START,
> +		BISECT_AUTOSTART,
>  	} cmdmode = 0;
>  	int no_checkout = 0, res = 0, nolog = 0;
>  	struct option options[] = {
> @@ -666,6 +696,8 @@ int cmd_bisect__helper(int argc, const char **argv, const char *prefix)
>  			 N_("print out the bisect terms"), BISECT_TERMS),
>  		OPT_CMDMODE(0, "bisect-start", &cmdmode,
>  			 N_("start the bisect session"), BISECT_START),
> +		OPT_CMDMODE(0, "bisect-autostart", &cmdmode,
> +			 N_("start the bisection if BISECT_START is empty or missing"), BISECT_AUTOSTART),

Not that it matters a lot because this command mode will go away soon thereafter, but this describes an implementation detail rather than the purpose of the function. I would much rather read "start the bisection if it has not yet been started" instead.

Show 10 quoted lines
>  		OPT_BOOL(0, "no-checkout", &no_checkout,
>  			 N_("update BISECT_HEAD instead of checking out the current commit")),
>  		OPT_BOOL(0, "no-log", &nolog,
> @@ -727,6 +759,12 @@ int cmd_bisect__helper(int argc, const char **argv, const char *prefix)
>  		set_terms(&terms, "bad", "good");
>  		res = bisect_start(&terms, no_checkout, argv, argc);
>  		break;
> +	case BISECT_AUTOSTART:
> +		if (argc)
> +			return error(_("--bisect-autostart requires 0 arguments"));
Maybe "--bisect-autostart does not accept arguments" instead?

Ciao, Dscho

Show 60 quoted lines
> +		set_terms(&terms, "bad", "good");
> +		res = bisect_autostart(&terms);
> +		break;
>  	default:
>  		BUG("unknown subcommand %d", (int)cmdmode);
>  	}
> diff --git a/git-bisect.sh b/git-bisect.sh
> index efee12b8b1..426d443e7e 100755
> --- a/git-bisect.sh
> +++ b/git-bisect.sh
> @@ -49,27 +49,6 @@ bisect_head()
>  	fi
>  }
>
> -bisect_autostart() {
> -	test -s "$GIT_DIR/BISECT_START" || {
> -		gettextln "You need to start by \"git bisect start\"" >&2
> -		if test -t 0
> -		then
> -			# TRANSLATORS: Make sure to include [Y] and [n] in your
> -			# translation. The program will only accept English input
> -			# at this point.
> -			gettext "Do you want me to do it for you [Y/n]? " >&2
> -			read yesno
> -			case "$yesno" in
> -			[Nn]*)
> -				exit ;;
> -			esac
> -			bisect_start
> -		else
> -			exit 1
> -		fi
> -	}
> -}
> -
>  bisect_start() {
>  	git bisect--helper --bisect-start $@ || exit
>
> @@ -108,7 +87,7 @@ bisect_skip() {
>  }
>
>  bisect_state() {
> -	bisect_autostart
> +	git bisect--helper --bisect-autostart
>  	state=$1
>  	git bisect--helper --check-and-set-terms $state $TERM_GOOD $TERM_BAD || exit
>  	get_terms
> @@ -149,7 +128,7 @@ bisect_auto_next() {
>
>  bisect_next() {
>  	case "$#" in 0) ;; *) usage ;; esac
> -	bisect_autostart
> +	git bisect--helper --bisect-autostart
>  	git bisect--helper --bisect-next-check $TERM_GOOD $TERM_BAD $TERM_GOOD|| exit
>
>  	# Perform all bisection computation, display and checkout
> --
> 2.25.0
>
>
Previous: Miriam RubioNext: Johannes Schindelin
Message 10 of 28 in “Finish converting git bisect to C part 2”
  1. 00/12 Finish converting git bisect to C part 2Miriam Rubio, Apr 23, 2020
  2. 01/12 bisect--helper: fix `cmd_*()` function switch default returnMiriam Rubio, Apr 23, 2020
  3. Johannes SchindelinMay 22, 2020
  4. 03/12 bisect--helper: introduce new `write_in_file()` functionMiriam Rubio, Apr 23, 2020
  5. Johannes SchindelinMay 22, 2020
  6. Đoàn Trần Công DanhMay 23, 2020
  7. 02/12 bisect--helper: use '-res' in 'cmd_bisect__helper' returnMiriam Rubio, Apr 23, 2020
  8. Johannes SchindelinMay 22, 2020
  9. 04/12 bisect--helper: reimplement `bisect_autostart` shell function in CMiriam Rubio, Apr 23, 2020
  10. Johannes SchindelinMay 22, 2020
  11. Johannes SchindelinMay 22, 2020
  12. 05/12 bisect--helper: reimplement `bisect_next` and `bisect_auto_next` shell functions in CMiriam Rubio, Apr 23, 2020
  13. Johannes SchindelinMay 22, 2020
  14. 07/12 bisect--helper: retire `--bisect-clean-state` subcommandMiriam Rubio, Apr 23, 2020
  15. 06/12 bisect--helper: finish porting `bisect_start()` to CMiriam Rubio, Apr 23, 2020
  16. Johannes SchindelinMay 22, 2020
  17. 08/12 bisect--helper: retire `--next-all` subcommandMiriam Rubio, Apr 23, 2020
  18. 10/12 bisect--helper: retire `--check-expected-revs` subcommandMiriam Rubio, Apr 23, 2020
  19. 09/12 bisect--helper: reimplement `bisect_state` & `bisect_head` shell functions in CMiriam Rubio, Apr 23, 2020
  20. Johannes SchindelinMay 22, 2020
  21. Miriam R.Jun 20, 2020
  22. Johannes SchindelinJun 19, 2020
  23. 11/12 bisect--helper: retire `--write-terms` subcommandMiriam Rubio, Apr 23, 2020
  24. 12/12 bisect--helper: retire `--bisect-autostart` subcommandMiriam Rubio, Apr 23, 2020
  25. Junio C HamanoApr 23, 2020
  26. Miriam R.Apr 25, 2020
  27. Johannes SchindelinMay 22, 2020
  28. Miriam R.May 24, 2020

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.