feat: enhance CLI with short options and usage examples in various scripts

Author: takasehideki

manager_scripts/generate_exec_scripts.py

@@ -32,7 +32,17 @@
 
 if __name__ == "__main__":
     parser = argparse.ArgumentParser(
-        description="Generate Docker execution scripts and compose files from a JSON topology"
+        description="Generate Docker execution scripts and compose files from a JSON topology",
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+        usage=(
+            "%(prog)s <topology.json> [--ws-dir|-w <dir>] [--force|-f] "
+            "[--rmw|-m <rmw>] [--help|-h]"
+        ),
+        epilog="""
+Examples:
+  python3 manager_scripts/generate_exec_scripts.py topology_example/simple.json --rmw fastdds --ws-dir performance_ws
+  short: python3 manager_scripts/generate_exec_scripts.py topology_example/simple.json -m fastdds -w performance_ws
+""",
     )
     parser.add_argument("json_path", help="Path to the input JSON file")
     parser.add_argument(

performance_test/all_latency.py

@@ -352,7 +352,15 @@ def process_log_directory(log_dir_name, logs_base_path, results_base_path):
 
 if __name__ == "__main__":
     parser = argparse.ArgumentParser(
-        description="Process log directories and save latency results.")
+        description="Process log directories and save latency results.",
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+        usage="%(prog)s [--logs|-l DIR] [--results|-r DIR] [--help|-h]",
+        epilog="""
+Examples:
+  python3 performance_test/all_latency.py --logs ./logs --results ./results
+  short: python3 performance_test/all_latency.py -l ./logs -r ./results
+""",
+    )
     parser.add_argument("-l", "--logs", type=str, default="./logs",
                         help="Base path for logs")
     parser.add_argument("-r", "--results", type=str,

performance_test/performance_test.py

@@ -11,7 +11,19 @@
 
 if __name__ == "__main__":
     parser = argparse.ArgumentParser(
-        description="Run performance tests using run.sh defaults")
+        description="Run performance tests using run.sh defaults",
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+        usage=(
+            "%(prog)s [--trials|-t N] [--eval-time|-e SEC] "
+            "[--exec-policy|-p {docker,native,local}] [--ws-dir|-w DIR] "
+            "[--scenario|-s NAME] [--help|-h]"
+        ),
+        epilog="""
+Examples:
+  python3 performance_test/performance_test.py --exec-policy local --trials 5 --eval-time 60
+  short: python3 performance_test/performance_test.py -p local -t 5 -e 60
+""",
+    )
     parser.add_argument("-t", "--trials", type=int, default=3,
                         help="Number of trials (default: 3)")
     parser.add_argument("-e", "--eval-time", type=int, default=None,

remote_hosts_scripts/start_exec_scripts.py

@@ -3,6 +3,8 @@
 Supports both Docker and native execution modes.
 
 Usage:
+    python3 start_exec_scripts.py [--exec-policy|-p {docker,native}] [--trial-idx|-t N] [--prepare-run|-r] [--ws-dir|-w DIR] [--scenario|-s NAME] [--hosts-list|-l HOSTS] [--help|-h]
+
   # Docker mode (sends /start_docker requests)
       python3 start_exec_scripts.py --exec-policy docker --trial-idx 1 --ws-dir performance_ws --scenario latest --hosts-list host1,host2,host3
       short: python3 start_exec_scripts.py -p docker -t 1 -w performance_ws -s latest -l host1,host2,host3
@@ -64,15 +66,20 @@ def main():
     parser = argparse.ArgumentParser(
         description="Start test execution on all hosts (Docker or native)",
         formatter_class=argparse.RawDescriptionHelpFormatter,
+        usage=(
+            "%(prog)s [--exec-policy|-p {docker,native}] [--trial-idx|-t N] "
+            "[--prepare-run|-r] [--ws-dir|-w DIR] [--scenario|-s NAME] "
+            "[--hosts-list|-l HOSTS] [--help|-h]"
+        ),
         epilog="""
 Examples:
   # Docker mode
-                        python3 start_exec_scripts.py --exec-policy docker --trial-idx 1 --ws-dir performance_ws --scenario latest --hosts-list host1,host2,host3
-                        short: python3 start_exec_scripts.py -p docker -t 1 -w performance_ws -s latest -l host1,host2,host3
+  python3 start_exec_scripts.py --exec-policy docker --trial-idx 1 --ws-dir performance_ws --scenario latest --hosts-list host1,host2,host3
+  short: python3 start_exec_scripts.py -p docker -t 1 -w performance_ws -s latest -l host1,host2,host3
 
   # Native mode
-                        python3 start_exec_scripts.py --exec-policy native --trial-idx 1 --ws-dir performance_ws --scenario latest --hosts-list host1,host2,host3
-                        short: python3 start_exec_scripts.py -p native -t 1 -w performance_ws -s latest -l host1,host2,host3
+  python3 start_exec_scripts.py --exec-policy native --trial-idx 1 --ws-dir performance_ws --scenario latest --hosts-list host1,host2,host3
+  short: python3 start_exec_scripts.py -p native -t 1 -w performance_ws -s latest -l host1,host2,host3
         """
     )
     parser.add_argument(