[PATCH] test-tool: show tool list on error

[PATCH] test-tool: show tool list on error

[Jeff King]

Before we switched to one big test-tool binary, if you
forgot the name of a tool, you could use tab-completion in
the shell to get a hint. But these days, all you get is:

  $ t/helper/test-tool approxidate
  fatal: There is no test named 'approxidate'

and you're stuck reading the source code to find it. Let's
print a list of the available tools in this case.

Signed-off-by: Jeff King <peff@peff.net>
---
Not really user-facing, but this bugged me enough earlier to write the
patch. ;)

Some of the individual tools have nice help, too (try
"t/helper/test-tool date", which shows the approxidate command I was
looking for), but some of them could probably stand to improve their
friendliness (try "t/helper/test-tool config"). I think it's fine for
people to improve them over time if and when they get annoyed.

 t/helper/test-tool.c | 15 +++++++++++++--
 1 file changed, 13 insertions(+), 2 deletions(-)

diff --git a/t/helper/test-tool.c b/t/helper/test-tool.c
index 6b5836dc1b..5df8b682aa 100644
--- a/t/helper/test-tool.c
+++ b/t/helper/test-tool.c
@@ -55,13 +55,23 @@ static struct test_cmd cmds[] = {
 	{ "write-cache", cmd__write_cache },
 };
 
+static NORETURN void die_usage(void)
+{
+	size_t i;
+
+	fprintf(stderr, "usage: test-tool <toolname> [args]\n");
+	for (i = 0; i < ARRAY_SIZE(cmds); i++)
+		fprintf(stderr, "  %s\n", cmds[i].name);
+	exit(128);
+}
+
 int cmd_main(int argc, const char **argv)
 {
 	int i;
 
 	BUG_exit_code = 99;
 	if (argc < 2)
-		die("I need a test name!");
+		die_usage();
 
 	for (i = 0; i < ARRAY_SIZE(cmds); i++) {
 		if (!strcmp(cmds[i].name, argv[1])) {
@@ -70,5 +80,6 @@ int cmd_main(int argc, const char **argv)
 			return cmds[i].fn(argc, argv);
 		}
 	}
-	die("There is no test named '%s'", argv[1]);
+	error("there is no tool named '%s'", argv[1]);
+	die_usage();
 }
-- 
2.19.1.790.g519f91cad4

Re: [PATCH] test-tool: show tool list on error

[Derrick Stolee]

On 10/17/2018 5:25 AM, Jeff King wrote:
> Before we switched to one big test-tool binary, if you
> forgot the name of a tool, you could use tab-completion in
> the shell to get a hint. But these days, all you get is:
>
>    $ t/helper/test-tool approxidate
>    fatal: There is no test named 'approxidate'
>
> and you're stuck reading the source code to find it. Let's
> print a list of the available tools in this case.
>
> Signed-off-by: Jeff King <peff@peff.net>
> ---
> Not really user-facing, but this bugged me enough earlier to write the
> patch. ;)
>
> Some of the individual tools have nice help, too (try
> "t/helper/test-tool date", which shows the approxidate command I was
> looking for), but some of them could probably stand to improve their
> friendliness (try "t/helper/test-tool config"). I think it's fine for
> people to improve them over time if and when they get annoyed.
This will improve contributors' lives! Thanks.

Reviewed-by: Derrick Stolee <dstolee@microsoft.com>