Merge pull request #382 from rouault/usage_subparser

subparser: use full parser path instead of just parser name in usage() message

.github/workflows/tidy-analysis-stage-01.yml

@@ -36,7 +36,7 @@ jobs:
         echo ${{ github.event.pull_request.head.repo.full_name }} > clang-tidy-result/pr-head-repo.txt
         echo ${{ github.event.pull_request.head.ref }} > clang-tidy-result/pr-head-ref.txt
 
-    - uses: actions/upload-artifact@v2
+    - uses: actions/upload-artifact@v4
       with:
         name: clang-tidy-result
         path: clang-tidy-result/

include/argparse/argparse.hpp

@@ -2067,7 +2067,7 @@ class ArgumentParser {
     std::stringstream stream;
 
     std::string curline("Usage: ");
-    curline += this->m_program_name;
+    curline += this->m_parser_path;
     const bool multiline_usage =
         this->m_usage_max_line_width < (std::numeric_limits<std::size_t>::max)();
     const size_t indent_size = curline.size();

test/test_subparsers.cpp

@@ -280,3 +280,29 @@ TEST_CASE("Check set_suppress" * test_suite("subparsers")) {
     REQUIRE(contains(program.help().str(), "command_2") == true);
   }
 }
+
+
+TEST_CASE("Help of subparsers" * test_suite("subparsers")) {
+  argparse::ArgumentParser program("test");
+
+  argparse::ArgumentParser command_1("add", "1.0", argparse::default_arguments::version);
+
+  std::stringstream buffer;
+  command_1.add_argument("--help")
+      .action([&](const auto &) { buffer << command_1; })
+      .default_value(false)
+      .implicit_value(true)
+      .nargs(0);
+
+  program.add_subparser(command_1);
+
+  REQUIRE(command_1.usage() == "Usage: test add [--version] [--help]");
+
+  REQUIRE(buffer.str().empty());
+  program.parse_args({"test", "add", "--help"});
+  REQUIRE(buffer.str() == "Usage: test add [--version] [--help]\n"
+                          "\n"
+                          "Optional arguments:\n"
+                          "  -v, --version  prints version information and exits \n"
+                          "  --help         \n");
+}