artefacts-cli 0.8.0__py3-none-any.whl → 0.9.2__py3-none-any.whl

artefacts/cli/locales/click.pot

@@ -0,0 +1,496 @@
+# Translations template for artefacts.
+# Copyright (C) 2025 Asteria ART
+# This file is distributed under the same license as the artefacts project.
+# FIRST AUTHOR <EMAIL@ADDRESS>, 2025.
+#
+#, fuzzy
+msgid ""
+msgstr ""
+"Project-Id-Version: artefacts 0.9.2.dev8\n"
+"Report-Msgid-Bugs-To: dev@artefacts.com\n"
+"POT-Creation-Date: 2025-05-12 11:10+0900\n"
+"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
+"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
+"Language-Team: LANGUAGE <LL@li.org>\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=utf-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Generated-By: Babel 2.17.0\n"
+
+#: venv/lib/python3.10/site-packages/click/_termui_impl.py:179
+msgid "d"
+msgstr ""
+
+#: venv/lib/python3.10/site-packages/click/_termui_impl.py:606
+#, python-brace-format
+msgid "{editor}: Editing failed"
+msgstr ""
+
+#: venv/lib/python3.10/site-packages/click/_termui_impl.py:610
+#, python-brace-format
+msgid "{editor}: Editing failed: {e}"
+msgstr ""
+
+#: venv/lib/python3.10/site-packages/click/_winconsole.py:155
+#, python-brace-format
+msgid "Windows error: {error}"
+msgstr ""
+
+#: venv/lib/python3.10/site-packages/click/_winconsole.py:172
+#, python-brace-format
+msgid "Windows error {errno}"
+msgstr ""
+
+#: venv/lib/python3.10/site-packages/click/core.py:88
+#, python-brace-format
+msgid ""
+"It is not possible to add the group {cmd_name!r} to another group "
+"{base_cmd_name!r} that is in chain mode."
+msgstr ""
+
+#: venv/lib/python3.10/site-packages/click/core.py:93
+#, python-brace-format
+msgid ""
+"Found the group {cmd_name!r} as subcommand to another group  "
+"{base_cmd_name!r} that is in chain mode. This is not supported."
+msgstr ""
+
+#: venv/lib/python3.10/site-packages/click/core.py:998
+#, python-brace-format
+msgid ""
+"The parameter {param} is used more than once. Remove its duplicate as "
+"parameters should be unique."
+msgstr ""
+
+#: venv/lib/python3.10/site-packages/click/core.py:1090
+#: venv/lib/python3.10/site-packages/click/core.py:1127
+#: venv/lib/python3.10/site-packages/click/core.py:2593
+#, python-brace-format
+msgid "(DEPRECATED: {target})"
+msgstr ""
+
+#: venv/lib/python3.10/site-packages/click/core.py:1092
+#: venv/lib/python3.10/site-packages/click/core.py:1129
+#: venv/lib/python3.10/site-packages/click/core.py:2595
+msgid "(DEPRECATED)"
+msgstr ""
+
+#: venv/lib/python3.10/site-packages/click/core.py:1094
+#: venv/lib/python3.10/site-packages/click/core.py:1131
+#, python-brace-format
+msgid "{text} {deprecated_message}"
+msgstr ""
+
+#: venv/lib/python3.10/site-packages/click/core.py:1150
+msgid "Options"
+msgstr ""
+
+#: venv/lib/python3.10/site-packages/click/core.py:1212
+#, python-brace-format
+msgid "Got unexpected extra argument ({args})"
+msgid_plural "Got unexpected extra arguments ({args})"
+msgstr[0] ""
+msgstr[1] ""
+
+#: venv/lib/python3.10/site-packages/click/core.py:1231
+#, python-brace-format
+msgid "DeprecationWarning: The command {name!r} is deprecated.{extra_message}"
+msgstr ""
+
+#: venv/lib/python3.10/site-packages/click/core.py:1415
+msgid "Aborted!"
+msgstr ""
+
+#: venv/lib/python3.10/site-packages/click/core.py:1789
+msgid "Commands"
+msgstr ""
+
+#: venv/lib/python3.10/site-packages/click/core.py:1820
+msgid "Missing command."
+msgstr ""
+
+#: venv/lib/python3.10/site-packages/click/core.py:1898
+#, python-brace-format
+msgid "No such command {name!r}."
+msgstr ""
+
+#: venv/lib/python3.10/site-packages/click/core.py:2137
+#, python-brace-format
+msgid "'nargs' must be {arity} (or None) for type {type!r}, but it was {nargs}."
+msgstr ""
+
+#: venv/lib/python3.10/site-packages/click/core.py:2173
+#, python-brace-format
+msgid "'default' {subject} must match nargs={nargs}."
+msgstr ""
+
+#: venv/lib/python3.10/site-packages/click/core.py:2181
+#, python-brace-format
+msgid ""
+"The {type_name} '{readable_name}' is deprecated and still required. A "
+"deprecated {type_name} cannot be required."
+msgstr ""
+
+#: venv/lib/python3.10/site-packages/click/core.py:2322
+msgid "Value must be an iterable."
+msgstr ""
+
+#: venv/lib/python3.10/site-packages/click/core.py:2343
+#, python-brace-format
+msgid "Takes {nargs} values but 1 was given."
+msgid_plural "Takes {nargs} values but {len} were given."
+msgstr[0] ""
+msgstr[1] ""
+
+#: venv/lib/python3.10/site-packages/click/core.py:2423
+#, python-brace-format
+msgid ""
+"DeprecationWarning: The {param_type} {name!r} is "
+"deprecated.{extra_message}"
+msgstr ""
+
+#: venv/lib/python3.10/site-packages/click/core.py:2698
+#, python-brace-format
+msgid " (env var: '{var}')"
+msgstr ""
+
+#: venv/lib/python3.10/site-packages/click/core.py:2712
+#, python-brace-format
+msgid "Name '{name}' defined twice"
+msgstr ""
+
+#: venv/lib/python3.10/site-packages/click/core.py:2728
+#, python-brace-format
+msgid "Boolean option {decl!r} cannot use the same flag for true/false."
+msgstr ""
+
+#: venv/lib/python3.10/site-packages/click/core.py:2747
+#, python-brace-format
+msgid "Could not determine name for option with declarations {decls!r}"
+msgstr ""
+
+#: venv/lib/python3.10/site-packages/click/core.py:2754
+#, python-brace-format
+msgid ""
+"No options defined but a name was passed ({name}). Did you mean to "
+"declare an argument instead? Did you mean to pass '--{name}'?"
+msgstr ""
+
+#: venv/lib/python3.10/site-packages/click/core.py:2831
+#, python-brace-format
+msgid "env var: {var}"
+msgstr ""
+
+#: venv/lib/python3.10/site-packages/click/core.py:2834
+#, python-brace-format
+msgid "default: {default}"
+msgstr ""
+
+#: venv/lib/python3.10/site-packages/click/core.py:2838
+msgid "required"
+msgstr ""
+
+#: venv/lib/python3.10/site-packages/click/core.py:2894
+msgid "(dynamic)"
+msgstr ""
+
+#: venv/lib/python3.10/site-packages/click/core.py:3124
+#, python-brace-format
+msgid "Arguments take exactly one parameter declaration, got {length}: {decls}."
+msgstr ""
+
+#: venv/lib/python3.10/site-packages/click/decorators.py:97
+#, python-brace-format
+msgid ""
+"Managed to invoke callback without a context object of type {type!r} "
+"existing."
+msgstr ""
+
+#: venv/lib/python3.10/site-packages/click/decorators.py:134
+#, python-brace-format
+msgid "the {key!r} key from :attr:`click.Context.meta`"
+msgstr ""
+
+#: venv/lib/python3.10/site-packages/click/decorators.py:139
+#, python-brace-format
+msgid ""
+"Decorator that passes {description} as the first argument to the "
+"decorated function."
+msgstr ""
+
+#: venv/lib/python3.10/site-packages/click/decorators.py:477
+#, python-format
+msgid "%(prog)s, version %(version)s"
+msgstr ""
+
+#: venv/lib/python3.10/site-packages/click/decorators.py:514
+#, python-brace-format
+msgid "{name!r} is not installed. Try passing 'package_name' instead."
+msgstr ""
+
+#: venv/lib/python3.10/site-packages/click/decorators.py:521
+#, python-brace-format
+msgid "Could not determine the version for {name!r} automatically."
+msgstr ""
+
+#: venv/lib/python3.10/site-packages/click/decorators.py:538
+msgid "Show the version and exit."
+msgstr ""
+
+#: venv/lib/python3.10/site-packages/click/decorators.py:564
+msgid "Show this message and exit."
+msgstr ""
+
+#: venv/lib/python3.10/site-packages/click/exceptions.py:50
+#: venv/lib/python3.10/site-packages/click/exceptions.py:89
+#, python-brace-format
+msgid "Error: {message}"
+msgstr ""
+
+#: venv/lib/python3.10/site-packages/click/exceptions.py:81
+#, python-brace-format
+msgid "Try '{command} {option}' for help."
+msgstr ""
+
+#: venv/lib/python3.10/site-packages/click/exceptions.py:130
+#, python-brace-format
+msgid "Invalid value: {message}"
+msgstr ""
+
+#: venv/lib/python3.10/site-packages/click/exceptions.py:132
+#, python-brace-format
+msgid "Invalid value for {param_hint}: {message}"
+msgstr ""
+
+#: venv/lib/python3.10/site-packages/click/exceptions.py:190
+msgid "Missing argument"
+msgstr ""
+
+#: venv/lib/python3.10/site-packages/click/exceptions.py:192
+msgid "Missing option"
+msgstr ""
+
+#: venv/lib/python3.10/site-packages/click/exceptions.py:194
+msgid "Missing parameter"
+msgstr ""
+
+#: venv/lib/python3.10/site-packages/click/exceptions.py:196
+#, python-brace-format
+msgid "Missing {param_type}"
+msgstr ""
+
+#: venv/lib/python3.10/site-packages/click/exceptions.py:203
+#, python-brace-format
+msgid "Missing parameter: {param_name}"
+msgstr ""
+
+#: venv/lib/python3.10/site-packages/click/exceptions.py:223
+#, python-brace-format
+msgid "No such option: {name}"
+msgstr ""
+
+#: venv/lib/python3.10/site-packages/click/exceptions.py:235
+#, python-brace-format
+msgid "Did you mean {possibility}?"
+msgid_plural "(Possible options: {possibilities})"
+msgstr[0] ""
+msgstr[1] ""
+
+#: venv/lib/python3.10/site-packages/click/exceptions.py:282
+msgid "unknown error"
+msgstr ""
+
+#: venv/lib/python3.10/site-packages/click/exceptions.py:289
+#, python-brace-format
+msgid "Could not open file {filename!r}: {message}"
+msgstr ""
+
+#: venv/lib/python3.10/site-packages/click/formatting.py:156
+msgid "Usage:"
+msgstr ""
+
+#: venv/lib/python3.10/site-packages/click/parser.py:154
+#, python-brace-format
+msgid "Invalid start character for option ({option})"
+msgstr ""
+
+#: venv/lib/python3.10/site-packages/click/parser.py:190
+#, python-brace-format
+msgid "unknown action '{action}'"
+msgstr ""
+
+#: venv/lib/python3.10/site-packages/click/parser.py:212
+#, python-brace-format
+msgid "Argument {name!r} takes {nargs} values."
+msgstr ""
+
+#: venv/lib/python3.10/site-packages/click/parser.py:395
+#, python-brace-format
+msgid "Option {name!r} does not take a value."
+msgstr ""
+
+#: venv/lib/python3.10/site-packages/click/parser.py:456
+#, python-brace-format
+msgid "Option {name!r} requires an argument."
+msgid_plural "Option {name!r} requires {nargs} arguments."
+msgstr[0] ""
+msgstr[1] ""
+
+#: venv/lib/python3.10/site-packages/click/parser.py:527
+#, python-brace-format
+msgid ""
+"'parser.{name}' is deprecated and will be removed in Click 9.0. The old "
+"parser is available in 'optparse'."
+msgstr ""
+
+#: venv/lib/python3.10/site-packages/click/parser.py:540
+msgid ""
+"Importing 'parser.split_arg_string' is deprecated, it will only be "
+"available in 'shell_completion' in Click 9.0."
+msgstr ""
+
+#: venv/lib/python3.10/site-packages/click/shell_completion.py:326
+msgid "Shell completion is not supported for Bash versions older than 4.4."
+msgstr ""
+
+#: venv/lib/python3.10/site-packages/click/shell_completion.py:333
+msgid "Couldn't detect Bash version, shell completion is not supported."
+msgstr ""
+
+#: venv/lib/python3.10/site-packages/click/termui.py:162
+msgid "Repeat for confirmation"
+msgstr ""
+
+#: venv/lib/python3.10/site-packages/click/termui.py:178
+msgid "Error: The value you entered was invalid."
+msgstr ""
+
+#: venv/lib/python3.10/site-packages/click/termui.py:180
+#, python-brace-format
+msgid "Error: {e.message}"
+msgstr ""
+
+#: venv/lib/python3.10/site-packages/click/termui.py:191
+msgid "Error: The two entered values do not match."
+msgstr ""
+
+#: venv/lib/python3.10/site-packages/click/termui.py:247
+msgid "Error: invalid input"
+msgstr ""
+
+#: venv/lib/python3.10/site-packages/click/termui.py:611
+#: venv/lib/python3.10/site-packages/click/termui.py:617
+#, python-brace-format
+msgid "Unknown color {colour!r}"
+msgstr ""
+
+#: venv/lib/python3.10/site-packages/click/termui.py:866
+msgid "Press any key to continue..."
+msgstr ""
+
+#: venv/lib/python3.10/site-packages/click/types.py:340
+#, python-brace-format
+msgid ""
+"Choose from:\n"
+"\t{choices}"
+msgstr ""
+
+#: venv/lib/python3.10/site-packages/click/types.py:377
+#, python-brace-format
+msgid "{value!r} is not {choice}."
+msgid_plural "{value!r} is not one of {choices}."
+msgstr[0] ""
+msgstr[1] ""
+
+#: venv/lib/python3.10/site-packages/click/types.py:383
+#, python-brace-format
+msgid "Choice({choices})"
+msgstr ""
+
+#: venv/lib/python3.10/site-packages/click/types.py:468
+#, python-brace-format
+msgid "{value!r} does not match the format {format}."
+msgid_plural "{value!r} does not match the formats {formats}."
+msgstr[0] ""
+msgstr[1] ""
+
+#: venv/lib/python3.10/site-packages/click/types.py:490
+#, python-brace-format
+msgid "{value!r} is not a valid {number_type}."
+msgstr ""
+
+#: venv/lib/python3.10/site-packages/click/types.py:546
+#, python-brace-format
+msgid "{value} is not in the range {range}."
+msgstr ""
+
+#: venv/lib/python3.10/site-packages/click/types.py:687
+#, python-brace-format
+msgid "{value!r} is not a valid boolean."
+msgstr ""
+
+#: venv/lib/python3.10/site-packages/click/types.py:711
+#, python-brace-format
+msgid "{value!r} is not a valid UUID."
+msgstr ""
+
+#: venv/lib/python3.10/site-packages/click/types.py:905
+msgid "file"
+msgstr ""
+
+#: venv/lib/python3.10/site-packages/click/types.py:907
+msgid "directory"
+msgstr ""
+
+#: venv/lib/python3.10/site-packages/click/types.py:909
+msgid "path"
+msgstr ""
+
+#: venv/lib/python3.10/site-packages/click/types.py:956
+#, python-brace-format
+msgid "{name} {filename!r} does not exist."
+msgstr ""
+
+#: venv/lib/python3.10/site-packages/click/types.py:965
+#, python-brace-format
+msgid "{name} {filename!r} is a file."
+msgstr ""
+
+#: venv/lib/python3.10/site-packages/click/types.py:973
+#, python-brace-format
+msgid "{name} {filename!r} is a directory."
+msgstr ""
+
+#: venv/lib/python3.10/site-packages/click/types.py:982
+#, python-brace-format
+msgid "{name} {filename!r} is not readable."
+msgstr ""
+
+#: venv/lib/python3.10/site-packages/click/types.py:991
+#, python-brace-format
+msgid "{name} {filename!r} is not writable."
+msgstr ""
+
+#: venv/lib/python3.10/site-packages/click/types.py:1000
+#, python-brace-format
+msgid "{name} {filename!r} is not executable."
+msgstr ""
+
+#: venv/lib/python3.10/site-packages/click/types.py:1067
+#, python-brace-format
+msgid "{len_type} values are required, but {len_value} was given."
+msgid_plural "{len_type} values are required, but {len_value} were given."
+msgstr[0] ""
+msgstr[1] ""
+
+#: venv/lib/python3.10/site-packages/click/types.py:1130
+#, python-brace-format
+msgid "Attempted to use an uninstantiated parameter type ({type})."
+msgstr ""
+
+#: venv/lib/python3.10/site-packages/click/utils.py:342
+#: venv/lib/python3.10/site-packages/click/utils.py:363
+#, python-brace-format
+msgid "Unknown standard stream '{name}'"
+msgstr ""
+

artefacts/cli/other.py

@@ -23,6 +23,7 @@ def run_other_tests(run):
     if "params" in scenario:
         generate_parameter_output(scenario["params"])
     full_env = {**os.environ, **scenario.get("params", {})}
+    full_env["ARTEFACTS_SCENARIO_PARAMS_FILE"] = TMP_SCENARIO_PARAMS_YAML
 
     command = scenario["run"]
     run_and_save_logs(

artefacts/cli/ros1.py

@@ -4,6 +4,7 @@ from glob import glob
 import os
 import logging
 
+from .i18n import localise
 from .utils import run_and_save_logs
 from .utils_ros import parse_tests_results
 from .parameters import TMP_RUNTIME_PARAMS_YAML, TMP_SCENARIO_PARAMS_YAML
@@ -50,7 +51,9 @@ def generate_rosbag_args(scenario: dict) -> str:
             return topics
         else:
             logging.warning(
-                "[warning in generate_rosbag_args] rosbag_record asks for 'subscriptions' but they are not specified. Falling back to default: no rosbag will be recorded"
+                localise(
+                    "[warning in generate_rosbag_args] rosbag_record asks for 'subscriptions' but they are not specified. Falling back to default: no rosbag will be recorded"
+                )
             )
             return "none"
     else:
@@ -101,10 +104,20 @@ def get_result_path(scenario, PKGDIR, PACKAGE):
         )
         return test_result_file_path
     except Exception as e:
-        logging.error(f"[Exception in get_result_path()] {e}")
         logging.error(
-            f"Unable to parse the ros1 .launch specified ({scenario['ros_testfile']}) and the <test> tag within to find the unittest test method's name.",
-            "Please ensure all ROS and unittest naming conventions are respected. Exiting..",
+            localise("[Exception in get_result_path()] {message}".format(message=e))
+        )
+        logging.error(
+            localise(
+                "Unable to parse the ros1 .launch specified ({testfile}) and the <test> tag within to find the unittest test method's name.".format(
+                    testfile=scenario["ros_testfile"]
+                )
+            )
+        )
+        logging.error(
+            localise(
+                "Please ensure all ROS and unittest naming conventions are respected. Exiting.."
+            )
         )
         return None
 
@@ -210,12 +223,14 @@ def run_ros1_tests(run):
     new_rosbags = set(rosbags).difference(set(preexisting_rosbags))
     if len(new_rosbags) > 0:
         new_rosbag = new_rosbags.pop()
-        logging.info(f"new rosbag found: {new_rosbag}")
+        logging.info(
+            localise("New rosbag found: {file_name}".format(file_name=new_rosbag))
+        )
         # upload rosbag to dashboard
         run.log_single_artifact(new_rosbag, "rosbag")
         # perform any post processing, using the rosbag
         if "rosbag_postprocess" in scenario.keys():
-            logging.info("starting rosbag postprocess")
+            logging.info(localise("starting rosbag postprocess"))
             post_process_folder = os.path.expanduser(f"{PKGDIR}/{PACKAGE}_postprocess")
             os.makedirs(post_process_folder, exist_ok=True)
             existing_files = glob(f"{post_process_folder}/*")

artefacts/cli/ros2.py

@@ -1,7 +1,10 @@
-import yaml
 from glob import glob
 import os
 import shutil
+
+import yaml
+
+from .i18n import localise
 from .utils import run_and_save_logs
 from .utils_ros import parse_tests_results, get_TestSuite_error_result
 from .parameters import TMP_SCENARIO_PARAMS_YAML
@@ -65,7 +68,11 @@ def generate_scenario_parameter_output(params: dict, param_file: str):
         try:
             node, pname = k.split("/")
         except Exception:
-            print("ensure params are in the format `{node_name}/{param_name}`")
+            print(
+                localise(
+                    "Problem with parameter name. Please ensure params are in the format `node/param`"
+                )
+            )
             return
         if node not in content:
             content[node] = {"ros__parameters": {}}
@@ -128,7 +135,7 @@ def run_ros2_tests(run):
             },
             output_path=os.path.join(run.output_path, "test_process_log.txt"),
         )
-    except Launch_test_CmdNotFoundError as e:
+    except Launch_test_CmdNotFoundError:
         # raise Exception(
         #    f"Running {scenario['ros_testfile']} failed. Please check that the launch file exists."
         # )

artefacts/cli/utils.py

@@ -8,7 +8,7 @@ import click
 
 import artefacts_copava as copava
 from artefacts import ARTEFACTS_DEFAULT_OUTPUT_DIR
-from artefacts.cli import WarpRun
+from artefacts.cli import WarpRun, localise
 
 
 def run_and_save_logs(
@@ -74,13 +74,17 @@ def ensure_available(package: str) -> None:
 def read_config(filename: str) -> dict:
     try:
         with open(filename) as f:
-            return copava.parse(f.read())
+            return copava.parse(f.read()) or {}
     except FileNotFoundError:
-        raise click.ClickException(f"Project config file {filename} not found.")
+        raise click.ClickException(
+            localise(
+                "Project config file {file_name} not found.".format(file_name=filename)
+            )
+        )
 
 
 # Click callback syntax
-def config_validation(context: dict, param: str, value: str) -> str:
+def config_validation(context: click.Context, param: str, value: str) -> str:
     if context.params.get("skip_validation", False):
         return value
     config = read_config(value)